查询规格信息 - 云数据库 RDS

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	ListClasses	系统规定参数。取值：ListClasses。
ClientToken	String	否	ETnLKlblzczshOTUbOCzxxxxxxx	用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。
CommodityCode	String	是	bards	需要查询的实例商品码。 bards_intl：主实例按量付费 rds_intl：主实例包年包月 rords_intl：只读实例按量付费 rds_rordspre_public_intl：只读实例包年包月
DBInstanceId	String	否	rm-uf6wjk5xxxxxxx	主实例ID。可调用DescribeDBInstances获取。说明查询只读实例规格列表，即CommodityCode参数中传入只读实例商品码时，本参数必传。
OrderType	String	是	BUY	需要查询的订单类型，取值： BUY：新购。 UPGRADE：变更配置。 RENEW：续费。 CONVERT：转换付费类型。
RegionId	String	否	cn-hangzhou	地域ID。可调用DescribeRegions获取。说明如果您使用的是阿里云国际站账号，此参数必传。

返回数据


名称	类型	示例值	描述
RequestId	String	CF8D35BF-263D-4F7B-883A-1163B79A9EC6	请求ID。
RegionId	String	cn-hangzhou	地域ID。
Items	Array of ClassList		由实例规格信息组成的数组。
MaxIOPS	String	10000	实例规格对应的最大IOPS。单位：次/秒。
Cpu	String	1	实例规格对应的CPU核数。单位：个。
ReferencePrice	String	2500	实例规格对应的价格。单位：分（美元）。说明 CommodityCode参数中传入按量付费商品码时，本参数展示每小时的价格。 CommodityCode参数中传入包年包月商品码时，本参数展示每月的价格。
MaxConnections	String	2000	实例规格对应的最大连接数。单位：个。
MemoryClass	String	1GB（单机基础版）	实例规格对应的内存容量。单位：GB。
ClassCode	String	mysql.n1.micro.1	实例规格代码。更多信息，请参见主实例规格列表和只读实例规格列表。
ClassGroup	String	通用型	实例规格族。更多信息，请参见实例规格族。
MaxIOMBPS	String	1024Mbps	实例规格对应的最大IO带宽。单位：Mbps。
EncryptedMemory	String	4	安全增强型实例规格加密内存大小。单位：GB。
InstructionSetArch	String	arm	实例规格所属架构类型，返回值如下：如果是实例为x86架构，默认该参数返回值为空。如果是实例为arm架构，则返回arm。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=ListClasses
&CommodityCode=bards
&OrderType=BUY
&<公共请求参数>

正常返回示例

XML格式

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

<ListClassesResponse>
<RequestId>CF8D35BF-263D-4F7B-883A-1163B79A9EC6</RequestId>
<Items>
    <MaxIOMBPS>1024Mbps</MaxIOMBPS>
    <ClassCode>mysql.n2.medium.1</ClassCode>
    <MaxConnections>4000</MaxConnections>
    <ClassGroup>通用型</ClassGroup>
    <Cpu>2 </Cpu>
    <MemoryClass> 4GB（单机基础版）</MemoryClass>
    <ReferencePrice>32.6</ReferencePrice>
    <MaxIOPS>10000</MaxIOPS>
</Items>
<Items>
    <MaxIOMBPS>1024Mbps</MaxIOMBPS>
    <ClassCode>mysql.n1.micro.1</ClassCode>
    <MaxConnections>2000</MaxConnections>
    <ClassGroup>通用型</ClassGroup>
    <Cpu>1 </Cpu>
    <MemoryClass> 1GB（单机基础版）</MemoryClass>
    <ReferencePrice>5.2</ReferencePrice>
    <MaxIOPS>10000</MaxIOPS>
</Items>
</ListClassesResponse>

JSON格式

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

{
  "RequestId" : "CF8D35BF-263D-4F7B-883A-1163B79A9EC6",
  "Items" : [ {
    "MaxIOMBPS" : "1024Mbps",
    "ClassCode" : "mysql.n2.medium.1",
    "MaxConnections" : "4000",
    "ClassGroup" : "通用型",
    "Cpu" : "2 ",
    "MemoryClass" : " 4GB（单机基础版）",
    "ReferencePrice" : "32.6",
    "MaxIOPS" : "10000"
  }, {
    "MaxIOMBPS" : "1024Mbps",
    "ClassCode" : "mysql.n1.micro.1",
    "MaxConnections" : "2000",
    "ClassGroup" : "通用型",
    "Cpu" : "1 ",
    "MemoryClass" : " 1GB（单机基础版）",
    "ReferencePrice" : "5.2",
    "MaxIOPS" : "10000"
  } ]
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidSecurityIPList.Duplicate	The Security IP address is not in the available range or occupied.	当前的安全IP地址已被占用或不在有效区间内，请重新设置安全IP地址。
400	InvalidCommodityCode.Malformed	The commodity code is invalid.	无效的商品码
403	Forbidden.Authentication	The operation is forbidden by Aliyun Realname Authentication System.	操作失败，该操作被阿里云实名认证系统禁止。
404	GetCommodity.Failed	Get commodity failed.	获取商品信息失败，参数CommodityCode无效，请检查该参数的正确性。
404	InvalidDBInstanceName.NotFound	Invalid DBInstanceId NotFound.	数据库实例ID不存在，请检查。

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