Cette page décrit la syntaxe des requêtes et des filtres que Cloud Location Finder utilise pour renvoyer des emplacements cloud en fonction du territoire, de la proximité et de l' utilisation d'énergie sans carbone (CFE%). Pour en savoir plus, consultez la documentation de référence de l'API REST.
| Champ | Opérateurs compatibles | Description | Exemple |
|---|---|---|---|
| carbon_free_energy_percentage | >, < | Correspond au pourcentage d'énergie sans carbone tel que défini par Google. CFE% n'est compatible qu'avec les Google Cloud emplacements. |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =, != | Correspond à un type d'emplacement cloud à l'aide d'une énumération. | cloud_location_type = CLOUD_LOCATION_TYPE_REGION |
| cloud_provider | =, != | Correspond à un fournisseur de services cloud à l'aide d'une énumération. | cloud_provider = CLOUD_PROVIDER_GCP |
| containing_cloud_location | =, != | Correspond à l'emplacement CloudLocation contenant par nom complet de la ressource. | containing_cloud_location = "projects/clf-e2e-testing/locations/global/cloudLocations/aws-us-east-1" |
| display_name | =, != | Correspond au display_name d'un CloudLocation par nom complet. | display_name = "us-east-1" |
| latence | >, < | Correspond aux critères de latence à l'aide d'un entier basé sur les mesures DAR avec une unité en ms. | latency < 50 |
| territory_code | =, != | Correspond à un code ISO 3166-1 alpha-2 à deux lettres. Le code à deux lettres doit être entièrement en majuscules. | territory_code = \"US\" |
Exemple de filtre
Cet exemple de filtre illustre le format à utiliser lorsque vous incluez un filtre dans les requêtes HTTP ou Google Cloud CLI de 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"