调用DescribeClassList查询polardb集群的规格列表_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

查看集群规格列表。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
polardb:DescribeClassList	Read	dbcluster acs:polardb:{#regionId}:{#accountId}:dbcluster/*	无	无

请求参数

名称	类型	必填	描述	示例值
MasterHa	string	否	商品节点数量。取值范围如下： single: 单节点。 cluster: 集群版。 all: 单节点和集群版。	cluster
ResourceGroupId	string	否	资源组 ID。	rg-************
CommodityCode	string	是	商品 Code。取值范围如下： polardb_sub：中国内地包年包月。 polardb_sub _intl：中国香港及海外包年包月。 polardb_payg：中国内地按量付费。 polardb_payg_intl：中国香港及海外按量付费。 polardb_sub_jushita：聚石塔包年包月。 polardb_payg_jushita：聚石塔按量付费。 polardb_sub_cainiao：菜鸟包年包月。 polardb_payg_cainiao：菜鸟按量付费。说明如果您使用的是阿里云国内站账号，只能查看国内的商品 Code。如果您使用的是阿里云国际站账号，只能查看国际的商品 Code。如果您使用的是聚石塔账号，只能查看聚石塔的商品 Code。如果您使用的是菜鸟账号，只能查看菜鸟的商品 Code。	polardb_sub
OrderType	string	否	订单类型。取值范围如下： BUY：新购。 UPGRADE：变更配置。 RENEW：续费。 CONVERT：转换付费类型。	BUY
RegionId	string	否	地域 ID。说明如果您使用的是阿里云国际站账号，该参数必填。	cn-hangzhou

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	69A85BAF-1089-4CDF-A82F-0A140F******
Items	object []	集群规格列表。
Psl4MaxIOPS	string	PSL4 最大 I/O 请求次数，即 IOPS。单位：次/秒。	48000
ClassTypeLevel	string	规格类型。	enterprise
Cpu	string	CPU 核数。单位：个。	8
ReferencePrice	string	价格。单位：分（人民币）。说明 CommodityCode 参数中传入按量付费的商品 Code 时，显示为每小时的价格。 CommodityCode 参数中传入包年包月的商品 Code 时，显示为每月的价格。	200000
ReferenceExtPrice	string	额外价格。单位：分（人民币）。说明 MasterHa 参数中传入 cluster 和 single 时，显示与 ReferencePrice 相同。 MasterHa 参数中传入 cluster 和 single 时，显示单节点商品的价格。	200000
MaxConnections	string	最大集群并发连接数。	8000
MemoryClass	string	内存容量。单位：GB。	32
ClassCode	string	集群规格。	polar.mysql.x4.medium
ClassGroup	string	集群规格族。取值范围： Exclusive package：独享套餐。 Exclusive physical machine：独占物理机。 Beginner：入门级。 Historical specifications：历史规格。	Exclusive package
Psl5MaxIOPS	string	PSL5 最大 I/O 请求次数，即 IOPS。单位：次/秒。	96000
MaxIOPS	string	最大 I/O 请求次数，即 IOPS。单位：次/秒。	32000
MaxStorageCapacity	string	最大存储容量。单位：TB。	20
Pl1MaxIOPS	string	ESSD PL1 云盘的最大 IOPS。单位：次/秒。	50000
Pl2MaxIOPS	string	ESSD PL2 云盘的最大 IOPS。单位：次/秒。	100000
Pl3MaxIOPS	string	ESSD PL3 云盘的最大 IOPS。单位：次/秒。	1000000
RegionId	string	地域 ID。	cn-hangzhou

示例

正常返回示例

JSON格式

{
  "RequestId": "69A85BAF-1089-4CDF-A82F-0A140F******",
  "Items": [
    {
      "Psl4MaxIOPS": "48000",
      "ClassTypeLevel": "enterprise",
      "Cpu": "8",
      "ReferencePrice": "200000",
      "ReferenceExtPrice": "200000",
      "MaxConnections": "8000",
      "MemoryClass": "32",
      "ClassCode": "polar.mysql.x4.medium",
      "ClassGroup": "Exclusive package",
      "Psl5MaxIOPS": "96000",
      "MaxIOPS": "32000",
      "MaxStorageCapacity": "20",
      "Pl1MaxIOPS": "50000",
      "Pl2MaxIOPS": "100000",
      "Pl3MaxIOPS": "1000000"
    }
  ],
  "RegionId": "cn-hangzhou"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameters.Format	Specified parameters is not valid.	指定的参数无效。

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

变更历史

变更时间

变更内容概要

操作

2023-06-27

OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	新增错误码：400
入参	OpenAPI 入参发生变更。
	新增入参：MasterHa
出参	OpenAPI 返回结构发生变更。

2022-12-27

OpenAPI 返回结构发生变更

看变更集

变更项	变更内容
出参	OpenAPI 返回结构发生变更。

2022-09-08

新增 OpenAPI

看变更集