DescribeHostEcsLevelInfo - 查询主机规格详细信息

更新时间:2025-03-12 10:40:46

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

接口说明

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

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
名称类型必填描述示例值
DbTypestring

数据库引擎类型,取值:

  • mysql
  • mssql
  • pgsql
  • redis
mysql
RegionIdstring

地域 ID。可查看地域信息获取。

cn-hangzhou
ZoneIdstring

地域下的可用区 ID。

ap-southeast-1a
StorageTypestring

实例存储类型,取值:

  • local_ssd:SSD 云盘
  • cloud_essd:ESSD PL1 云盘
  • cloud_essd2:ESSD PL2 云盘
  • cloud_essd3:ESSD PL3 云盘
local_ssd
ImageCategorystring

主机镜像。取值:

  • WindowsWithMssqlEntAlwaysonLicense:SQL Server 集群版

  • WindowsWithMssqlStdLicense:SQL Server 标准版

  • WindowsWithMssqlEntLicense:SQL Server 企业版

  • WindowsWithMssqlWebLicense:SQL Server Web 版

  • AliLinux:其他主机镜像。

AliLinux

返回参数

名称类型描述示例值
名称类型描述示例值
object
RequestIdstring

请求 ID。

395858E2-2A82-4ED7-BB93-2DB60119EF4C
HostEcsLevelInfosarray<object>

ECS 主机信息列表。

HostEcsLevelInfosobject
CddcHostTypestring

主机类型 ,取值:

  • general: 通用型。
  • compute: 计算型。
  • ram: 内存型。
  • dragon: 弹性裸金属服务器(神龙)。
ram
Itemsarray<object>

主机规格详情。

Itemsobject
NetBandWidthfloat

内网带宽,单位为 Gbps。

10
EcsClassstring

规格族。

通用型 g6
RdsClassCodestring

RDS 规格。

mssql.cluster.host.g2xlarge
Cpuinteger

主机 CPU。

24
CpuFrequencystring

处理器频率,单位为 GHz。

2.5 GHz/3.2 GHz
StorageIopsinteger

存储 IOPS ,单位为万。

5
CloudStorageBandwidthfloat

云盘带宽,单位为 Gbit/s。

4
EcsClassCodestring

ECS 规格。

ecs.g6.2xlarge
IsCloudDiskinteger

是否为云盘。

1
Memoryinteger

内存大小,单位为 GB。

192
NetPackageinteger

内网收发包,单位为万 PPS。

150
CpuVersionstring

处理器型号。

Intel Xeon(Cascade Lake) Platinum 8269CY
LocalStoragestring

本地存储。

7
Descriptionstring

主机的名称。

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错误码错误信息描述
HTTP status code错误码错误信息描述
400InvalidActionThe specified action is not valid.指定的操作无效
403Permission.NotSupportYou are not authorized to perform this action.不允许操作
403Forbidden.RAMUser not authorized to operate on the specified resource, or this API does not support RAM.操作被禁止

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

变更历史

变更时间变更内容概要操作
变更时间变更内容概要操作
2021-09-08OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情
  • 本页导读 (1)
  • 接口说明
  • 调试
  • 授权信息
  • 请求参数
  • 返回参数
  • 示例
  • 错误码
  • 变更历史