You can call this operation to query the instance types provided by ECS.
Description
The DescribeInstanceTypes operation is only used to query the configurations and performance of instance types. To query instance types that are available in a region, call the DescribeAvailableResource operation.
To use more instance types, submit a ticket to contact Alibaba Cloud.
Debugging
Request parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| Action | String | No | DescribeInstanceTypes |
The operation that you want to perform. For API requests using the HTTP or HTTPS methods,
the |
| InstanceTypeFamily | String | No | ecs.g6 |
The instance family to which the instance type belongs. For more information about valid values, see DescribeInstanceTypeFamilies. For more information, see Instance families. |
Response parameters
| Parameter | Type | Example | Description |
|---|---|---|---|
| InstanceTypes | Array |
The collection of instance types. |
|
| InstanceType | |||
| BaselineCredit | Integer | 4 |
The baseline vCPU computing performance (overall performance of all vCPUs) of the t5 or t6 burstable instance family. |
| CpuCoreCount | Integer | 8 |
The number of vCPUs. |
| EniIpv6AddressQuantity | Integer | 1 |
The maximum number of IPv6 addresses for a single Elastic Network Interface (ENI). |
| EniPrivateIpAddressQuantity | Integer | 6 |
The maximum number of private IP addresses for a single ENI. |
| EniQuantity | Integer | 2 |
The maximum number of ENIs that can be attached to an instance. |
| GPUAmount | Integer | 2 |
The number of GPUs. |
| GPUSpec | String | NVIDIA V100 |
The GPU type. |
| InitialCredit | Integer | 120 |
The initial vCPU credit value of the t5 or t6 burstable instance family. |
| InstanceBandwidthRx | Integer | 1024000 |
The maximum inbound bandwidth of the internal network for the instance. Unit: Kbit/s. |
| InstanceBandwidthTx | Integer | 1024000 |
The maximum outbound bandwidth of the internal network for the instance. Unit: Kbit/s. |
| InstanceFamilyLevel | String | EnterpriseLevel |
The level of the instance family. Valid values:
|
| InstancePpsRx | Long | 300000 |
The inbound packet forwarding rate of the internal network. Unit: pps. |
| InstancePpsTx | Long | 300000 |
The outbound packet forwarding rate of the internal network. Unit: pps. |
| InstanceTypeFamily | String | ecs.g5 |
The instance family. |
| InstanceTypeId | String | ecs.g5.large |
The ID of the instance type. |
| LocalStorageAmount | Integer | 1 |
The number of local disks attached to the instance. |
| LocalStorageCapacity | Long | 5000 |
The capacity of each local disk attached to the instance. Unit: GiB. |
| LocalStorageCategory | String | local_ssd_pro |
The category of the local disk. For more information, see Local disks. Valid values:
|
| MemorySize | Float | 8.0 |
The memory size. Unit: GiB. |
| RequestId | String | 00827261-20B7-4562-83F2-4DF39876A45A |
The ID of the request. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=DescribeInstanceTypes
&InstanceTypeFamily=ecs.g6
&<Common request parameters>Sample success responses
XML format
<DescribeInstanceTypesResponse>
<RequestId>00827261-20B7-4562-83F2-4DF39876A45A</RequestId>
<InstanceTypes>
<InstanceType>
<MemorySize>384</MemorySize>
<InstancePpsTx>6000000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>104</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>6000000</InstancePpsRx>
<EniQuantity>15</EniQuantity>
<InstanceBandwidthRx>25600000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>25600000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.26xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>192</MemorySize>
<InstancePpsTx>3000000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>52</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>3000000</InstancePpsRx>
<EniQuantity>7</EniQuantity>
<InstanceBandwidthRx>12800000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>12800000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.13xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>256</MemorySize>
<InstancePpsTx>4000000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>64</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>4000000</InstancePpsRx>
<EniQuantity>8</EniQuantity>
<InstanceBandwidthRx>20480000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>20480000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.16xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>32</MemorySize>
<InstancePpsTx>800000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>8</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>800000</InstancePpsRx>
<EniQuantity>4</EniQuantity>
<InstanceBandwidthRx>2560000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>2560000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.2xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>8</MemorySize>
<InstancePpsTx>300000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>2</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>300000</InstancePpsRx>
<EniQuantity>2</EniQuantity>
<InstanceBandwidthRx>1024000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>1024000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.large</InstanceTypeId>
<EniPrivateIpAddressQuantity>6</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>16</MemorySize>
<InstancePpsTx>500000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>4</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>500000</InstancePpsRx>
<EniQuantity>3</EniQuantity>
<InstanceBandwidthRx>1536000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>1536000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>48</MemorySize>
<InstancePpsTx>900000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>12</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>900000</InstancePpsRx>
<EniQuantity>6</EniQuantity>
<InstanceBandwidthRx>4096000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>4096000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.3xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>64</MemorySize>
<InstancePpsTx>1000000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>16</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>1000000</InstancePpsRx>
<EniQuantity>8</EniQuantity>
<InstanceBandwidthRx>5120000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>5120000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.4xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>96</MemorySize>
<InstancePpsTx>1500000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>24</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>1500000</InstancePpsRx>
<EniQuantity>8</EniQuantity>
<InstanceBandwidthRx>7680000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>7680000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.6xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
</InstanceType>
<InstanceType>
<MemorySize>128</MemorySize>
<InstancePpsTx>2000000</InstancePpsTx>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<CpuCoreCount>32</CpuCoreCount>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>2000000</InstancePpsRx>
<EniQuantity>8</EniQuantity>
<InstanceBandwidthRx>10240000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>10240000</InstanceBandwidthTx>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.8xlarge</InstanceTypeId>
<EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
</InstanceType>
</InstanceTypes>
</DescribeInstanceTypesResponse>JSON format
{
"RequestId": "00827261-20B7-4562-83F2-4DF39876A45A",
"InstanceTypes": {
"InstanceType": [
{
"MemorySize": 384,
"InstancePpsTx": 6000000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 104,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 6000000,
"EniQuantity": 15,
"InstanceBandwidthRx": 25600000,
"GPUAmount": 0,
"InstanceBandwidthTx": 25600000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.26xlarge",
"EniPrivateIpAddressQuantity": 20
},
{
"MemorySize": 192,
"InstancePpsTx": 3000000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 52,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 3000000,
"EniQuantity": 7,
"InstanceBandwidthRx": 12800000,
"GPUAmount": 0,
"InstanceBandwidthTx": 12800000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.13xlarge",
"EniPrivateIpAddressQuantity": 20
},
{
"MemorySize": 256,
"InstancePpsTx": 4000000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 64,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 4000000,
"EniQuantity": 8,
"InstanceBandwidthRx": 20480000,
"GPUAmount": 0,
"InstanceBandwidthTx": 20480000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.16xlarge",
"EniPrivateIpAddressQuantity": 20
},
{
"MemorySize": 32,
"InstancePpsTx": 800000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 8,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 800000,
"EniQuantity": 4,
"InstanceBandwidthRx": 2560000,
"GPUAmount": 0,
"InstanceBandwidthTx": 2560000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.2xlarge",
"EniPrivateIpAddressQuantity": 10
},
{
"MemorySize": 8,
"InstancePpsTx": 300000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 2,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 300000,
"EniQuantity": 2,
"InstanceBandwidthRx": 1024000,
"GPUAmount": 0,
"InstanceBandwidthTx": 1024000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.large",
"EniPrivateIpAddressQuantity": 6
},
{
"MemorySize": 16,
"InstancePpsTx": 500000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 4,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 500000,
"EniQuantity": 3,
"InstanceBandwidthRx": 1536000,
"GPUAmount": 0,
"InstanceBandwidthTx": 1536000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.xlarge",
"EniPrivateIpAddressQuantity": 10
},
{
"MemorySize": 48,
"InstancePpsTx": 900000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 12,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 900000,
"EniQuantity": 6,
"InstanceBandwidthRx": 4096000,
"GPUAmount": 0,
"InstanceBandwidthTx": 4096000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.3xlarge",
"EniPrivateIpAddressQuantity": 10
},
{
"MemorySize": 64,
"InstancePpsTx": 1000000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 16,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 1000000,
"EniQuantity": 8,
"InstanceBandwidthRx": 5120000,
"GPUAmount": 0,
"InstanceBandwidthTx": 5120000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.4xlarge",
"EniPrivateIpAddressQuantity": 20
},
{
"MemorySize": 96,
"InstancePpsTx": 1500000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 24,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 1500000,
"EniQuantity": 8,
"InstanceBandwidthRx": 7680000,
"GPUAmount": 0,
"InstanceBandwidthTx": 7680000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.6xlarge",
"EniPrivateIpAddressQuantity": 20
},
{
"MemorySize": 128,
"InstancePpsTx": 2000000,
"EniIpv6AddressQuantity": 1,
"CpuCoreCount": 32,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 2000000,
"EniQuantity": 8,
"InstanceBandwidthRx": 10240000,
"GPUAmount": 0,
"InstanceBandwidthTx": 10240000,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.8xlarge",
"EniPrivateIpAddressQuantity": 20
}
]
}
}Error codes
For a list of error codes, visit the API Error Center.