DocsICP FilingConsole
官方文档
首页

DescribeInstanceTypes

更新时间：
复制 MD 格式
产品详情
我的收藏

This API returns detailed information for all available ECS instance types. You can also filter for specific instance types to compare their configurations and performance and select the one that best meets your business requirements.

Operation description

  • Pagination: Set the MaxResults parameter to limit the number of instance types returned per response. If more results are available, the response includes a NextToken. To retrieve the next page, pass this NextToken in your subsequent request.

  • By default, requests without a NextToken return only the first page of results (up to 100 entries). To retrieve more data, you must pass the NextToken from the previous response or apply filters to narrow the results.

Note

The maximum value for the MaxResults parameter is 100. As an exception for users who called this API in 2022, the maximum value remains 1600. Effective November 15, 2023, this exception will end, and the maximum value for all users will be 100.

  • The DescribeInstanceTypes operation returns only the configurations and performance details of instance types. To query for instance types that are available for purchase in a specific region, use the DescribeAvailableResource operation.

  • If you require an instance type that is not publicly available or have special requirements, submit a ticket.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example
InstanceTypeFamily

string

No

The instance type family. For valid values, call the DescribeInstanceTypeFamilies operation.

For more information about instance type families, see Instance type families.

ecs.g6
InstanceTypes

array

No

An array of 1 to 10 instance types. If you do not specify this parameter, the operation returns information about all instance types.

ecs.g6.large

string

No

The instance type.

ecs.g6.large
MinimumCpuCoreCount

integer

No

The minimum number of vCPU cores for the instance type. The value must be a positive integer.

Note

The response excludes instance types with fewer vCPU cores than this value.

2
MaximumCpuCoreCount

integer

No

The maximum number of vCPU cores for the instance type. The value must be a positive integer.

Note

The response excludes instance types with more vCPU cores than this value.

10
MinimumMemorySize

number

No

The minimum memory size for the instance type. Unit: GiB.

Note

The response excludes instance types with a smaller memory size than this value.

20
MaximumMemorySize

number

No

The maximum memory size for the instance type. Unit: GiB.

Note

The response excludes instance types with a larger memory size than this value.

60
MinimumGPUAmount

integer

No

The minimum number of GPUs. The value must be a positive integer.

Note

The response excludes instance types with fewer GPUs than this value.

3
MaximumGPUAmount

integer

No

The maximum number of GPUs. The value must be a positive integer.

Note

The response excludes instance types with more GPUs than this value.

10
GPUSpec

string

No

The GPU type.

Note

This parameter supports fuzzy search. For example, specifying NVIDIA returns instance types with NVIDIA V100 GPUs.

NVIDIA V100
InstanceCategory

string

No

The instance category. Valid values:

  • General-purpose

  • Compute-optimized

  • Memory-optimized

  • Big data

  • Local SSDs

  • High clock speed

  • Enhanced

  • Shared

  • Compute-optimized with GPU

  • Visual Compute-optimized

  • Heterogeneous service

  • Compute-optimized with FPGA

  • Compute-optimized with NPU

  • ECS Bare Metal

  • Super Computing Cluster

  • High performance compute

Big data
CpuArchitecture

string

No

The CPU architecture. Valid values:

  • X86

  • ARM

X86
MinimumCpuSpeedFrequency

number

No

The minimum clock speed.

Note

The response excludes instance types with a clock speed lower than this value.

2.5
MaximumCpuSpeedFrequency

number

No

The maximum clock speed.

Note

The response excludes instance types with a clock speed higher than this value.

3.2
MinimumCpuTurboFrequency

number

No

The minimum turbo frequency.

Note

The response excludes instance types with a turbo frequency lower than this value.

3.2
MaximumCpuTurboFrequency

number

No

The maximum turbo frequency.

Note

The response excludes instance types with a turbo frequency higher than this value.

4.1
PhysicalProcessorModel

string

No

The processor model.

Note

This parameter supports fuzzy search. For example, specifying Intel returns instance types with Intel Xeon(Ice Lake) Platinum 8369B processors.

Intel Xeon(Ice Lake) Platinum 8369B
InstanceFamilyLevel

string

No

The instance family level. Valid values:

  • EntryLevel: Entry-level (shared).

  • EnterpriseLevel: Enterprise-level.

  • CreditEntryLevel: Credit-based entry-level.

EntryLevel
MinimumInstancePpsRx

integer

No

The minimum inbound packet rate over the internal network. Unit: pps.

Note

The response excludes instance types that have a lower inbound packet rate over the internal network than this value.

15
MinimumInstancePpsTx

integer

No

The minimum outbound packet rate over the internal network. Unit: pps.

Note

The response excludes instance types that have a lower outbound packet rate over the internal network than this value.

15
MinimumInstanceBandwidthRx

integer

No

The minimum inbound bandwidth over the internal network. Unit: kbit/s.

Note

The response excludes instance types that have a lower inbound bandwidth limit over the internal network than this value.

12288
MinimumInstanceBandwidthTx

integer

No

The minimum outbound bandwidth over the internal network. Unit: kbit/s.

Note

The response excludes instance types that have a lower outbound bandwidth limit over the internal network than this value.

12288
MinimumPrimaryEniQueueNumber

integer

No

The minimum number of queues supported by the primary elastic network interface.

Note

The response excludes instance types that support fewer queues for the primary elastic network interface than this value.

8
MinimumSecondaryEniQueueNumber

integer

No

The minimum number of queues supported by a secondary elastic network interface.

Note

The response excludes instance types that support fewer queues for a secondary elastic network interface than this value.

4
MinimumEniQuantity

integer

No

The minimum value for the maximum number of elastic network interfaces (ENIs) that can be attached to the instance type.

Note

The response excludes instance types that support fewer ENIs than this value.

4
MinimumQueuePairNumber

integer

No

The minimum value for the maximum number of queue pairs (QPs) supported by a single Elastic RDMA Interface (ERI).

Note

The response excludes instance types whose ERIs support fewer queue pairs than this value.

8
MinimumEriQuantity

integer

No

The minimum number of Elastic RDMA Interfaces (ERIs).

Note

The response excludes instance types that support fewer ERIs than this value.

0
MinimumEniPrivateIpAddressQuantity

integer

No

The minimum value for the maximum number of IPv4 addresses that can be assigned to a single elastic network interface.

Note

The response excludes instance types whose ENIs support fewer assignable IPv4 addresses than this value.

2
MinimumEniIpv6AddressQuantity

integer

No

The minimum value for the maximum number of IPv6 addresses that can be assigned to a single elastic network interface.

Note

The response excludes instance types whose ENIs support fewer assignable IPv6 addresses than this value.

2
MinimumLocalStorageAmount

integer

No

The minimum number of local disks available on the instance type.

Note

The response excludes instance types that support fewer local disks than this value.

4
MinimumLocalStorageCapacity

integer

No

The minimum capacity of a single local disk, in GiB. The response excludes instance types whose local disks have a capacity smaller than this value.

40
MinimumDiskQuantity

integer

No

The minimum value for the maximum number of cloud disks that can be attached to the instance type.

Note

The response excludes instance types that support fewer attachable cloud disks than this value.

4
LocalStorageCategory

string

No

The category of local disks. For more information, see Local disks. Valid values:

  • local_hdd_pro: SATA HDD local disks, supported by d1ne and d1 instance types.

  • local_ssd_pro: NVMe SSD local disks, supported by i2, i2g, i1, ga1, and gn5 instance types.

local_ssd_pro
NvmeSupport

string

No

Specifies whether cloud disks attached to the instance type support NVMe. Valid values:

  • required: Cloud disks are attached using the NVMe protocol.

  • unsupported: Cloud disks are attached without using the NVMe protocol.

required
MinimumBaselineCredit

integer

No

The minimum baseline vCPU performance of a t5 or t6 burstable performance instance. This value is the sum of the baseline performance of all vCPUs.

Note

The response excludes instance types with a baseline vCPU performance lower than this value.

12
MinimumInitialCredit

integer

No

The minimum initial vCPU credits of a t5 or t6 burstable performance instance.

Note

The response excludes instance types with fewer initial vCPU credits than this value.

12
InstanceTypeFamilies

array

No

An array of 1 to 10 instance type families.

string

No

The instance type family.

["ecs.g6", "ecs.c6", … "ecs.r6"]
GpuSpecs

array

No

An array of 1 to 10 GPU types.

string

No

The GPU type.

["NVIDIA V100", "NVIDIA T4", … "NVIDIA A10"]
InstanceCategories

array

No

An array of 1 to 10 instance categories.

string

No

The instance category. Valid values:

  • General-purpose

  • Compute-optimized

  • Memory-optimized

  • Big data

  • Local SSDs

  • High clock speed

  • Enhanced

  • Shared

  • Compute-optimized with GPU

  • Visual Compute-optimized

  • Heterogeneous service

  • Compute-optimized with FPGA

  • Compute-optimized with NPU

  • ECS Bare Metal

  • Super Computing Cluster

  • High performance compute

["General-purpose", "Compute-optimized", … "Enhanced"]
CpuArchitectures

array

No

An array of 1 to 2 CPU architectures.

string

No

The CPU architecture. Valid values:

  • X86

  • ARM

["X86", "ARM"]
PhysicalProcessorModels

array

No

An array of 1 to 10 processor models.

string

No

The processor model.

["Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY"]
LocalStorageCategories

array

No

An array of 1 to 2 local disk categories.

string

No

The category of local disks. For more information, see Local disks. Valid values:

  • local_hdd_pro: SATA HDD local disks, supported by d1ne and d1 instance types.

  • local_ssd_pro: NVMe SSD local disks, supported by i2, i2g, i1, ga1, and gn5 instance types.

["local_hdd_pro", "local_ssd_pro"]
MaxResults

integer

No

The maximum number of entries to return on each page. Maximum value: 1600.

Default value: 1600.

10
NextToken

string

No

The token used to retrieve the next page of results. You do not need to set this parameter for the first request. For subsequent requests, set this to the NextToken value from the previous response.

e71d8a535bd9cc11
AdditionalAttributes

array

No

The advanced attributes of the instance type to return.

string

No

You can specify 1 to 20 advanced attributes. Valid values:

  • NetworkInfo.BandwidthWeighting: The network and storage bandwidth performance weight of the instance type.

NetworkInfo.BandwidthWeighting

Response elements

Element

Type

Description

Example

object

The details of the queried instance types.

RequestId

string

The request ID.

00827261-20B7-4562-83F2-4DF39876A45A
InstanceTypes

object

A collection of instance types.

InstanceType

array<object>

An array of instance types.

array<object>

The details of an instance type.

EniTotalQuantity

integer

The maximum number of network interfaces that can be attached to an instance. This total includes the primary network interface, elastic network interfaces (ENIs), and trunk network interfaces.

Note

This parameter is in invitation-only preview and is not yet available.

0
LocalStorageCategory

string

The local disk category. For more information, see Local disks. Valid values:

  • local_hdd_pro: SATA HDD local disks for d1ne and d1 instance type families.

  • local_ssd_pro: NVMe SSD local disks for instance type families such as i2, i2g, i1, ga1, and gn5.

local_ssd_pro
PrimaryEniQueueNumber

integer

The default number of queues for the primary network interface.

4
MemorySize

number

The memory size. Unit: GiB.

16
LocalStorageCapacity

integer

The capacity of a single local disk. Unit: GiB.

5000
InstanceFamilyLevel

string

The instance type family level. Valid values:

  • EntryLevel: entry-level (shared).

  • EnterpriseLevel: enterprise-level.

  • CreditEntryLevel: credit-based entry-level. For more information, see burstable performance instances.

EnterpriseLevel
InstancePpsRx

integer

The maximum inbound internal network rate. Unit: packets per second (pps).

500000
EniIpv6AddressQuantity

integer

The maximum number of IPv6 addresses that can be assigned to an elastic network interface.

1
MaximumQueueNumberPerEni

integer

The maximum number of queues per network interface. This applies to the primary network interface and secondary elastic network interfaces.

4
InstanceTypeId

string

The instance type ID.

ecs.g6.large
InstanceBandwidthRx

integer

The maximum inbound internal bandwidth. Unit: kbit/s.

1024000
SecondaryEniQueueNumber

integer

The default number of queues for a secondary elastic network interface.

4
GPUSpec

string

The GPU type.

NVIDIA V100
InstanceBandwidthTx

integer

The maximum outbound internal bandwidth. Unit: kbit/s.

1024000
QueuePairNumber

integer

The base number of Queue Pairs (QPs) for calculating the total QP capacity of an instance. The calculation method varies based on the instance type:

  • For enterprise-level CPU instances, the maximum number of QPs is the value of the QueuePairNumber parameter.

  • For GPU instances, the maximum number of QPs is calculated as QueuePairNumber × NetworkCardQuantity.

22
EriQuantity

integer

The number of Elastic RDMA Interfaces (ERIs).

Note

This parameter is in invitation-only preview and is not yet available.

0
GPUAmount

integer

The number of GPUs.

0
TotalEniQueueQuantity

integer

The total number of queues for elastic network interfaces that can be modified for the instance type.

12
NvmeSupport

string

Indicates whether cloud disks attached to an instance of this type support NVMe. Valid values:

  • required: Supported. The cloud disk is attached as an NVMe device.

  • unsupported: Not supported. The cloud disk is not attached as an NVMe device.

unsupported
DiskQuantity

integer

The maximum number of cloud disks that can be attached to an instance.

17
InitialCredit

integer

The initial vCPU credits for a t5 or t6 burstable performance instance.

120
LocalStorageAmount

integer

The number of local disks attached to an instance.

1
BaselineCredit

integer

The baseline vCPU performance for a t5 or t6 burstable performance instance.

4
InstancePpsTx

integer

The maximum outbound internal network rate. Unit: packets per second (pps).

500000
EniPrivateIpAddressQuantity

integer

The maximum number of private IPv4 addresses that can be assigned to an elastic network interface.

10
CpuCoreCount

integer

The number of vCPUs. This is calculated as the number of CPU cores multiplied by the number of threads per core.

4
InstanceTypeFamily

string

The instance type family.

ecs.g6
EniQuantity

integer

The maximum number of secondary elastic network interfaces that can be attached to an instance.

3
EniTrunkSupported

boolean

Indicates whether network interfaces attached to an instance of this type support trunking.

Note

This parameter is in invitation-only preview and is not yet available.

true
CpuSpeedFrequency

number

The CPU base frequency. Unit: GHz.

2.7
CpuTurboFrequency

number

The CPU turbo frequency. Unit: GHz.

3.5
PhysicalProcessorModel

string

The processor model.

Intel Xeon(Ice Lake) Platinum 8369B
NetworkEncryptionSupport

boolean

Indicates whether an instance of this type supports VPC network traffic encryption. Valid values:

  • true: The instance supports VPC network traffic encryption.

  • false: The instance does not support VPC network traffic encryption.

Note

This parameter is in invitation-only preview and is not yet available.

true
InstanceCategory

string

The instance type category. Valid values:

  • General-purpose: general-purpose

  • Compute-optimized: compute-optimized

  • Memory-optimized: memory-optimized

  • Big data: big data

  • Local SSDs: local SSDs

  • High Clock Speed: high clock speed

  • Enhanced: enhanced

  • Shared: shared

  • Compute-optimized with GPU: compute-optimized with GPU

  • Visual Compute-optimized: visual compute-optimized

  • Heterogeneous Service: heterogeneous service

  • Compute-optimized with FPGA: compute-optimized with FPGA

  • Compute-optimized with NPU: compute-optimized with NPU

  • ECS Bare Metal: ECS Bare Metal

  • Super Computing Cluster: super computing cluster

  • High Performance Compute: high-performance compute

Big data
CpuArchitecture

string

The CPU architecture. Valid values:

  • X86

  • ARM

X86
GPUMemorySize

number

The memory size of each GPU. Unit: GiB.

32
NetworkCardQuantity

integer

The number of physical network cards on an instance of this type.

1
NetworkCards

object

The information about the physical network cards.

NetworkCardInfo

array<object>

An array of physical network card details.

object

The details of a physical network card.

NetworkCardIndex

integer

The index of the physical network card.

1
SupportedBootModes

object

The boot modes supported by the instance type.

SupportedBootMode

array

An array of supported boot modes.

string

The boot mode. Valid values:

  • BIOS: Only the BIOS boot mode is supported.

  • UEFI: Only the UEFI boot mode is supported.

  • BIOS,UEFI: Both BIOS and UEFI boot modes are supported.

BIOS
EnhancedNetwork

object
Note

This parameter is not yet available.

SriovSupport

boolean
Note

This parameter is not yet available.

true
VfQueueNumberPerEni

integer
Note

This parameter is not yet available.

5
RssSupport

boolean
Note

This parameter is not yet available.

true
CpuOptions

object

The CPU options.

SupportedTopologyTypes

object

The supported CPU topology types.

SupportedTopologyType

array

An array of CPU topology types supported by the instance type.

string

The CPU topology type supported by the instance type. Valid values:

  • ContinuousCoreToHTMapping: The Hyper-Threading (HT) threads of the same core are contiguous.

  • DiscreteCoreToHTMapping: The Hyper-Threading (HT) threads of the same core are discrete.

ContinuousCoreToHTMapping
ThreadsPerCore

integer

The number of threads per CPU core.

Note

CpuOptions.ThreadsPerCore=1 indicates that Hyper-Threading is disabled.

2
Core

integer

The number of CPU cores.

2
CoreFactor

integer

The step size for CPU options.

2
HyperThreadingAdjustable

boolean

Indicates whether Hyper-Threading can be enabled or disabled.

true
NestedVirtualizationSupport

string

JumboFrameSupport

boolean

Indicates whether an instance of this type supports jumbo frames.

true
Clock

object

The clock sources supported by the instance type.

PtpSupport

string

Indicates whether an instance of this type supports Precision Time Protocol (PTP). Valid values:

  • supported: Supported.

  • unsupported: Not supported.

unsupported
Attributes

object

The attributes of the instance type.

Attribute

array<object>

An array of instance type attributes.

object

An instance type attribute.

Name

string

The attribute name.

VirtualIntelSpeedSelectTechnologySupport
Value

string

The attribute value.

1
NetworkInfo

object

The network information.

BandwidthWeighting

object

The bandwidth weighting supported by the instance type.

WeightingInfos

object

A collection of bandwidth weighting information.

WeightingInfo

array<object>

The bandwidth weighting information. This parameter is returned only when NetworkInfo.BandwidthWeighting is specified in the AdditionalAttributes request parameter.

object

The details of a bandwidth weighting configuration.

Name

string

The name of the bandwidth weighting.

Default
VpcBandwidth

integer

The base network bandwidth. Unit: kbit/s.

20480000
VpcBurstBandwidth

integer

The burst network bandwidth. This parameter is not returned if the instance type does not support burstable network performance. Unit: kbit/s.

25600000
EbsBandwidth

integer

The base storage bandwidth. Unit: kbit/s.

10000000
EbsBurstBandwidth

integer

The burst storage bandwidth. This parameter is not returned if the instance type does not support burstable storage performance. Unit: kbit/s.

20000000
NextToken

string

The token used to retrieve the next page of results.

e71d8a535bd9cc11

Examples

Success response

JSON format

{
  "RequestId": "00827261-20B7-4562-83F2-4DF39876A45A",
  "InstanceTypes": {
    "InstanceType": [
      {
        "EniTotalQuantity": 0,
        "LocalStorageCategory": "local_ssd_pro",
        "PrimaryEniQueueNumber": 4,
        "MemorySize": 16,
        "LocalStorageCapacity": 5000,
        "InstanceFamilyLevel": "EnterpriseLevel",
        "InstancePpsRx": 500000,
        "EniIpv6AddressQuantity": 1,
        "MaximumQueueNumberPerEni": 4,
        "InstanceTypeId": "ecs.g6.large",
        "InstanceBandwidthRx": 1024000,
        "SecondaryEniQueueNumber": 4,
        "GPUSpec": "NVIDIA V100",
        "InstanceBandwidthTx": 1024000,
        "QueuePairNumber": 22,
        "EriQuantity": 0,
        "GPUAmount": 0,
        "TotalEniQueueQuantity": 12,
        "NvmeSupport": "unsupported",
        "DiskQuantity": 17,
        "InitialCredit": 120,
        "LocalStorageAmount": 1,
        "BaselineCredit": 4,
        "InstancePpsTx": 500000,
        "EniPrivateIpAddressQuantity": 10,
        "CpuCoreCount": 4,
        "InstanceTypeFamily": "ecs.g6",
        "EniQuantity": 3,
        "EniTrunkSupported": true,
        "CpuSpeedFrequency": 2.7,
        "CpuTurboFrequency": 3.5,
        "PhysicalProcessorModel": "Intel Xeon(Ice Lake) Platinum 8369B",
        "NetworkEncryptionSupport": true,
        "InstanceCategory": "Big data",
        "CpuArchitecture": "X86",
        "GPUMemorySize": 32,
        "NetworkCardQuantity": 1,
        "NetworkCards": {
          "NetworkCardInfo": [
            {
              "NetworkCardIndex": 1
            }
          ]
        },
        "SupportedBootModes": {
          "SupportedBootMode": [
            "BIOS"
          ]
        },
        "EnhancedNetwork": {
          "SriovSupport": true,
          "VfQueueNumberPerEni": 5,
          "RssSupport": true
        },
        "CpuOptions": {
          "SupportedTopologyTypes": {
            "SupportedTopologyType": [
              "ContinuousCoreToHTMapping"
            ]
          },
          "ThreadsPerCore": 2,
          "Core": 2,
          "CoreFactor": 2,
          "HyperThreadingAdjustable": true,
          "NestedVirtualizationSupport": ""
        },
        "JumboFrameSupport": true,
        "Clock": {
          "PtpSupport": "unsupported"
        },
        "Attributes": {
          "Attribute": [
            {
              "Name": "VirtualIntelSpeedSelectTechnologySupport",
              "Value": "1"
            }
          ]
        },
        "NetworkInfo": {
          "BandwidthWeighting": {
            "WeightingInfos": {
              "WeightingInfo": [
                {
                  "Name": "Default",
                  "VpcBandwidth": 20480000,
                  "VpcBurstBandwidth": 25600000,
                  "EbsBandwidth": 10000000,
                  "EbsBurstBandwidth": 20000000
                }
              ]
            }
          }
        }
      }
    ]
  },
  "NextToken": "e71d8a535bd9cc11"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.