# 查询可用区信息
#### 功能介绍
在创建缓存实例时，需要配置实例所在的可用区ID，可通过该接口查询可用区的ID。例如，在华北-北京1区域有可用资源的分区创建缓存实例，可从接口响应消息中，查找resource_availability字段为true的可用区，该记录对应的id即是创建缓存实例时需要配置的可用区ID。
#### **URI**
GET /v1.0/availableZones
#### **请求消息**
**请求参数**
无。
**请求示例**
无。
#### **响应消息**
**响应参数**
参数说明见[表1]。
 表1参数说明 
| 参数              | 类型      | 说明                                                    |
|:---|:---|:---|
| regionId      | String | 区域ID。                                                  |
| available_zones | Array    | 可用区数组，具体请参考[表2]。 |
   
 表2available_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](https://support.huaweicloud.com/api-dcs/dcs-api-0312043.html#dcs-api-0312043__table5210141351517)。
 表3状态码 
| 状态码 | 描述    |
|:---|:---|
| 200 | 查询成功。 |