Queries the specifications of a host.

After you create a host, you can call this operation to view the specifications of the host. The specifications include the CPU resources, memory resources, CPU model, host type, CPU base frequency and maximum turbo frequency, 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 No DescribeHostEcsLevelInfo

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

LevelCode String Yes mssql.cluster.host.g2xlarge

The instance type of the host. For more information, see Host specification details.

RegionId String Yes cn-hangzhou

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

CommodityCode String No cddc_hostprepaid_public_cn

The product code of the host on the site where the host is purchased. Valid values:

  • cddc_hostprepaid_public_cn: the China site (aliyun.com)
  • cddc_hostprepaid_public_intl: the International site (alibabacloud.com)

Response parameters

Parameter Type Example Description
CddcHostType Array of CddcHostType

The type of the host.

Text String general

The name of the host type.

Value String general

The code of the host type.

Items Array of Items

The specification details of the host.

CddcHostImageCategory String WindowsWithMssqlStdLicense

The image of the host. Valid values:

  • WindowsWithMssqlStdLicense
  • WindowsWithMssqlEntLicense
  • WindowsWithMssqlWebLicense
  • AliLinux
CddcHostType String general

The type of the host. Valid values:

  • general: the general-purpose type
  • compute: the compute-optimized type
  • ram: the memory-optimized type
  • dragon: the ECS Bare Metal Instance type
CloudStorageBandwidth Integer 4

The bandwidth of the enhanced SSD (ESSD). Unit: Gbit/s.

Cpu Integer 24

The number of CPU cores configured for the host.

CpuFrequency String 2.5 GHz/3.2 GHz

The CPU base frequency and maximum turbo frequency. Unit: GHz.

CpuVersion String Intel Xeon(Cascade Lake) Platinum 8269CY

The CPU model of the host.

EcsClass String g6, general-purpose instance family

The Elastic Compute Service (ECS) instance family of the host.

EcsClassCode String ecs.g6.2xlarge

The ECS instance type from which the host is created.

IsCloudDisk Integer 1

Indicates whether ESSDs are used.

LocalStorage String 7

The local storage.

Memory Integer 192

The memory size of the host. Unit: GB.

NetBandWidth Integer 10

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

NetPackage Integer 150

The rate at which packets are forwarded over an internal network. Unit: ten thousand packets per second (PPS).

Price String 2246499

The list price of the host. Unit: CNY.

RdsClassCode String mssql.cluster.host.g2xlarge

The instance type of the host.

StorageIops Integer 5

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

RequestId String 395858E2-2A82-4ED7-BB93-2DB60119EF4C

The ID of the request.

Examples

Sample requests

http(s)://cddc.aliyuncs.com/?Action=DescribeHostEcsLevelInfo
&LevelCode=mssql.cluster.host.g2xlarge
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DescribeHostEcsLevelInfoReponse>
  <RequestId>395858E2-2A82-4ED7-BB93-2DB60119EF4C</RequestId>
  <CddcHostType>
        <Value>general</Value>
        <Text>general</Text>
  </CddcHostType>
  <Items>
        <Memory>192</Memory>
        <CddcHostType>ram</CddcHostType>
        <Cpu>24</Cpu>
        <CddcHostImageCategory>WindowsWithMssqlStdLicense</CddcHostImageCategory>
        <CloudStorageBandwidth>4</CloudStorageBandwidth>
        <NetPackage>150</NetPackage>
        <CpuVersion>Intel Xeon(Cascade Lake) Platinum 8269CY</CpuVersion>
        <IsCloudDisk>1</IsCloudDisk>
        <NetBandWidth>10</NetBandWidth>
        <LocalStorage>7TB</LocalStorage>
        <Price>2246499</Price>
        <StorageIops>5</StorageIops>
        <RdsClassCode>mssql.cluster.host.r6xlarge</RdsClassCode>
        <CpuFrequency>2.5 GHz/3.2 GHz</CpuFrequency>
        <EcsClassCode>ecs.r6.6xlarge</EcsClassCode>
        <EcsClass>r6, memory optimized instance family</EcsClass>
  </Items>
</DescribeHostEcsLevelInfoReponse>

JSON format

{
        "RequestId": "395858E2-2A82-4ED7-BB93-2DB60119EF4C",
        "CddcHostType": {
            "Value": "general",
            "Text": "general"
        },
        "Items": {
            "Memory": 192,
            "CddcHostType": "ram",
            "Cpu": 24,
            "CddcHostImageCategory": "WindowsWithMssqlStdLicense",
            "CloudStorageBandwidth": 4,
            "NetPackage": 150,
            "CpuVersion": "Intel Xeon(Cascade Lake) Platinum 8269CY",
            "IsCloudDisk": 1,
            "NetBandWidth": 10,
            "LocalStorage": "7TB",
            "Price": 2246499,
            "StorageIops": 5,
            "RdsClassCode": "mssql.cluster.host.r6xlarge",
            "CpuFrequency": "2.5 GHz/3.2 GHz",
            "EcsClassCode": "ecs.r6.6xlarge",
            "EcsClass": "r6, memory optimized instance family"
        }
        
}

Error codes

HTTP status code Error code Error message Description
400 InvalidAction The specified action is not valid. The error message returned because the specified operation is invalid.

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