文档中心

缓存数据库 Redis 版

请输入

地域和可用区

DescribeZones

调用 DescribeZones 接口查询缓存数据库 Redis 版在指定地域下的可用区资源列表。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
RegionId	String	是	cn-beijing	地域 ID。说明您可以调用 DescribeRegions接口查询 Redis 实例所有可用的地域资源信息，包括地域 ID。

返回参数

参数	类型	示例值	描述
Zones	Array of ZoneInfo	请参见返回示例。	可用区列表。

ZoneInfo

参数	类型	示例值	描述
ZoneId	String	cn-beijing-a	可用区 ID。
ZoneName	String	可用区A	可用区名称。
ZoneStatus	Integer	1	可用区状态，取值范围如下： 1：目标可用区可正常购买。 2：目标可用区已售罄，不可购买。

示例

请求示例

POST https://redis.cn-beijing.volcengineapi.com/?Action=DescribeZones&Version=2020-12-07 HTTP/1.1​
Host: redis.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=utf-8​
X-Date: 20201103T104027Z​
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=****​
{​
    "RegionId":"cn-beijing"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "20250103160848EDBD027396F29CF2FBA3-b02bdc",​
    "Action": "DescribeZones",​
    "Version": "2020-12-07",​
    "Service": "Redis",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "Zones": [​
      {​
        "ZoneId": "cn-beijing-a",​
        "ZoneName": "可用区A",​
        "ZoneStatus": 1​
      },​
      {​
        "ZoneId": "cn-beijing-b",​
        "ZoneName": "可用区B",​
        "ZoneStatus": 1​
      },​
      {​
        "ZoneId": "cn-beijing-c",​
        "ZoneName": "可用区C",​
        "ZoneStatus": 1​
      },​
      {​
        "ZoneId": "cn-beijing-d",​
        "ZoneName": "可用区D",​
        "ZoneStatus": 1​
      }​
    ]​
  }​
}​

错误码

更多详情，请参见错误码。

最近更新时间：2026.09.23 11:37:29

这个页面对您有帮助吗？

有用

无用