调用ListClasses接口查询RDS实例所有规格的详情。

调试

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

请求参数

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

系统规定参数。取值:ListClasses

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

CommodityCode String bards

需要查询的实例商品码。

  • bards:主实例按量付费
  • rds:主实例包年包月
  • rords:只读实例按量付费
  • rds_rordspre_public_cn:只读实例包年包月
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不存在,请检查。

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