调用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 |
当前付费类型,取值:
|
Engine | String | 是 | MySQL |
当前数据库类型。取值:
|
EngineVersion | String | 是 | 8.0 |
当前数据库版本。取值:
|
DBInstanceId | String | 否 | rm-uf6wjk5xxxxxx |
实例ID。 |
OrderType | String | 否 | BUY |
订单类型。当前仅唯一取值:BUY。 |
DBInstanceStorageType | String | 是 | local_ssd |
当前实例存储类型。取值:
|
Category | String | 是 | HighAvailability |
当前实例系列。取值:
|
CommodityCode | String | 否 | bards |
当前实例的商品码。取值:
说明 查询只读实例时必须传入本参数。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 | 操作失败,可用类的条件无效。 |
访问错误中心查看更多错误码。