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

调试

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

请求参数

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxx

实例ID。
Category String 是 HighAvailability

当前实例系列。取值：

  • Basic：基础版
  • HighAvailability：高可用版
  • AlwaysOn：集群版
  • Finance：三节点企业版
DBInstanceStorageType String 是 local_ssd

当前实例存储类型。取值：

  • local_ssd：本地SSD盘（推荐）
  • cloud_ssd：SSD云盘
  • cloud_essd：ESSD PL1云盘
  • cloud_essd2：ESSD PL2云盘
  • cloud_essd3：ESSD PL3云盘
Engine String 是 MySQL

当前数据库类型。取值：

  • MySQL
  • SQLServer
  • PostgreSQL
  • PPAS
  • 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_ent
  • PostgreSQL：9.4、10.0、11.0、12.0
  • PPAS：9.3、10.0
  • MariaDB：10.3
InstanceChargeType String 是 Prepaid

当前付费类型，取值：

  • Prepaid：包年包月
  • Postpaid：按量付费
RegionId String 是 cn-hangzhou

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

ZoneId String 是 cn-hangzhou-h

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

OrderType String 否 BUY

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

CommodityCode String 否 bards

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

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

返回数据

名称 类型 示例值 描述
DBInstanceClasses Array of DBInstanceClass

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

实例规格。
DBInstanceStorageRange Struct

实例存储空间范围。
MaxValue Integer 2000

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

最小存储空间，单位：GB。
Step Integer 5

调整存储空间的最小粒度。当前为固定5 GB递增。
RequestId String 7E4448A6-9FE6-4474-A0C1-AA7CFC772CAC

请求ID。

示例

请求示例

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 格式 

<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 格式 

{
	"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"
}

错误码

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