Cloud Key Management Service תומך בסינון ובמיון של תוצאות מהפעולות הבאות של list.
התמיכה במיון ובסינון בפעולה list מסומנת בנוכחות של שדות המחרוזת filter ו-orderBy בגוף הבקשה של הרשימה. בשני השדות האלה נעשה שימוש בשפה פשוטה כדי להתייחס לשדות באובייקט שממוין או מסונן.
תחביר של מסננים
תחביר המסנן מורכב מביטוי בשדה אחד או יותר של האובייקטים שמסננים.
אפשר להשתמש באופרטורים הבאים של ביטויים.
| אופרטור | תיאור |
|---|---|
= |
שוויון. |
> |
גדול מ-. |
< |
פחות מ. |
=> |
גדול מ- או שווה ל- |
<= |
קטן מ- או שווה ל-. |
!=-NOT |
אי שוויון. הביטויים הבאים שקולים: name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
בלימה. זוהי התאמה של מחרוזת משנה ללא תלות באותיות רישיות. לדוגמה, name: "cloud" מסנן משאבים שמכילים את cloud (ללא תלות באותיות רישיות) בשם המשאב. |
AND |
'וגם' לוגי. רווח שווה ל-AND, ולכן הדוגמאות הבאות שוות:name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
OR לוגי. |
אפשר להשתמש באופרטורים AND ו-OR באותה רמת קיבוץ. OR מקבל עדיפות על פני AND. אפשר להשתמש בסוגריים כדי לשנות את סדר העדיפויות שמוגדר כברירת מחדל.
כשמסננים לפי ערכים של time, צריך לקודד את השעה כמחרוזת בפורמט RFC 3399, כמו 2019-06-20T01:30:15Z.
כשניגשים לשדה משנה, משתמשים בתחביר נקודה. לדוגמה, המשאב CryptoKey מכיל את השדה primary. אפשר לסנן את התוצאות של CryptoKey בשדה המשנה primary.algorithm לפי אלגוריתם ספציפי:
primary.algorithm=RSA_SIGN_PSS_2048_SHA256
משתמשים בתחביר הנקודה בשביל תווית ובשביל כל סוג אחר של map:
labels.team=alpha
מחרוזת שתחומה במירכאות מתפרשת כערך יחיד ולא כרצף של ערכים.
שדות שניתן לסנן
אפשר לסנן לפי כל שדה באובייקטים שמוחזרים.
| שיטת הרשימה | קישור לשדות שאפשר לסנן |
|---|---|
| keyRings.list | שדות KeyRing |
| cryptoKeys.list | שדות של CryptoKey |
| cryptoKeyVersions.list | שדות של CryptoKeyVersion |
| importJobs.list | שדות של ImportJob |
תחביר של סדר מיון
אפשר למיין את התוצאות לפי השדה name של המשאב באובייקטים. בהמשך מוצגים הערכים הנתמכים של סדר המיון בשדה orderBy.
| ערך | תיאור |
|---|---|
'' (מחרוזת ריקה) |
התוצאות ממוינות לפי סדר ברירת המחדל. |
'name' |
התוצאות ממוינות בסדר עולה לפי השדה name של המשאב. |
'name desc' |
התוצאות ממוינות בסדר יורד לפי השדה name של המשאב. |