本頁說明 Cloud Location Finder 使用的查詢和篩選器語法，可根據地域、鄰近程度和無碳能源 (CFE%) 使用量傳回雲端位置。詳情請參閱 REST API 參考資料。
| 欄位 | 支援的運算子 | 說明 | 範例 |
|---|---|---|---|
| carbon_free_energy_percentage | >、< | 符合 Google 定義的無碳能源百分比。 CFE% 僅支援 Google Cloud 位置。 |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =、!= | 使用列舉項目比對 Cloud 位置類型。 | cloud_location_type = CLOUD_LOCATION_TYPE_REGION |
| cloud_provider | =、!= | 使用列舉與雲端服務供應商相符。 | 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 | =、!= | 依全名比對 CloudLocation 的 display_name。 | display_name = "us-east-1" |
| 延遲時間 | >、< | 根據 RTT 測量結果 (以毫秒為單位)，使用整數來比對延遲時間條件。 | latency < 50 |
| territory_code | =、!= | 比對雙字母 ISO 3166-1 alpha-2 代碼。雙字母代碼必須全為大寫。 | territory_code = \"US\" |
篩選器範例
這個篩選器範例說明在 Cloud Location Finder HTTP 或 Google Cloud CLI 查詢中加入篩選器時，應使用的格式。
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"