文档首页/ 分布式缓存服务 DCS/ API参考/ 历史API/ 其他接口/ 查询可用区信息
更新时间：2023-11-28 GMT+08:00
查看PDF
分享

查询可用区信息

功能介绍

在创建缓存实例时，需要配置实例所在的可用区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

查询成功。
父主题： 其他接口

相关文档