Esta página descreve a sintaxe de consulta e filtro que o Cloud Location Finder usa para retornar locais de nuvem com base no território, na proximidade e no uso de energia livre de carbono (CFE, na sigla em inglês). 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 conforme definida pelo Google. CFE% aceito apenas para Google Cloud locais. |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =, != | Corresponde a um tipo de local do Cloud usando um enum. | cloud_location_type = CLOUD_LOCATION_TYPE_REGION |
| cloud_provider | =, != | Corresponde a um provedor de nuvem usando um enum. | cloud_provider = CLOUD_PROVIDER_GCP |
| containing_cloud_location | =, != | Corresponde ao CloudLocation que contém o nome completo do recurso. | containing_cloud_location = "projects/clf-e2e-testing/locations/global/cloudLocations/aws-us-east-1" |
| display_name | =, != | Corresponde ao display_name de um CloudLocation pelo nome completo. | display_name = "us-east-1" |
| latency | >, < | 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 de filtro ilustra o formato a ser usado ao incluir um filtro em consultas HTTP ou da Google Cloud CLI do 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"