Mengurutkan dan memfilter hasil daftar

Beta

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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

• keyRings.list
• cryptoKeys.list
• cryptoKeyVersions.list
• importJobs.list

Dukungan untuk pengurutan dan pemfilteran dalam operasi list ditunjukkan oleh adanya kolom string filter dan orderBy dalam isi permintaan daftar. Kedua kolom menggunakan bahasa 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 besar dari.
<	Kurang dari.
=>	Lebih dari atau sama dengan.
<=	Kurang dari atau sama dengan.
!= - NOT	Ketidaksetaraan. Berikut adalah setara: name != "quickstart" -name="quickstart" NOT name = "quickstart"
:	Pembatasan. Ini adalah pencocokan substring yang tidak peka huruf besar/kecil. Misalnya, 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 di tingkat pengelompokan yang sama. OR lebih diprioritaskan daripada AND. Anda dapat menggunakan tanda kurung untuk mengganti prioritas default.

Saat memfilter nilai time, encode 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 di subkolom 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 diapit tanda kutip ditafsirkan sebagai satu nilai, bukan 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 pengurutan

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

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

Catatan: Untuk menemukan versi kunci utama, jangan mencoba mengurutkan versi dengan tanggal pembuatan terbaru. Tidak ada jaminan bahwa versi primer adalah versi terbaru atau bahwa versi terbaru adalah versi primer. Sebagai gantinya, buat kueri menggunakan kolom primary.