调用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-gcn-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
  • 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 操作失败,可用类的条件无效。

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