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

调试

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

请求参数

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

系统规定参数。取值:ListClasses

CommodityCode String bards

需要查询的实例商品码。

中国站取值:

  • bards:主实例按量付费
  • rds:主实例包年包月
  • rords:只读实例按量付费
  • rds_rordspre_public_cn:只读实例包年包月

国际站取值:

  • bards_intl:主实例按量付费
  • rds_intl:主实例包年包月
  • rords_intl:只读实例按量付费
  • rds_rordspre_public_intl:只读实例包年包月
OrderType String BUY

需要查询的订单类型,取值:

  • BUY:新购。
  • UPGRADE:变更配置。
  • RENEW:续费。
  • CONVERT:转换付费类型。
ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

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

DBInstanceId String rm-uf6wjk5xxxxxxx

主实例ID。可调用DescribeDBInstances获取。

说明 查询只读实例规格列表,即 CommodityCode参数中传入只读实例商品码时,本参数必传。
RegionId String cn-hangzhou

地域ID。可调用DescribeRegions获取。

说明 如您使用的是阿里云国际站账号,此参数必传。

返回数据

名称 类型 示例值 描述
Items Array of ClassList

由实例规格信息组成的数组。

ClassCode String mysql.n1.micro.1

实例规格代码。更多信息,请参见主实例规格列表只读实例规格列表

ClassGroup String 通用型

实例规格族。更多信息,请参见实例规格族

Cpu String 1

实例规格对应的CPU核数。单位:个。

MaxConnections String 2000

实例规格对应的最大连接数。单位:个。

MaxIOMBPS String 1024Mbps

实例规格对应的最大IO带宽。单位:Mbps。

MaxIOPS String 10000

实例规格对应的最大IOPS。单位:次/秒。

MemoryClass String 1GB(单机基础版)

实例规格对应的内存容量。单位:GB。

ReferencePrice String 2500

实例规格对应的价格。

  • 中国站单位:分(人民币)。
  • 国际站单位:分(美元)。
说明
  • CommodityCode参数中传入按量付费商品码时,本参数展示每小时的价格。
  • CommodityCode参数中传入包年包月商品码时,本参数展示每月的价格。
RegionId String cn-hangzhou

地域ID。

RequestId String CF8D35BF-263D-4F7B-883A-1163B79A9EC6

请求ID。

示例

请求示例

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

正常返回示例

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

{
  "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 错误码 错误信息 描述
404 GetCommodity.Failed Get commodity failed. 获取商品失败。
404 InvalidDBInstanceName.NotFound Invalid DBInstanceId NotFound. 指定DBInstanceId不存在,请检查该参数是否正确。
400 InvalidSecurityIPList.Malformed The specified parameter "SecurityIPList" is not valid. 指定的SecurityIPList参数无效。
400 InvalidSecurityIPList.Duplicate The Security IP address is not in the available range or occupied. 指定的安全IP地址已被占用或不在有效区间内。
403 Forbidden.Authentication The operation is forbidden by Aliyun Realname Authentication System. 该操作是由阿里云的实名认证系统所禁止。
400 InvalidCommodityCode.Malformed The commodity code is invalid. 无效的商品码

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