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

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 DescribeInstanceTypes

The operation that you want to perform. For API requests using the HTTP or HTTPS methods, the Action parameter is required. Set the value to DescribeInstanceTypes.

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:

  • local_hdd_pro: local SATA HDDs attached to instances of the d1ne and d1 instance families.
  • local_ssd_pro: local NVMe SSDs attached to instances of the i2, i2g, i1, ga1, and gn5 instance families.
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.