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 de l'énergie bas 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.Le pourcentage de couverture et de fréquence d'exposition (CFE) n'est disponible que pour les emplacements Google Cloud . |
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 | =, != | Correspondances contenant CloudLocation par nom complet de ressource. | containing_cloud_location = "projects/clf-e2e-testing/locations/global/cloudLocations/aws-us-east-1" |
| display_name | =, != | Fait correspondre le nom à afficher 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 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 Cloud Location Finder ou 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"