Cloud Key Management Service mendukung pemfilteran dan pengurutan hasil dari operasi list berikut.
Dukungan untuk pengurutan dan pemfilteran dalam operasi list ditunjukkan oleh
keberadaan kolom string filter dan orderBy dalam isi permintaan daftar. Kedua kolom menggunakan bahasa sederhana untuk merujuk ke kolom dalam objek yang sedang 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 besar dari. |
< |
Kurang dari. |
=> |
Lebih besar dari atau sama dengan. |
<= |
Kurang dari atau sama dengan. |
!=-NOT |
Ketidaksetaraan. Berikut ini setara: name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
Penanganan. Ini adalah kecocokan 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 berikut ini setara:name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
OR logis. |
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 sub-bidang, gunakan sintaksis titik. Misalnya, resource CryptoKey
berisi kolom primary. Anda dapat memfilter hasil CryptoKey pada
sub-bidang primary.algorithm untuk algoritma 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 satu nilai, bukan sebagai urutan nilai.
Kolom yang dapat difilter
Anda dapat memfilter kolom apa pun dalam objek yang ditampilkan.
| Metode daftar | Menautkan 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 menunjukkan
nilai urutan pengurutan 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. |