文档首页/企业交换机 ESW/API参考/企业交换机/查询ESW实例可用区 - ListAvailabilityZones
更新时间：2025-11-20 GMT+08:00
查看PDF
分享

查询ESW实例可用区 - ListAvailabilityZones

功能介绍

当您在创建ESW实例时，需要通过调用本接口获取ESW实例主备节点可分布的可用区列表。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

esw:availabilityZone:list

List

-

-

-

-

URI

GET /v3/{project_id}/l2cg/availability-zones

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

  • 参数解释：ESW实例所属项目ID。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

availability_zones

Array of strings

  • 参数解释：查询可用区的响应体。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

request_id

String

  • 参数解释：请求的唯一标识。

  • 约束限制：UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

请求示例

GET https://{{endpoint}}/v3/060576782980d5762f9ec014dd2f1148/l2cg/availability-zones

响应示例

状态码：200

GET操作正常返回，更多状态码请参见状态码。

{
  "availability_zones" : [ "az1", "az2" ],
  "request_id" : "0bbb314411921a8378671558c4e08f5b"
}

状态码

状态码

描述

200

GET操作正常返回，更多状态码请参见状态码。

错误码

请参见错误码。

父主题：企业交换机

相关文档