このページでは、 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" |
| latency | >, < | RTT 測定に基づく整数を使用して、レイテンシ条件と一致します（単位はミリ秒）。 | latency < 50 |
| territory_code | =, != | 2 文字の ISO 3166-1 alpha-2 コードと一致します。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"