Queries the specifications of a specified host.

After a host is created, you can call this API operation to view the specifications of the host. The specifications include the CPU resources, memory resources, CPU model, host type, and storage type.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeHostEcsLevelInfo

The operation that you want to perform. Set the value to DescribeHostEcsLevelInfo.

DbType String Yes mysql

The type of database engine. Valid values:

  • mysql
  • mssql
  • pgsql
  • redis
RegionId String Yes cn-hangzhou

The ID of the region. For more information about region IDs, see Region IDs.

ZoneId String Yes ap-southeast-1a

The ID of the zone in the region.

StorageType String Yes local_ssd

The type of storage media that is used for the instances. Valid values:

  • local_ssd: standard SSDs
  • cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
  • cloud_essd2: ESSDs of PL2
  • cloud_essd3: ESSDs of PL3
ImageCategory String No AliLinux

The image of the host. Valid values:

  • WindowsWithMssqlEntAlwaysonLicense: SQL Server Cluster Edition
  • WindowsWithMssqlStdLicense: SQL Server Standard Edition
  • WindowsWithMssqlEntLicense: SQL Server Enterprise Edition
  • WindowsWithMssqlWebLicense: SQL Server Web Edition
  • AliLinux: other host images

Response parameters

Parameter Type Example Description
RequestId String 395858E2-2A82-4ED7-BB93-2DB60119EF4C

The ID of the request.

HostEcsLevelInfos Array of HostEcsLevelInfos

Detailed information about the Elastic Compute Service (ECS) instance.

CddcHostType String ram

The type of the host. Valid values:

  • general: General-purpose
  • compute: Compute-optimized
  • ram: Memory-optimized
  • dragon: ECS Bare Metal Instance
Items Array of Items

The specifications of the host.

NetBandWidth Float 10

The internal bandwidth of the host. Unit: Gbit/s.

EcsClass String General-purpose instance family g6

The instance family of the host.

RdsClassCode String mssql.cluster.host.g2xlarge

The type of the ApsaraDB RDS instance.

Cpu Integer 24

The number of vCPU cores configured for the host.

CpuFrequency String 2.5 GHz/3.2 GHz

The processor frequency. Unit: GHz.

StorageIops Integer 5

To obtain the storage IOPS of the host, multiply the value of this parameter by 10,000.

CloudStorageBandwidth Float 4

The bandwidth of the ESSD. Unit: Gbit/s.

EcsClassCode String ecs.g6.2xlarge

The type of the ECS instance.

IsCloudDisk Integer 1

Indicates whether the host uses disks.

Memory Integer 192

The memory of the host. Unit: GB.

NetPackage Integer 150

The packet forwarding rate over the internal network. Unit: ten thousand packets per second (PPS).

CpuVersion String Intel Xeon(Cascade Lake) Platinum 8269CY

The CPU model of the host.

LocalStorage String 7

The local storage.

Description String testxxx

The name of the host.

Examples

Sample requests

http(s)://cddc.aliyuncs.com/?Action=DescribeHostEcsLevelInfo
&DbType=mysql
&RegionId=cn-hangzhou
&ZoneId=ap-southeast-1a
&StorageType=local_ssd
&ImageCategory=AliLinux
&Common request parameters

Sample responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeHostEcsLevelInfoReponse>
<RequestId>395858E2-2A82-4ED7-BB93-2DB60119EF4C</RequestId>
<HostEcsLevelInfos>
    <CddcHostType>ram</CddcHostType>
    <Items>
        <Description>testxxx</Description>
        <Memory>192</Memory>
        <Cpu>24</Cpu>
        <NetPackage>150</NetPackage>
        <CloudStorageBandwidth>4</CloudStorageBandwidth>
        <CpuVersion>Intel Xeon(Cascade Lake) Platinum 8269CY	</CpuVersion>
        <IsCloudDisk>1</IsCloudDisk>
        <NetBandWidth>10</NetBandWidth>
        <LocalStorage>7</LocalStorage>
        <StorageIops>5</StorageIops>
        <RdsClassCode>mssql.cluster.host.g2xlarge	</RdsClassCode>
        <EcsClassCode>ecs.g6.2xlarge	</EcsClassCode>
        <CpuFrequency>2.5 GHz/3.2 GHz</CpuFrequency>
        <EcsClass>General-purpose instance family g6</EcsClass>
    </Items>
</HostEcsLevelInfos>
</DescribeHostEcsLevelInfoReponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

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

Error codes

HttpCode Error code Error message Description
400 InvalidAction The specified action is not valid. The error message returned because the specified operation is invalid.
403 Permission.NotSupport You are not authorized to perform this action. The error message returned because you are not authorized to perform this operation.

For a list of error codes, visit the API Error Center.