通过DescribeHostEcsLevelInfo查询主机规格详细信息-云数据库专属集群-阿里云-云数据库专属集群(MyBase)-阿里云帮助中心

调用DescribeHostEcsLevelInfo查询主机规格详细信息。

接口说明

添加主机后，您可以查看主机规格的详细信息，包括 CPU、内存、处理器型号、主机类型、主机存储类型等。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

cddc:DescribeHostEcsLevelInfo

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
DbType	string	是	数据库引擎类型，取值： mysql mssql pgsql redis	mysql
RegionId	string	是	地域 ID。可查看地域信息获取。	cn-hangzhou
ZoneId	string	是	地域下的可用区 ID。	ap-southeast-1a
StorageType	string	是	实例存储类型，取值： local_ssd：SSD 云盘 cloud_essd：ESSD PL1 云盘 cloud_essd2：ESSD PL2 云盘 cloud_essd3：ESSD PL3 云盘	local_ssd
ImageCategory	string	否	主机镜像。取值： WindowsWithMssqlEntAlwaysonLicense：SQL Server 集群版 WindowsWithMssqlStdLicense：SQL Server 标准版 WindowsWithMssqlEntLicense：SQL Server 企业版 WindowsWithMssqlWebLicense：SQL Server Web 版 AliLinux：其他主机镜像。	AliLinux

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	395858E2-2A82-4ED7-BB93-2DB60119EF4C
HostEcsLevelInfos	array<object>	ECS 主机信息列表。
	array<object>
CddcHostType	string	主机类型，取值： general: 通用型。 compute: 计算型。 ram: 内存型。 dragon: 弹性裸金属服务器（神龙）。	ram
Items	array<object>	主机规格详情。
	object
NetBandWidth	number	内网带宽，单位为 Gbps。	10
EcsClass	string	规格族。	通用型 g6
RdsClassCode	string	RDS 规格。	mssql.cluster.host.g2xlarge
Cpu	integer	主机 CPU。	24
CpuFrequency	string	处理器频率，单位为 GHz。	2.5 GHz/3.2 GHz
StorageIops	integer	存储 IOPS ，单位为万。	5
CloudStorageBandwidth	number	云盘带宽，单位为 Gbit/s。	4
EcsClassCode	string	ECS 规格。	ecs.g6.2xlarge
IsCloudDisk	integer	是否为云盘。	1
Memory	integer	内存大小，单位为 GB。	192
NetPackage	integer	内网收发包，单位为万 PPS。	150
CpuVersion	string	处理器型号。	Intel Xeon(Cascade Lake) Platinum 8269CY
LocalStorage	string	本地存储。	7
Description	string	主机的名称。	testxxx

示例

正常返回示例

JSON格式

{
  "RequestId": "395858E2-2A82-4ED7-BB93-2DB60119EF4C",
  "HostEcsLevelInfos": [
    {
      "CddcHostType": "ram",
      "Items": [
        {
          "NetBandWidth": 10,
          "EcsClass": "通用型 g6",
          "RdsClassCode": "mssql.cluster.host.g2xlarge\t",
          "Cpu": 24,
          "CpuFrequency": "2.5 GHz/3.2 GHz",
          "StorageIops": 5,
          "CloudStorageBandwidth": 4,
          "EcsClassCode": "ecs.g6.2xlarge\t",
          "IsCloudDisk": 1,
          "Memory": 192,
          "NetPackage": 150,
          "CpuVersion": "Intel Xeon(Cascade Lake) Platinum 8269CY\t",
          "LocalStorage": "7",
          "Description": "testxxx"
        }
      ]
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidAction	The specified action is not valid.	指定的操作无效
403	Permission.NotSupport	You are not authorized to perform this action.	不允许操作
403	Forbidden.RAM	User not authorized to operate on the specified resource, or this API does not support RAM.	操作被禁止

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

变更历史

更多信息，参考变更详情。