调用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" } } } }
错误码
访问错误中心查看更多错误码。