调用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参数的语言。取值：

  • zh-CN：中文
  • en-US：英文

默认值：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地域为例的返回示例如下：

  • AcceptLanguage为zh-CN：华东1（杭州）
  • AcceptLanguage为en-US：China (Hangzhou)
RegionEndpoint String rds.aliyuncs.com

地域对应的服务接入地址（Endpoint）。更多信息，请参见请求结构。

ZoneName String Hangzhou Zone H

可用区名称。根据AcceptLanguage参数的值返回不同的语言。以cn-hangzhou-h可用区为例的返回示例如下：

  • AcceptLanguage为zh-CN：杭州 可用区H
  • AcceptLanguage为en-US：Hangzhou Zone 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"
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。