更新时间:2023-12-12 GMT+08:00

查询可用区信息

功能介绍

在创建缓存实例时,需要配置实例所在的可用区ID,可通过该接口查询可用区的ID。例如,在华北-北京1区域有可用资源的分区创建缓存实例,可从接口响应消息中,查找resource_availability字段为true的可用区,该记录对应的id即是创建缓存实例时需要配置的可用区ID。

URI

GET /v1.0/availableZones

请求消息

请求参数

无。

请求示例

无。

响应消息

响应参数

参数说明见表1
表1 参数说明

参数

类型

说明

regionId

String

区域ID。

available_zones

Array

可用区数组,具体请参考表2

表2 available_zones参数说明

参数

类型

说明

id

String

可用区ID。

code

String

可用区编码。

name

String

可用区名称。

port

String

可用区端口号。

resource_availability

String

分区上是否还有可用资源。

  • true:还有资源。
  • false:资源已售罄。

响应示例

{
    "regionId": "XXXXXX",
    "available_zones": [
        {
            "id": "f84448fd537f46078dd8bd776747f573",
            "code": "XXXXXX",
            "name": "XXXXXX",
            "port": "8003",
            "resource_availability": "true"
        },
        {
            "id": "12c47a78666b4e438cd0c692b9860387",
            "code": "XXXXXX",
            "name": "XXXXXX",
            "port": "8002",
            "resource_availability": "true"
        },
        {
            "id": "0725858e0d26434f9aa3dc5fc40d5697",
            "code": "XXXXXX",
            "name": "XXXXXX",
            "port": "8009",
            "resource_availability": "true"
        }
    ]
} 

状态码

操作成功的状态码如表3所示,其他响应见表1

表3 状态码

状态码

描述

200

查询成功。