בדף הזה מתוארת התחביר של השאילתות והמסננים שבהם משתמש הכלי Cloud Location Finder כדי להחזיר מיקומי ענן על סמך טריטוריה, קרבה ושימוש באנרגיה נטולת פליטות פחמן (CFE%). מידע נוסף מופיע במאמר הפניית API בארכיטקטורת REST.
| שדה | אופרטורים נתמכים | תיאור | דוגמה |
|---|---|---|---|
| carbon_free_energy_percentage | >, < | תואם לאחוז האנרגיה נטולת הפחמן כפי שמוגדר על ידי Google. המדד CFE% נתמך רק במיקומים Google Cloud . |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =, != | התאמה לסוג מיקום ב-Cloud באמצעות enum. | cloud_location_type = CLOUD_LOCATION_TYPE_REGION |
| cloud_provider | =, != | התאמה לספק שירותי ענן באמצעות enum. | cloud_provider = CLOUD_PROVIDER_GCP |
| containing_cloud_location | =, != | התאמות שמכילות CloudLocation לפי שם משאב מלא. | containing_cloud_location = "projects/clf-e2e-testing/locations/global/cloudLocations/aws-us-east-1" |
| display_name | =, != | הפונקציה מחפשת התאמה לשם המלא של display_name של CloudLocation. | display_name = "us-east-1" |
| זמן אחזור | >, < | הערך תואם לקריטריונים של זמן האחזור באמצעות מספר שלם שמבוסס על מדידות של זמן הלוך ושוב (RTT) ביחידה של אלפיות השנייה (ms). | latency < 50 |
| territory_code | =, != | תואם לקוד בן שתי אותיות לפי תקן ISO 3166-1 alpha-2. הקוד בן שתי האותיות חייב להיות באותיות גדולות. | territory_code = \"US\" |
מסנן לדוגמה
בדוגמה הזו של מסנן אפשר לראות את הפורמט שבו צריך להשתמש כשכוללים מסנן בשאילתות HTTP או בשאילתות של Google Cloud CLI ב-Cloud Location Finder.
HTTP
filter=cloud_provider=CLOUD_PROVIDER_GCP%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_ZONE
gcloud
--filter="cloud_provider=CLOUD_PROVIDER_GCP AND cloud_location_type=CLOUD_LOCATION_TYPE_ZONE"