Auf dieser Seite wird die Abfrage- und Filtersyntax beschrieben, die vom Cloud Location Finder verwendet wird, um Cloud-Standorte basierend auf Gebiet, Nähe und CO2-freiem Energieanteil (CFE%) zurückzugeben. Weitere Informationen finden Sie in der REST API-Referenz.
| Feld | Unterstützte Operatoren | Beschreibung | Beispiel |
|---|---|---|---|
| carbon_free_energy_percentage | >, < | Entspricht dem von Google definierten Prozentsatz für CO₂-freie Energie. CFE% wird nur für Google Cloud Standorte unterstützt. |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =, != | Entspricht einem Cloud-Standorttyp, der über eine Enumeration angegeben wird. | cloud_location_type = CLOUD_LOCATION_TYPE_REGION |
| cloud_provider | =, != | Entspricht einem Cloud-Anbieter, der ein Enum verwendet. | cloud_provider = CLOUD_PROVIDER_GCP |
| containing_cloud_location | =, != | Übereinstimmungen, die CloudLocation nach vollständigem Ressourcennamen enthalten. | containing_cloud_location = "projects/clf-e2e-testing/locations/global/cloudLocations/aws-us-east-1" |
| display_name | =, != | Gleicht den display_name einer CloudLocation anhand des vollständigen Namens ab. | display_name = "us-east-1" |
| Latenz | >, < | Entspricht den Latenzkriterien. Es wird eine Ganzzahl basierend auf RTT-Messungen mit der Einheit „ms“ verwendet. | latency < 50 |
| territory_code | =, != | Entspricht einem zweistelligen ISO 3166-1 Alpha-2-Code. Der zweistellige Code muss vollständig in Großbuchstaben geschrieben werden. | territory_code = \"US\" |
Beispielfilter
Dieser Beispielfilter veranschaulicht das Format, das verwendet werden muss, wenn ein Filter in Cloud Location Finder-HTTP- oder Google Cloud CLI-Abfragen enthalten ist.
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"