调用DescribeRegions接口查询所有RDS地域的详情。
调用创建实例接口CreateDBInstance之前,可以先用本接口查询RegionId和ZoneId。
说明 多可用区包含MAZ字样,例如cn-hangzhou-MAZ6(b,f)、cn-hangzhou-MAZ5(b,e,f)。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeRegions |
系统规定参数,取值:DescribeRegions。 |
AcceptLanguage | String | 否 | en-US |
指定返回的LocalName参数的语言。取值:
默认值:en-US |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Regions | Array of RDSRegion |
可选的地域和可用区列表。 |
|
RDSRegion | |||
RegionId | String | cn-hangzhou |
地域ID。 |
ZoneId | String | cn-hangzhou-h |
可用区ID。 |
LocalName | String | China (Hangzhou) |
地域名称。根据AcceptLanguage参数的值返回不同的语言。以cn-hangzhou地域为例的返回示例如下:
|
RegionEndpoint | String | rds.aliyuncs.com |
地域对应的服务接入地址(Endpoint)。更多信息,请参见请求结构。 |
ZoneName | String | Hangzhou Zone H |
可用区名称。根据AcceptLanguage参数的值返回不同的语言。以cn-hangzhou-h可用区为例的返回示例如下:
|
RequestId | String | 1AD222E9-E606-4A42-BF6D-8A4442913CEF |
请求ID。 |
示例
请求示例
https://rds.aliyuncs.com/?Action=DescribeRegions
&<公共请求参数>
正常返回示例
XML
格式
<DescribeRegionsResponse>
<RequestId>1CE1DC20-7EFC-464F-9583-0AB8915C5697</RequestId>
<Regions>
<RDSRegion>
<ZoneName>Hangzhou Zone H</ZoneName>
<ZoneId>cn-hangzhou-h</ZoneId>
<RegionId>cn-hangzhou</RegionId>
<LocalName>China (Hangzhou)</LocalName>
<RegionEndpoint>rds.aliyuncs.com</RegionEndpoint>
</RDSRegion>
<RDSRegion>
<ZoneName>East China 1 MZone10 H+I</ZoneName>
<ZoneId>cn-hangzhou-MAZ10(h,i)</ZoneId>
<RegionId>cn-hangzhou</RegionId>
<LocalName>China (Hangzhou)</LocalName>
<RegionEndpoint>rds.aliyuncs.com</RegionEndpoint>
</RDSRegion>
<RDSRegion>
<ZoneName>East China 1 MZone8 F+G</ZoneName>
<ZoneId>cn-hangzhou-MAZ8(f,g)</ZoneId>
<RegionId>cn-hangzhou</RegionId>
<LocalName>China (Hangzhou)</LocalName>
<RegionEndpoint>rds.aliyuncs.com</RegionEndpoint>
</RDSRegion>
</Regions>
</DescribeRegionsResponse>
JSON
格式
{
"RequestId": "1CE1DC20-7EFC-464F-9583-0AB8915C5697",
"Regions": {
"RDSRegion": [
{
"ZoneName": "Hangzhou Zone H",
"ZoneId": "cn-hangzhou-h",
"RegionId": "cn-hangzhou",
"LocalName": "China (Hangzhou)",
"RegionEndpoint": "rds.aliyuncs.com"
},
{
"ZoneName": "East China 1 MZone10 H+I",
"ZoneId": "cn-hangzhou-MAZ10(h,i)",
"RegionId": "cn-hangzhou",
"LocalName": "China (Hangzhou)",
"RegionEndpoint": "rds.aliyuncs.com"
},
{
"ZoneName": "East China 1 MZone8 F+G",
"ZoneId": "cn-hangzhou-MAZ8(f,g)",
"RegionId": "cn-hangzhou",
"LocalName": "China (Hangzhou)",
"RegionEndpoint": "rds.aliyuncs.com"
}
]
}
}
错误码
访问错误中心查看更多错误码。