Mengurutkan dan memfilter hasil daftar

Cloud Key Management Service mendukung pemfilteran dan pengurutan hasil dari operasi list berikut.

Dukungan untuk pengurutan dan pemfilteran dalam operasi list ditunjukkan dengan adanya kolom string filter dan orderBy dalam isi permintaan daftar. Kedua kolom menggunakan bahasa yang sederhana untuk merujuk ke kolom dalam objek yang diurutkan dan/atau difilter.

Filter sintaksis

Sintaksis filter terdiri dari ekspresi pada satu atau beberapa kolom objek yang difilter.

Anda dapat menggunakan operator ekspresi berikut.

Operator Deskripsi
= Kesetaraan.
> Lebih dari.
< Kurang dari.
=> Lebih dari atau sama dengan.
<= Kurang dari atau sama dengan.
!=
-
NOT
Ketidaksetaraan.
Berikut ini setara:
name != "quickstart"
-name="quickstart"
NOT name = "quickstart"
: {i>Containment<i} (Pembatasan). Ini adalah pencocokan substring yang tidak peka huruf besar/kecil.
Sebagai contoh, name: "cloud" memfilter resource yang berisi cloud (tidak peka huruf besar/kecil) dalam nama resource.
AND Logika AND. Spasi setara dengan AND, sehingga hal berikut setara:
name: "cloud" AND name: "kms"
name: "cloud" name: "kms"
OR Logika OR.

Operator AND dan OR diterima pada tingkat pengelompokan yang sama. OR lebih diutamakan daripada AND. Anda dapat menggunakan tanda kurung untuk mengganti prioritas default.

Saat memfilter nilai time, enkode waktu sebagai string dalam format RFC 3399, seperti 2019-06-20T01:30:15Z.

Saat mengakses subkolom, gunakan sintaksis titik. Misalnya, resource CryptoKey berisi kolom primary. Anda dapat memfilter hasil CryptoKey pada subkolom primary.algorithm untuk algoritme tertentu:

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

Gunakan sintaksis titik untuk label, dan jenis map lainnya:

labels.team=alpha

String yang dikutip ditafsirkan sebagai nilai tunggal, bukan urutan nilai.

Kolom yang dapat difilter

Anda dapat memfilter kolom apa pun pada objek yang ditampilkan.

Metode daftar Link ke kolom yang dapat difilter
keyRings.list Kolom KeyRing
cryptoKeys.list Kolom CryptoKey
cryptoKeyVersions.list Kolom CryptoKeyVersion
importJobs.list Kolom ImportJob

Sintaksis urutan penyortiran

Anda dapat mengurutkan hasil berdasarkan kolom name resource pada objek. Berikut ini adalah nilai urutan penyortiran yang didukung untuk kolom orderBy.

Nilai Deskripsi
'' (string kosong) Hasil diurutkan dalam urutan default.
'name' Hasil diurutkan dalam urutan menaik berdasarkan kolom name resource.
'name desc' Hasil diurutkan dalam urutan menurun berdasarkan kolom name resource.