首页 云数据库 RDS 开发参考 API参考 API目录 实例 DescribeRegions - 查看可选的地域和可用区

DescribeRegions - 查看可选的地域和可用区

更新时间: 2023-12-06 16:08:32

该接口用于查询所有RDS地域的详情。

接口说明

适用引擎

  • RDS MySQL
  • RDS PostgreSQL
  • RDS SQL Server
  • RDS MariaDB

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AcceptLanguagestring

指定返回的LocalName参数的语言。取值:

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

默认值:en-US

en-US

返回参数

名称类型描述示例值
object

返回参数详情。

RequestIdstring

请求ID。

1AD222E9-E606-4A42-BF6D-8A4442913CEF
Regionsobject []

可选的地域和可用区列表。

ZoneIdstring

可用区ID。

cn-hangzhou-h
RegionEndpointstring

地域对应的服务接入地址(Endpoint)。更多信息,请参见服务接入点

rds.aliyuncs.com
LocalNamestring

地域名称。根据AcceptLanguage参数的值返回不同的语言。以cn-hangzhou地域为例的返回示例如下:

  • AcceptLanguagezh-CN:华东1(杭州)
  • AcceptLanguageen-US:China (Hangzhou)
China (Hangzhou)
RegionIdstring

地域ID。

cn-hangzhou
ZoneNamestring

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

  • AcceptLanguagezh-CN:杭州 可用区H
  • AcceptLanguageen-US:Hangzhou Zone H
Hangzhou Zone H

示例

正常返回示例

JSON格式

{
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "Regions": {
    "RDSRegion": [
      {
        "ZoneId": "cn-hangzhou-h",
        "RegionEndpoint": "rds.aliyuncs.com",
        "LocalName": "China (Hangzhou)",
        "RegionId": "cn-hangzhou",
        "ZoneName": "Hangzhou Zone H"
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息
404InvalidAcceptLanguage.NotFoundOnly Chinese (zh-CN) and English (en-US) are allowed.

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

阿里云首页 云数据库 RDS 相关技术圈