调用DescribeAvailableClasses接口查询RDS实例可购买规格，包括规格代码和存储空间。

调试

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

请求参数

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

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

RegionId String 是 cn-hangzhou

当前实例的地域ID。可以通过接口DescribeDBInstanceAttribute查看所属地域ID。

ZoneId String 是 cn-hangzhou-h

当前实例的可用区ID。可以通过接口DescribeDBInstanceAttribute查看所属可用区ID。

说明 若DescribeDBInstanceAttribute返回多可用区（例如cn-hangzhou-MAZ9(g,h)），请以单可用区形式传入。例如：cn-hangzhou-g或cn-hangzhou-h。
InstanceChargeType String 是 Prepaid

当前付费类型，取值：

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

当前数据库类型。取值：

  • MySQL
  • SQLServer
  • PostgreSQL
  • MariaDB
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_std_ha、2019_ent
  • PostgreSQL：10.0、11.0、12.0、13.0、14.0、15.0
  • MariaDB：10.3
DBInstanceId String 否 rm-uf6wjk5xxxxxx

实例ID。
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 是 HighAvailability

当前实例系列。取值：

  • Basic：基础版
  • HighAvailability：高可用版
  • AlwaysOn：集群版
  • Finance：三节点企业版
CommodityCode String 否 bards

当前实例的商品码。取值：

  • bards：主实例按量付费（中国站）
  • rds：主实例包年包月（中国站）
  • rords：只读实例按量付费（中国站）
  • rds_rordspre_public_cn：只读实例包年包月（中国站）
  • bards_intl：主实例按量付费（国际站）
  • rds_intl：主实例包年包月（国际站）
  • rords_intl：只读实例按量付费（国际站）
  • rds_rordspre_public_intl：只读实例包年包月（国际站）
说明 查询只读实例时必须传入本参数。

返回数据

名称 类型 示例值 描述
RequestId String 7E4448A6-9FE6-4474-A0C1-AA7CFC772CAC

请求ID。
DBInstanceClasses Array of DBInstanceClass

当前实例可用规格列表。
DBInstanceClass String rds.mysql.c1.large

实例规格。
DBInstanceStorageRange Object

实例存储空间范围。
Step Integer 5

调整存储空间的最小粒度。当前为固定5 GB递增。
MinValue Integer 5

最小存储空间，单位：GB。
MaxValue Integer 2000

最大存储空间，单位：GB。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableClasses
&DBInstanceId=rm-uf6wjk5xxxxxx
&Category=HighAvailability
&DBInstanceStorageType=local_ssd
&Engine=MySQL
&EngineVersion=8.0
&InstanceChargeType=Prepaid
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-h
&<公共请求参数>

正常返回示例

XML格式 

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

<DescribeAvailableClassesResponse>
<DBInstanceClasses>
    <DBInstanceClass>rds.mysql.c1.large</DBInstanceClass>
    <DBInstanceStorageRange>
        <MinValue>5</MinValue>
        <MaxValue>2000</MaxValue>
        <Step>5</Step>
    </DBInstanceStorageRange>
</DBInstanceClasses>
<DBInstanceClasses>
    <DBInstanceClass>rds.mysql.st.v52</DBInstanceClass>
    <DBInstanceStorageRange>
        <MinValue>1000</MinValue>
        <MaxValue>6000</MaxValue>
        <Step>5</Step>
    </DBInstanceStorageRange>
</DBInstanceClasses>
<RequestId>7E4448A6-9FE6-4474-A0C1-AA7CFC772CAC</RequestId>
</DescribeAvailableClassesResponse>

JSON格式 

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

{
  "DBInstanceClasses" : [ {
    "DBInstanceClass" : "rds.mysql.c1.large",
    "DBInstanceStorageRange" : {
      "MinValue" : 5,
      "MaxValue" : 2000,
      "Step" : 5
    }
  }, {
    "DBInstanceClass" : "rds.mysql.st.v52",
    "DBInstanceStorageRange" : {
      "MinValue" : 1000,
      "MaxValue" : 6000,
      "Step" : 5
    }
  } ],
  "RequestId" : "7E4448A6-9FE6-4474-A0C1-AA7CFC772CAC"
}

错误码

HttpCode 错误码 错误信息 描述
400 ArticleNotFound Article not found 没有找到相关约束
404 InvalidCondition.NotFound No class found 操作失败，可用类的条件无效。

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