更新时间：2025-12-10 GMT+08:00
查询可用区列表 - ListServerAzInfo
功能介绍
查询可用区列表。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
|
授权项 |
访问级别 |
资源类型（*为必须） |
条件键 |
别名 |
依赖的授权项 |
|---|---|---|---|---|---|
|
ecs:cloudServers:listServersDetails |
list |
- |
g:EnterpriseProjectId |
ecs:cloudServers:list |
- |
URI
GET /v1/{project_id}/availability-zones
请求消息
无
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
availability_zone_id |
String |
可用区ID。 |
|
type |
String |
可用区类型。
|
|
mode |
String |
可用区模式。
|
|
public_border_group |
String |
公网边界组，网络的eip类别标识，用于查找az可用的eip池。 |
|
alias |
String |
可用区别名。 |
|
az_group_ids |
Array of strings |
可用区所属的AZGroup列表 |
|
category |
Integer |
可用区类型的子类型，取值和对应关系如下： 0： default 21：Homezone 41：IES 该字段主要用于区分在边缘场景下，边缘AZ的类型。取值为0，为默认取值，无具体含义。 |
请求示例
GET https://{endpoint}/v1/{project_id}/availability-zones
响应示例
{
"availability_zones": [
{
"availability_zone_id": "br-iaas-test1a",
"type": "Edge",
"mode": "dedicated",
"alias": "IES_test",
"public_border_group": "br-iaas-test1a",
"az_group_ids": [
"br-iaas-test1a"
],
"category": 21
}
]
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题： 可用区管理
