本页介绍了 Cloud Location Finder 使用的查询和过滤条件语法，该语法可根据地理位置、邻近度和无碳能源 (CFE%) 使用情况返回云位置。如需了解详情，请参阅 REST API 参考文档。
| 字段 | 支持的运算符 | 说明 | 示例 |
|---|---|---|---|
| carbon_free_energy_percentage | >、< | 与 Google 定义的无碳能源百分比相匹配。 CFE% 仅支持 Google Cloud 位置。 |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =、!= | 使用枚举匹配 Cloud 位置类型。 | cloud_location_type = CLOUD_LOCATION_TYPE_REGION |
| cloud_provider | =、!= | 使用枚举匹配云提供商。 | cloud_provider = CLOUD_PROVIDER_GCP |
| containing_cloud_location | =、!= | 包含 CloudLocation 的匹配项（按完整资源名称）。 | containing_cloud_location = "projects/clf-e2e-testing/locations/global/cloudLocations/aws-us-east-1" |
| display_name | =、!= | 按全名匹配 CloudLocation 的 display_name。 | display_name = "us-east-1" |
| 延迟时间 | >、< | 根据 RTT 测量结果（以毫秒为单位）使用整数匹配延迟时间条件。 | latency < 50 |
| territory_code | =、!= | 匹配两个字母的 ISO 3166-1 alpha-2 代码。双字母代码必须全部大写。 | territory_code = \"US\" |
过滤条件示例
此过滤条件示例展示了在 Cloud Location Finder HTTP 或 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"