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
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:
|
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:
|
ImageCategory | String | No | AliLinux |
The image of the host. Valid values:
|
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:
|
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.