调用DescribeAvailableResource接口查询某地域可售卖资源信息。

本接口已下线，请使用DescribeAvailableZones和DescribeAvailableClasses。

说明 1分钟内最多调用20次本接口。

调试

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

请求参数

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

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

RegionId String 否 cn-hangzhou

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

ZoneId String 否 cn-hangzhou-b

可用区ID。
InstanceChargeType String 是 Postpaid

付费类型，取值：

  • Prepaid：包年包月
  • Postpaid：按量付费
Engine String 否 MySQL

数据库类型，取值：

  • MySQL
  • SQLServer
  • PostgreSQL
  • MariaDB
EngineVersion String 否 5.7

数据库版本，取值：

  • MySQL：5.5/5.6/5.7/8.0
  • SQL Server：2008r2/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_ent/2019_ent
  • PostgreSQL：9.4/10.0/11.0/12.0/13.0/14.0/15.0
  • MariaDB：10.3
DBInstanceClass String 否 rds.mysql.s1.small

实例规格，详情请参见实例规格表。

OrderType String 否 BUY

订单类型。仅唯一取值：BUY。

DBInstanceStorageType String 否 local_ssd

实例储存类型，取值：

  • local_ssd：本地SSD盘
  • cloud_ssd：SSD云盘
  • cloud_essd：ESSD PL1云盘
  • cloud_essd2：ESSD PL2云盘
  • cloud_essd3：ESSD PL3云盘
Category String 否 Basic

实例系列，取值：

  • Basic：基础版
  • HighAvailability：高可用版
  • AlwaysOn：集群版
  • Finance：三节点企业版
DispenseMode Integer 否 0

是否返回支持单可用区部署功能的可用区列表。取值：

  • 1：返回。
  • 0：不返回。

默认值：0

说明 单可用区部署功能支持将三节点企业版实例安装到单个可用区中。

返回数据

名称 类型 示例值 描述
RequestId String A32E046E-2643-4B65-828D-23FEED4853A3

请求ID。
AvailableZones Array of AvailableZone

支持售卖资源的可用区列表。
AvailableZone
ZoneId String cn-hangzhou-b

可用区ID。
Status String Enable

当前地域是否可以售卖资源。取值：

  • Enable：可售卖
  • Disable：不可售卖
RegionId String cn-hangzhou

地域ID。
SupportedEngines Array of SupportedEngine

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

数据库类型。
SupportedEngineVersions Array of SupportedEngineVersion

支持售卖的数据库版本列表。
SupportedEngineVersion
Version String 5.7

数据库版本。
SupportedCategorys Array of SupportedCategory

支持售卖的系列列表。
SupportedCategory
Category String HighAvailability

实例系列。
SupportedStorageTypes Array of SupportedStorageType

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

存储类型。
AvailableResources Array of AvailableResource

可售卖的资源列表。
AvailableResource
StorageRange String "{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"

可售卖的存储空间的规格。包括最大值、最小值和递增大小。
DBInstanceClass String rds.mysql.s1.small

实例规格。
DBInstanceStorageRange Object

可售卖的存储空间范围列表。
Step Integer 5

存储空间的递增大小。单位：GB。
Max Integer 2000

可售卖的存储空间最大值。单位：GB。
Min Integer 5

可售卖的存储空间最小值。单位：GB。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableResource
&InstanceChargeType=Postpaid
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAvailableResourceResponse>
    <RequestId>A32E046E-2643-4B65-828D-23FEED4853A3</RequestId>
    <AvailableZones>
        <ZoneId>cn-hangzhou-b</ZoneId>
        <Status>Enable</Status>
        <RegionId>cn-hangzhou</RegionId>
        <SupportedEngines>
            <Engine>MySQL</Engine>
            <SupportedEngineVersions>
                <Version>5.7</Version>
                <SupportedCategorys>
                    <Category>HighAvailability</Category>
                    <SupportedStorageTypes>
                        <StorageType>local_ssd</StorageType>
                        <AvailableResources>
                            <StorageRange>"{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"</StorageRange>
                            <DBInstanceClass>rds.mysql.s1.small</DBInstanceClass>
                            <DBInstanceStorageRange>
                                <Step>5</Step>
                                <Max>2000</Max>
                                <Min>5</Min>
                            </DBInstanceStorageRange>
                        </AvailableResources>
                    </SupportedStorageTypes>
                </SupportedCategorys>
            </SupportedEngineVersions>
        </SupportedEngines>
    </AvailableZones>
</DescribeAvailableResourceResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A32E046E-2643-4B65-828D-23FEED4853A3",
  "AvailableZones" : [ {
    "ZoneId" : "cn-hangzhou-b",
    "Status" : "Enable",
    "RegionId" : "cn-hangzhou",
    "SupportedEngines" : [ {
      "Engine" : "MySQL",
      "SupportedEngineVersions" : [ {
        "Version" : "5.7",
        "SupportedCategorys" : [ {
          "Category" : "HighAvailability",
          "SupportedStorageTypes" : [ {
            "StorageType" : "local_ssd",
            "AvailableResources" : [ {
              "StorageRange" : "\"{\\\"values\\\":[{\\\"max\\\":2000,\\\"min\\\":5,\\\"step\\\":5}]}\"",
              "DBInstanceClass" : "rds.mysql.s1.small",
              "DBInstanceStorageRange" : {
                "Step" : 5,
                "Max" : 2000,
                "Min" : 5
              }
            } ]
          } ]
        } ]
      } ]
    } ]
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 ArticleNotFound Article not found 没有找到相关约束

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