DescribeInstanceTypes
Queries the list of all instance types provided by Elastic Compute Service and retrieves the associated detailed information of the instance types. You can also perform a conditional query to obtain the information of specified instance types, which helps you understand the configurations and performance of different instance types and select the instance that best suits your business needs.
Operation description
-
Paged query: You can set the MaxResults parameter to limit the number of instance types returned in the response. If only a subset of the queried instance types is returned, the NextToken parameter is also returned. To implement paged queries, call this operation again and set the NextToken parameter to the value returned in the previous call, along with the MaxResults parameter.
-
If you do not specify the NextToken parameter for pagination when you call this operation, only the first page of data (up to 100 entries) is returned by default. To obtain more data, specify the NextToken parameter for pagination or specify filter conditions to limit the scope of the returned data.
The maximum value of the MaxResults (maximum number of entries per page) parameter is 100. For users who called this operation in 2022, the maximum value of the MaxResults parameter remains 1600. On and after November 15, 2023, the maximum value of the MaxResults parameter is reduced to 100 for all users, and 1600 is no longer supported.
-
DescribeInstanceTypes only queries the configuration and performance information of instance types. If you need to query the instance types available for purchase in a specific region, use DescribeAvailableResource.
-
If you need to use instance types that are not visible for sale or have special instance type requirements, submit a ticket.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceTypeFamily |
string |
No |
The instance family to which the instance type belongs. For valid values, see DescribeInstanceTypeFamilies. For more information about instance families, see Instance families. |
ecs.g6 |
| InstanceTypes |
array |
No |
The specified array of instance types. Array length: 1 to 10. If this parameter is not specified, the information of all instance types is queried by default. |
ecs.g6.large |
|
string |
No |
The instance type. |
ecs.g6.large |
|
| MinimumCpuCoreCount |
integer |
No |
The minimum expected number of vCPU cores when querying instance types. Valid values: positive integers. Note
If the number of vCPU cores of an instance type is less than the specified value, the system does not return the information of the instance type. |
2 |
| MaximumCpuCoreCount |
integer |
No |
The maximum expected number of vCPU cores when querying instance types. Valid values: positive integers. Note
If the number of vCPU cores of an instance type is greater than the specified value, the system does not return the information of the instance type. |
10 |
| MinimumMemorySize |
number |
No |
The minimum expected memory size when querying instance types. Unit: GiB. Note
If the memory size of an instance type is less than the specified value, the system does not return the information of the instance type. |
20 |
| MaximumMemorySize |
number |
No |
The maximum expected memory size when querying instance types. Unit: GiB. Note
If the memory size of an instance type is greater than the specified value, the system does not return the information of the instance type. |
60 |
| MinimumGPUAmount |
integer |
No |
The minimum expected number of GPUs when querying instance types. Valid values: positive integers. Note
If the number of GPUs of an instance type is less than the specified value, the system does not return the information of the instance type. |
3 |
| MaximumGPUAmount |
integer |
No |
The maximum expected number of GPUs when querying instance types. Valid values: positive integers. Note
If the number of GPUs of an instance type is greater than the specified value, the system does not return the information of the instance type. |
10 |
| GPUSpec |
string |
No |
The GPU type. Note
Fuzzy match is supported. For example, if the GPU type of an instance type is NVIDIA V100, you can enter NVIDIA to query the information of the instance type. |
NVIDIA V100 |
| InstanceCategory |
string |
No |
The instance type categorization. Valid values:
Valid values:
|
Big data |
| CpuArchitecture |
string |
No |
The CPU architecture. Valid values:
Valid values:
|
X86 |
| MinimumCpuSpeedFrequency |
number |
No |
The minimum expected clock speed when querying instance types. Note
If the clock speed of an instance type is less than the specified value, the system does not return the information of the instance type. |
2.5 |
| MaximumCpuSpeedFrequency |
number |
No |
The maximum expected clock speed when querying instance types. Note
If the clock speed of an instance type is greater than the specified value, the system does not return the information of the instance type. |
3.2 |
| MinimumCpuTurboFrequency |
number |
No |
The minimum expected turbo frequency when querying instance types. Note
If the turbo frequency of an instance type is less than the specified value, the system does not return the information of the instance type. |
3.2 |
| MaximumCpuTurboFrequency |
number |
No |
The maximum expected turbo frequency when querying instance types. Note
If the turbo frequency of an instance type is greater than the specified value, the system does not return the information of the instance type. |
4.1 |
| PhysicalProcessorModel |
string |
No |
The processor model. Note
Fuzzy match is supported. For example, if the processor model of an instance type is Intel Xeon(Ice Lake) Platinum 8369B, you can enter Intel to query the information of the instance type. |
Intel Xeon(Ice Lake) Platinum 8369B |
| InstanceFamilyLevel |
string |
No |
The instance family level. Valid values:
Valid values:
|
EntryLevel |
| MinimumInstancePpsRx |
integer |
No |
The minimum expected inbound internal network packet forwarding rate when querying instance types. Unit: pps. Note
If the inbound internal network packet forwarding rate of an instance type is less than the specified value, the system does not return the information of the instance type. |
15 |
| MinimumInstancePpsTx |
integer |
No |
The minimum expected outbound internal network packet forwarding rate when querying instance types. Unit: pps. Note
If the outbound internal network packet forwarding rate of an instance type is less than the specified value, the system does not return the information of the instance type. |
15 |
| MinimumInstanceBandwidthRx |
integer |
No |
The minimum expected inbound internal bandwidth limit when querying instance types. Unit: Kbit/s. Note
If the inbound internal bandwidth limit of an instance type is less than the specified value, the system does not return the information of the instance type. |
12288 |
| MinimumInstanceBandwidthTx |
integer |
No |
The minimum expected outbound internal bandwidth limit when querying instance types. Unit: Kbit/s. Note
If the outbound internal bandwidth limit of an instance type is less than the specified value, the system does not return the information of the instance type. |
12288 |
| MinimumPrimaryEniQueueNumber |
integer |
No |
The minimum expected default number of queues for the primary ENI when querying instance types. Note
If the default number of queues for the primary ENI of an instance type is less than the specified value, the system does not return the information of the instance type. |
8 |
| MinimumSecondaryEniQueueNumber |
integer |
No |
The minimum expected default number of queues for the secondary Elastic Network Interface (ENI) when querying instance types. Note
If the default number of queues for the secondary Elastic Network Interface (ENI) of an instance type is less than the specified value, the system does not return the information of the instance type. |
4 |
| MinimumEniQuantity |
integer |
No |
The minimum expected maximum number of Elastic Network Interfaces (ENIs) that can be attached when querying instance types. Note
If the maximum number of Elastic Network Interfaces (ENIs) that can be attached to an instance type is less than the specified value, the system does not return the information of the instance type. |
4 |
| MinimumQueuePairNumber |
integer |
No |
The minimum expected maximum number of Queue Pair (QP) queues for a single Elastic RDMA Interface (ERI) when querying instance types. Note
If the maximum number of QP queues for a single ERI of an instance type is less than the specified value, the system does not return the information of the instance type. |
8 |
| MinimumEriQuantity |
integer |
No |
The minimum expected number of Elastic RDMA Interfaces (ERIs) when querying instance types. Note
If the number of Elastic RDMA Interfaces (ERIs) of an instance type is less than the specified value, the system does not return the information of the instance type. |
0 |
| MinimumEniPrivateIpAddressQuantity |
integer |
No |
The minimum expected maximum number of IPv4 addresses for a single Elastic Network Interface (ENI) when querying instance types. Note
If the maximum number of IPv4 addresses for a single Elastic Network Interface (ENI) of an instance type is less than the specified value, the system does not return the information of the instance type. |
2 |
| MinimumEniIpv6AddressQuantity |
integer |
No |
The minimum expected maximum number of IPv6 addresses for a single Elastic Network Interface (ENI) when querying instance types. Note
If the maximum number of IPv6 addresses for a single Elastic Network Interface (ENI) of an instance type is less than the specified value, the system does not return the information of the instance type. |
2 |
| MinimumLocalStorageAmount |
integer |
No |
The minimum expected number of local disks attached to the instance when querying instance types. Note
If the number of local disks attached to an instance type is less than the specified value, the system does not return the information of the instance type. |
4 |
| MinimumLocalStorageCapacity |
integer |
No |
The capacity of a single local disk attached to the instance. Unit: GiB. |
40 |
| MinimumDiskQuantity |
integer |
No |
The minimum expected maximum number of disks that can be attached when querying instance types. Note
If the maximum number of disks that can be attached to an instance type is less than the specified value, the system does not return the information of the instance type. |
4 |
| LocalStorageCategory |
string |
No |
The local disk category. For more information, see Local disks. Valid values:
Valid values:
|
local_ssd_pro |
| NvmeSupport |
string |
No |
Specifies whether the disks attached to the instance type support NVMe. Valid values:
Valid values:
|
required |
| MinimumBaselineCredit |
integer |
No |
The minimum expected baseline vCPU computing performance (sum of all vCPUs) of the t5 and t6 burstable instances when querying instance types. Note
If the baseline vCPU computing performance (sum of all vCPUs) of the t5 and t6 burstable instances of an instance type is less than the specified value, the system does not return the information of the instance type. |
12 |
| MinimumInitialCredit |
integer |
No |
The minimum expected initial vCPU credits of the t5 and t6 burstable instances when querying instance types. Note
If the initial vCPU credits of the t5 and t6 burstable instances of an instance type is less than the specified value, the system does not return the information of the instance type. |
12 |
| InstanceTypeFamilies |
array |
No |
The specified array of instance families to query. Array length: 1 to 10. |
|
|
string |
No |
The instance family. |
["ecs.g6", "ecs.c6", … "ecs.r6"] |
|
| GpuSpecs |
array |
No |
The specified array of GPU types to query. Array length: 1 to 10. |
|
|
string |
No |
The specified GPU type to query. |
["NVIDIA V100", "NVIDIA T4", … "NVIDIA A10"] |
|
| InstanceCategories |
array |
No |
The specified array of instance type categorizations to query. Array length: 1 to 10. |
|
|
string |
No |
The specified instance type categorization to query. Valid values:
Valid values:
|
["General-purpose", "Compute-optimized", … "Enhanced"] |
|
| CpuArchitectures |
array |
No |
The specified array of CPU architectures to query. Array length: 1 to 2. |
|
|
string |
No |
The specified CPU architecture to query. Valid values:
Valid values:
|
["X86", "ARM"] |
|
| PhysicalProcessorModels |
array |
No |
The specified array of processor models to query. Array length: 1 to 10. |
|
|
string |
No |
The specified processor model to query. |
["Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY"] |
|
| LocalStorageCategories |
array |
No |
The specified array of local disk categories. Array length: 1 to 2. |
|
|
string |
No |
The specified local disk category to query. For more information, see Local disks. Valid values:
Valid values:
|
["local_hdd_pro", "local_ssd_pro"] |
|
| MaxResults |
integer |
No |
The maximum number of entries per page for a paged query. Maximum value: 1600. Default value: 1600. |
10 |
| NextToken |
string |
No |
The query token. Set the value to the NextToken value returned from the previous call to this operation. You do not need to specify this parameter for the first call. |
e71d8a535bd9cc11 |
| AdditionalAttributes |
array |
No |
The specified list of advanced features of the instance types to return. |
|
|
string |
No |
Other attribute values. Valid values of N: 1 to 20. Valid values:
|
NetworkInfo.BandwidthWeighting |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The list of instance type information. |
||
| InstanceTypes |
object |
||
| InstanceType |
array<object> |
The instance types. |
|
|
array<object> |
The instance types. |
||
| Attributes |
object |
||
| Attribute |
array<object> |
The list of instance type attributes. |
|
|
object |
The instance type attribute. |
||
| Name |
string |
The attribute name. |
VirtualIntelSpeedSelectTechnologySupport |
| Value |
string |
The attribute value. |
1 |
| BaselineCredit |
integer |
The baseline vCPU computing performance of t5 and t6 burstable instances (the sum of all vCPUs). |
4 |
| Clock |
object |
The clock supported by the instance type. |
|
| PtpSupport |
string |
Specifies whether Precision Time Protocol (PTP) is supported. Valid values:
|
unsupported |
| CpuArchitecture |
string |
The CPU architecture. Valid values:
|
X86 |
| CpuCoreCount |
integer |
The number of vCPU cores. |
4 |
| CpuOptions |
object |
The CPU options. |
|
| Core |
integer |
The number of CPU cores. |
2 |
| CoreFactor |
integer |
The CPU core factor. |
2 |
| HyperThreadingAdjustable |
boolean |
Specifies whether hyper-threading can be enabled or disabled. |
true |
| NestedVirtualizationSupport |
string |
Specifies whether nested virtualization is supported. |
|
| SupportedTopologyTypes |
object |
||
| SupportedTopologyType |
array |
The array of CPU topology types supported by the instance type. |
|
|
string |
The CPU topology type supported by the instance type. Valid values:
|
ContinuousCoreToHTMapping |
|
| ThreadsPerCore |
integer |
The number of threads per CPU core. Note
A value of CpuOptions.ThreadsPerCore=1 indicates that CPU hyper-threading is disabled. |
2 |
| CpuSpeedFrequency |
number |
The base CPU frequency. Unit: GHz. |
2.7 |
| CpuTurboFrequency |
number |
The CPU turbo frequency. Unit: GHz. |
3.5 |
| DiskQuantity |
integer |
The maximum number of disks that can be attached. |
17 |
| EnhancedNetwork |
object |
Note
This parameter is not available. |
|
| ExpressSupport |
boolean |
||
| RssSupport |
boolean |
Note
This parameter is not available. |
true |
| SriovSupport |
boolean |
Note
This parameter is not available. |
true |
| VfQueueNumberPerEni |
integer |
Note
This parameter is not available. |
5 |
| EniIpv6AddressQuantity |
integer |
The maximum number of IPv6 addresses per Elastic Network Interface (ENI). |
1 |
| EniPrivateIpAddressQuantity |
integer |
The maximum number of IPv4 addresses per Elastic Network Interface (ENI). |
10 |
| EniQuantity |
integer |
The maximum number of Elastic Network Interfaces (ENIs) that can be attached. |
3 |
| EniTotalQuantity |
integer |
The maximum number of all network interface controllers (NICs) that can be attached, including the primary network interface controller (NIC), Elastic Network Interfaces (ENIs), and trunk network interface controllers (NICs). Note
This parameter is in invitational preview and is not available. |
0 |
| EniTrunkSupported |
boolean |
Specifies whether the network interfaces attached to the instance type support trunking. Note
This parameter is in invitational preview and is not available. |
true |
| EriQuantity |
integer |
The number of Elastic RDMA Interfaces (ERIs). Note
This parameter is in invitational preview and is not available. |
0 |
| GPUAmount |
integer |
The number of GPUs. |
0 |
| GPUMemorySize |
number |
The GPU memory size per GPU for the instance type. Unit: GiB. |
32 |
| GPUSpec |
string |
The GPU type. |
NVIDIA V100 |
| InitialCredit |
integer |
The initial vCPU credits for t5 and t6 burstable instances. |
120 |
| InstanceBandwidthRx |
integer |
The maximum inbound internal bandwidth. Unit: Kbit/s. |
1024000 |
| InstanceBandwidthTx |
integer |
The maximum outbound internal bandwidth. Unit: Kbit/s. |
1024000 |
| InstanceCategory |
string |
The instance type categorization. Valid values:
|
Big data |
| InstanceFamilyLevel |
string |
The instance family level. Valid values:
|
EnterpriseLevel |
| InstancePpsRx |
integer |
The inbound packet forwarding rate over the internal network. Unit: pps. |
500000 |
| InstancePpsTx |
integer |
The outbound packet forwarding rate over the internal network. Unit: pps. |
500000 |
| InstanceTypeFamily |
string |
The instance family. |
ecs.g6 |
| InstanceTypeId |
string |
The instance type ID. |
ecs.g6.large |
| JumboFrameSupport |
boolean |
Specifies whether jumbo frames are supported. |
true |
| LocalStorageAmount |
integer |
The number of local disks attached to the instance. |
1 |
| LocalStorageCapacity |
integer |
The capacity of a single local disk attached to the instance. Unit: GiB. |
5000 |
| LocalStorageCategory |
string |
The local disk type. For more information, see Local disks. Valid values:
|
local_ssd_pro |
| MaximumQueueNumberPerEni |
integer |
The maximum number of queues per Elastic Network Interface (ENI), including the queues supported by the primary network interface controller (NIC) and secondary ENIs. |
4 |
| MemorySize |
number |
The memory size. Unit: GiB. |
16 |
| NetworkCardQuantity |
integer |
The number of physical network cards supported by the instance type. |
1 |
| NetworkCards |
object |
||
| NetworkCardInfo |
array<object> |
The list of physical network card information. |
|
|
object |
The physical network card information. |
||
| NetworkCardIndex |
integer |
The physical network card index. |
1 |
| NetworkEncryptionSupport |
boolean |
Specifies whether the instance supports VPC network traffic encryption. Valid values:
Note
This parameter is in invitational preview and is not available. |
true |
| NetworkInfo |
object |
The network-related information. |
|
| BandwidthWeighting |
object |
The bandwidth weights supported by the instance type. |
|
| WeightingInfos |
object |
||
| WeightingInfo |
array<object> |
The bandwidth weight information. This field is returned only when NetworkInfo.BandwidthWeighting is specified in the AdditionalAttributes request parameter. |
|
|
object |
|||
| EbsBandwidth |
integer |
The baseline storage bandwidth. Unit: Kbit/s. |
10000000 |
| EbsBurstBandwidth |
integer |
The burstable storage bandwidth. This field is not returned if the instance type does not support storage performance bursts. Unit: Kbit/s. |
20000000 |
| Name |
string |
The bandwidth weight name. |
Default |
| VpcBandwidth |
integer |
The baseline network bandwidth. Unit: Kbit/s. |
20480000 |
| VpcBurstBandwidth |
integer |
The burstable network bandwidth. This field is not returned if the instance type does not support network performance bursts. Unit: Kbit/s. |
25600000 |
| NvmeSupport |
string |
Specifies whether the disks attached to the instance type support NVMe. Valid values:
|
unsupported |
| PhysicalProcessorModel |
string |
The processor model. |
Intel Xeon(Ice Lake) Platinum 8369B |
| PrimaryEniQueueNumber |
integer |
The default number of queues for the primary network interface. |
4 |
| QueuePairNumber |
integer |
The maximum number of Queue Pairs (QPs) for all Elastic RDMA Interfaces (ERIs) of the instance. The limit depends on the instance type:
|
22 |
| SecondaryEniQueueNumber |
integer |
The default number of queues for the secondary Elastic Network Interface (ENI). |
4 |
| SecurityOptions |
object |
||
| SecureBootSupport |
string |
Specifies whether the instance type supports secure boot. Valid values:
|
unsupported |
| SupportedBootModes |
object |
||
| SupportedBootMode |
array |
The boot modes supported by the instance type. |
|
|
string |
The boot mode. Valid values:
|
BIOS |
|
| TotalEniQueueQuantity |
integer |
The total quota of Elastic Network Interface (ENI) queues that can be modified for the instance type. |
12 |
| NextToken |
string |
The query token returned by this call. |
e71d8a535bd9cc11 |
| RequestId |
string |
The request ID. |
00827261-20B7-4562-83F2-4DF39876A45A |
Examples
Success response
JSON format
{
"InstanceTypes": {
"InstanceType": [
{
"Attributes": {
"Attribute": [
{
"Name": "VirtualIntelSpeedSelectTechnologySupport",
"Value": "1"
}
]
},
"BaselineCredit": 4,
"Clock": {
"PtpSupport": "unsupported"
},
"CpuArchitecture": "X86",
"CpuCoreCount": 4,
"CpuOptions": {
"Core": 2,
"CoreFactor": 2,
"HyperThreadingAdjustable": true,
"NestedVirtualizationSupport": "",
"SupportedTopologyTypes": {
"SupportedTopologyType": [
"ContinuousCoreToHTMapping"
]
},
"ThreadsPerCore": 2
},
"CpuSpeedFrequency": 2.7,
"CpuTurboFrequency": 3.5,
"DiskQuantity": 17,
"EnhancedNetwork": {
"ExpressSupport": false,
"RssSupport": true,
"SriovSupport": true,
"VfQueueNumberPerEni": 5
},
"EniIpv6AddressQuantity": 1,
"EniPrivateIpAddressQuantity": 10,
"EniQuantity": 3,
"EniTotalQuantity": 0,
"EniTrunkSupported": true,
"EriQuantity": 0,
"GPUAmount": 0,
"GPUMemorySize": 32,
"GPUSpec": "NVIDIA V100",
"InitialCredit": 120,
"InstanceBandwidthRx": 1024000,
"InstanceBandwidthTx": 1024000,
"InstanceCategory": "Big data",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstancePpsRx": 500000,
"InstancePpsTx": 500000,
"InstanceTypeFamily": "ecs.g6",
"InstanceTypeId": "ecs.g6.large",
"JumboFrameSupport": true,
"LocalStorageAmount": 1,
"LocalStorageCapacity": 5000,
"LocalStorageCategory": "local_ssd_pro",
"MaximumQueueNumberPerEni": 4,
"MemorySize": 16,
"NetworkCardQuantity": 1,
"NetworkCards": {
"NetworkCardInfo": [
{
"NetworkCardIndex": 1
}
]
},
"NetworkEncryptionSupport": true,
"NetworkInfo": {
"BandwidthWeighting": {
"WeightingInfos": {
"WeightingInfo": [
{
"EbsBandwidth": 10000000,
"EbsBurstBandwidth": 20000000,
"Name": "Default",
"VpcBandwidth": 20480000,
"VpcBurstBandwidth": 25600000
}
]
}
}
},
"NvmeSupport": "unsupported",
"PhysicalProcessorModel": "Intel Xeon(Ice Lake) Platinum 8369B",
"PrimaryEniQueueNumber": 4,
"QueuePairNumber": 22,
"SecondaryEniQueueNumber": 4,
"SecurityOptions": {
"SecureBootSupport": "unsupported"
},
"SupportedBootModes": {
"SupportedBootMode": [
"BIOS"
]
},
"TotalEniQueueQuantity": 12
}
]
},
"NextToken": "e71d8a535bd9cc11",
"RequestId": "00827261-20B7-4562-83F2-4DF39876A45A"
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.