调用DescribeAvailableZones接口列出RDS可用区资源。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeAvailableZones

系统规定参数。取值：DescribeAvailableZones。

RegionId String 是 cn-hangzhou

地域ID。可以通过接口DescribeRegions查看可用的地域ID。

Engine String 是 MySQL

数据库类型。取值：

  • MySQL
  • SQLServer
  • PostgreSQL
  • PPAS
  • MariaDB
ZoneId String 否 cn-hangzhou-e

可用区ID。多可用区的格式与单可用区不同，包含MAZ字样，例如cn-hangzhou-MAZ6(b,f)、cn-hangzhou-MAZ5(b,e,f)。可以通过接口DescribeRegions查看可用区ID。

EngineVersion String 否 8.0

数据库版本。取值：

  • MySQL：5.5/5.6/5.7/8.0
  • SQL Server：2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_ent
  • PostgreSQL：9.4/10.0/11.0/12.0
  • PPAS：9.3/10.0
  • MariaDB：10.3
InstanceChargeType String 否 Postpaid

付费类型，取值：

  • Prepaid：包年包月
  • Postpaid：按量付费

返回数据

名称 类型 示例值 描述
AvailableZones Array

RDS可用区资源列表。
RegionId String cn-hangzhou

地域ID。
SupportedEngines Array

支持售卖的数据库类型列表。
Engine String MySQL

数据库类型。
SupportedEngineVersions Array

支持售卖的数据库版本列表。
SupportedCategorys Array

支持售卖的数据库系列列表。
Category String HighAvailability

实例系列。
SupportedStorageTypes Array

支持售卖的存储类型列表。
StorageType String local_ssd

实例存储类型。
Version String 8.0

数据库版本。
ZoneId String cn-hangzhou-e

可用区ID。
RequestId String 4256E149-C3C4-4FA7-BDEA-13CA415E8763

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableZones
&RegionId=cn-hangzhou
&Engine=MySQL
&ZoneId=cn-hangzhou-e
&EngineVersion=8.0
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeAvailableZonesResponse>
  <RequestId>4256E149-C3C4-4FA7-BDEA-13CA415E8763</RequestId>
  <AvailableZones>
        <ZoneId>cn-hangzhou-e</ZoneId>
        <RegionId>cn-hangzhou</RegionId>
        <SupportedEngines>
              <SupportedEngineVersions>
                    <Version>8.0</Version>
                    <SupportedCategorys>
                          <Category>HighAvailability</Category>
                          <SupportedStorageTypes>
                                <StorageType>local_ssd</StorageType>
                          </SupportedStorageTypes>
                          <SupportedStorageTypes>
                                <StorageType>cloud_ssd</StorageType>
                          </SupportedStorageTypes>
                    </SupportedCategorys>
                    <SupportedCategorys>
                          <Category>Basic</Category>
                          <SupportedStorageTypes>
                                <StorageType>cloud_ssd</StorageType>
                          </SupportedStorageTypes>
                    </SupportedCategorys>
              </SupportedEngineVersions>
              <Engine>MySQL</Engine>
        </SupportedEngines>
  </AvailableZones>
</DescribeAvailableZonesResponse>

JSON 格式 

{
	"RequestId": "4256E149-C3C4-4FA7-BDEA-13CA415E8763",
	"AvailableZones": [
		{
			"ZoneId": "cn-hangzhou-e",
			"RegionId": "cn-hangzhou",
			"SupportedEngines": [
				{
					"SupportedEngineVersions": [
						{
							"Version": "8.0",
							"SupportedCategorys": [
								{
									"Category": "HighAvailability",
									"SupportedStorageTypes": [
										{
											"StorageType": "local_ssd"
										},
										{
											"StorageType": "cloud_ssd"
										}
									]
								},
								{
									"Category": "Basic",
									"SupportedStorageTypes": [
										{
											"StorageType": "cloud_ssd"
										}
									]
								}
							]
						}
					],
					"Engine": "MySQL"
				}
			]
		}
	]
}

错误码

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