全部产品
Search
文档中心

云数据库 RDS:DescribeRegions - 查看可选的地域和可用区

更新时间:Mar 13, 2024

该接口用于查询所有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错误码错误信息描述
400Order.ComboInstanceNotAllowOperateA package instance is not allowed to operate independently.套餐实例不允许单独操作。
400Price.PricingPlanResultNotFoundPricing plan price result not found.定价计划价格结果没有找到。
400Order.NoRealNameAuthenticationYou have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication.您还未通过实名认证,不符合购买条件,请登录用户中心进行实名认证。
404InvalidAcceptLanguage.NotFoundOnly Chinese (zh-CN) and English (en-US) are allowed.-

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