调用DescribeZones接口查询指定地域中可用区的列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeZones | 要执行的操作,取值:DescribeZones。 |
| RegionId | String | 是 | cn-hangzhou | 可用区所在的地域ID。您可以通过调用DescribeRegions接口获取地域ID。 |
| ZoneType | String | 否 | AvailabilityZone | 查询可用区的类型,默认取值为AvailabilityZone即普通云上可用区。 |
| AcceptLanguage | String | 否 | zh-cn | 返回值可用区名称LocalName的显示语言。取值:
|
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Zones | Array of Zone | 可用区的集合。 |
|
| Zone | |||
| LocalName | String | 华东 1 可用区 B | 可用区名称。 |
| ZoneId | String | cn-hangzhou-b | 可用区ID。 |
| ZoneType | String | AvailabilityZone | 查询到的可用区的类型,默认取值为AvailabilityZone即普通云上可用区。 |
| RequestId | String | 6FEA0CF3-D3B9-43E5-A304-D217037876A8 | 请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeZones &RegionId=cn-hangzhou &<公共请求参数>
正常返回示例
XML格式
<DescribeZonesResponse>
<RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8</RequestId>
<Zones>
<Zone>
<ZoneId>cn-hangzhou-b</ZoneId>
<ZoneType>AvailabilityZone</ZoneType>
<LocalName>华东 1 可用区 B</LocalName>
</Zone>
</Zones>
</DescribeZonesResponse>
JSON格式
{
"DescribeZonesResponse": {
"RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
"Zones": {
"Zone": {
"ZoneId": "cn-hangzhou-b",
"ZoneType": "AvailabilityZone",
"LocalName": "华东 1 可用区 B"
}
}
}
}
错误码
访问错误中心查看更多错误码。