更新时间:2025-09-23 GMT+08:00

查询可用区列表

功能介绍

在创建实例时,需要配置实例所在的可用区ID,可通过该接口查询可用区的ID。

调用方法

请参见如何调用API。

URI

GET /v1.0/{project_id}/availability-zones

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

availability_zones

Array of AvailabilityZone objects

参数解释:

可用区列表。

取值范围:

非空对象列表。

count

Integer

参数解释:

可用区数量。

取值范围:

不涉及。

表3 AvailabilityZone

参数

参数类型

描述

code

String

参数解释:

可用区唯一编码。

取值范围:

不涉及。

name

String

参数解释:

可用区名称。

取值范围:

不涉及。

status

String

参数解释:

可用区状态。

取值范围:

available:可用。

unavailable:不可用。

public_border_group

String

参数解释:

可用区组,如:center。

取值范围:

不涉及。

请求示例

查询可用区。

GET https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/availability-zones

响应示例

状态码:200

查询可用区列表成功。

{
  "availability_zones" : [ {
    "code" : "az1",
    "name" : "AZ1",
    "status" : "available",
    "public_border_group" : "center"
  } ],
  "count" : 1
}

状态码

状态码

描述

200

查询可用区列表成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。