このページでは、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"