Nesta página, descrevemos a sintaxe de consulta e filtro que o Localizador de locais do Cloud usa para retornar locais do Cloud com base no território, na proximidade e no uso de energia livre de carbono (CFE%). Para mais informações, consulte a referência da API REST.
| Campo | Operadores compatíveis | Descrição | Exemplo |
|---|---|---|---|
| carbon_free_energy_percentage | >, < | Corresponde à porcentagem de energia livre de carbono definida pelo Google.O CFE% é compatível apenas com locais Google Cloud . |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =, != | Corresponde a um tipo de local do Cloud usando uma enumeração. | cloud_location_type = CLOUD_LOCATION_TYPE_REGION |
| cloud_provider | =, != | Corresponde a um provedor de nuvem usando uma enumeração. | cloud_provider = CLOUD_PROVIDER_GCP |
| containing_cloud_location | =, != | Correspondências que contêm CloudLocation pelo nome completo do recurso. | containing_cloud_location = "projects/clf-e2e-testing/locations/global/cloudLocations/aws-us-east-1" |
| display_name | =, != | Faz a correspondência do display_name de um CloudLocation pelo nome completo. | display_name = "us-east-1" |
| latência | >, < | Corresponde aos critérios de latência usando um número inteiro com base em medições de RTT com uma unidade de ms. | latency < 50 |
| territory_code | =, != | Corresponde a um código ISO 3166-1 alfa-2 de duas letras. O código de duas letras precisa estar totalmente em maiúsculas. | territory_code = \"US\" |
Exemplo de filtro
Este exemplo ilustra o formato a ser usado ao incluir um filtro em consultas HTTP do Localizador de locais do Cloud ou da 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"