本页面介绍了 Cloud Location Finder 使用的查询和过滤条件语法，该语法用于根据 区域、邻近度和 无碳能源 (CFE%) 使用情况返回云位置。如需了解更多 信息，请参阅 REST API 参考文档。
| 字段 | 支持的运算符 | 说明 | 示例 |
|---|---|---|---|
| carbon_free_energy_percentage | >, < | 与 Google 定义的无碳能源百分比匹配。 CFE% 仅支持 Google Cloud locations。 |
carbon_free_energy_percentage > 75 |
| cloud_location_type | =, != | 使用枚举匹配云位置类型。 | 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" |
| latency | >, < | 使用基于 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"