调用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"
}

错误码

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