全部产品
Search
文档中心

云服务器 ECS:DescribeInstanceTypes - 查询实例规格信息列表

更新时间:Dec 06, 2024

本接口主要用于查询云服务器ECS提供的所有实例规格的信息列表并关联获取实例规格的详细信息,也可根据特定条件查询指定实例规格的信息,帮助您了解不同实例规格的配置和性能,以便选择适合自己业务需求的实例。

接口说明

  • 分页查询:您可以设置 MaxResults 参数以限制返回值中实例规格的条目数,如果只返回了部分被查询到的实例规格的条目数,则会同步返回 NextToken 参数值。再次调用该接口,设置上次调用该接口返回的 NextToken 参数值以及 MaxResults 参数,以实现分页查询实例规格信息。

  • 若您调用该 API 时未传入 NextToken 参数进行分页获取,默认只返回第一页(不超过 100 条)数据,若需要更多数据,请您传入 NextToken 进行分页获取或传入过滤条件来限制返回的数据范围。

说明 MaxResults(每页最大条目数)参数的最大值为 100,对于在 2022 年调用过本 API 的用户,MaxResults 参数的最大值仍为 1600,在 2023 年 11 月 15 日及之后,我们将对所有用户的 MaxResults 参数的最大值缩小到 100,不再支持 1600。
  • DescribeInstanceTypes 仅查询实例规格的配置和性能信息。如果您需要查询具体地域下可购买的实例规格,请使用 DescribeAvailableResource

  • 关于使用 DescribeInstanceTypes 的最佳实践,请参见ECS 如何对比性能?

  • 如果您需要使用非售卖可见的实例规格或特别的规格需求,请提交工单

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceTypeFamilystring

实例规格所属的实例规格族。取值请参见 DescribeInstanceTypeFamilies

关于实例规格族的更多信息,请参见实例规格族

ecs.g6
InstanceTypesarray

指定的实例规格数组。数组长度:1~10。当该参数不传值时,默认查询所有实例规格的信息。

string

实例规格。

ecs.g6.large
MinimumCpuCoreCountinteger

查询实例规格时,期望最小 vCPU 内核的数目。取值范围:正整数。

说明 查询到实例规格的 vCPU 内核数目小于设定值时,系统不会返回其实例规格的信息。
2
MaximumCpuCoreCountinteger

查询实例规格时,期望最大 vCPU 内核的数目。取值范围:正整数。

说明 查询到实例规格的 vCPU 内核数目大于设定值时,系统不会返回其实例规格的信息。
10
MinimumMemorySizefloat

查询实例规格时,期望最小内存。单位:GiB。

说明 查询到实例规格的内存大小小于设定值时,系统不会返回其实例规格的信息。
20
MaximumMemorySizefloat

查询实例规格时,期望最大内存。单位:GiB。

说明 查询到实例规格的内存大小大于设定值时,系统不会返回其实例规格的信息。
60
MinimumGPUAmountinteger

查询实例规格时,期望最小 GPU 数目。取值范围:正整数。

说明 查询到实例规格的 GPU 数目小于设定值时,系统不会返回其实例规格的信息。
3
MaximumGPUAmountinteger

查询实例规格时,期望最大 GPU 数目。取值范围:正整数。

说明 查询到实例规格的 GPU 数目大于设定值时,系统不会返回其实例规格的信息。
10
GPUSpecstring

GPU 类型。

说明 支持模糊匹配,如某规格的 GPU 类型为 NVIDIA V100,输入 NVIDIA 也可查询到该规格信息。
NVIDIA V100
InstanceCategorystring

实例规格分类。取值范围:

  • General-purpose: 通用型。
  • Compute-optimized:计算型。
  • Memory-optimized:内存型。
  • Big data:大数据型。
  • Local SSDs :本地 SSD 型。
  • High Clock Speed :高主频型。
  • Enhanced :增强型。
  • Shared:共享型。
  • Compute-optimized with GPU :GPU 计算型。
  • Visual Compute-optimized :视觉计算型。
  • Heterogeneous Service :异构服务型。
  • Compute-optimized with FPGA :FPGA 计算型。
  • Compute-optimized with NPU :NPU 计算型。
  • ECS Bare Metal :弹性裸金属服务器。
  • Super Computing Cluster:超级计算集群。
  • High Performance Compute:高性能计算型。
Big data
CpuArchitecturestring

CPU 架构。取值范围:

  • X86。
  • ARM。
X86
MinimumCpuSpeedFrequencyfloat

查询实例规格时,期望最小主频。

说明 查询到实例规格的主频小于设定值时,系统不会返回其实例规格的信息。
2.5
MaximumCpuSpeedFrequencyfloat

查询实例规格时,期望最大主频。

说明 查询到实例规格的主频大于设定值时,系统不会返回其实例规格的信息。
3.2
MinimumCpuTurboFrequencyfloat

查询实例规格时,期望最小睿频。

说明 查询到实例规格的睿频小于设定值时,系统不会返回其实例规格的信息。
3.2
MaximumCpuTurboFrequencyfloat

查询实例规格时,期望最大睿频。

说明 查询到实例规格的睿频大于设定值时,系统不会返回其实例规格的信息。
4.1
PhysicalProcessorModelstring

处理器型号。

说明 支持模糊匹配,如某规格的处理器型号为 Intel Xeon(Ice Lake) Platinum 8369B,输入 Intel 也可查询到该规格信息。
Intel Xeon(Ice Lake) Platinum 8369B
InstanceFamilyLevelstring

实例规格族级别。取值范围:

  • EntryLevel:入门级(共享型)。
  • EnterpriseLevel:企业级。
  • CreditEntryLevel:积分入门级。
EntryLevel
MinimumInstancePpsRxlong

查询实例规格时,期望最小内网入方向网络收发包能力。单位:pps。

说明 查询到实例规格的内网入方向网络收发包能力小于设定值时,系统不会返回其实例规格的信息。
15
MinimumInstancePpsTxlong

查询实例规格时,期望最小内网出方向网络收发包能力。单位:pps。

说明 查询到实例规格的内网出方向网络收发包能力小于设定值时,系统不会返回其实例规格的信息。
15
MinimumInstanceBandwidthRxinteger

查询实例规格时,期望最小内网入方向带宽限制,单位:kbit/s。

说明 查询到实例规格的内网入方向带宽限制小于设定值时,系统不会返回其实例规格的信息。
12288
MinimumInstanceBandwidthTxinteger

查询实例规格时,期望最小内网出方向带宽限制,单位:kbit/s。

说明 查询到实例规格的内网出方向带宽限制小于设定值时,系统不会返回其实例规格的信息。
12288
MinimumPrimaryEniQueueNumberinteger

查询实例规格时,期望最小主网卡默认队列数。

说明 查询到实例规格的主网卡默认队列数小于设定值时,系统不会返回其实例规格的信息。
8
MinimumSecondaryEniQueueNumberinteger

查询实例规格时,期望最小辅助弹性网卡默认队列数。

说明 查询到实例规格的辅助弹性网卡默认队列数小于设定值时,系统不会返回其实例规格的信息。
4
MinimumEniQuantityinteger

查询实例规格时,期望最小支持挂载的弹性网卡上限。

说明 查询到实例规格的支持挂载的弹性网卡上限小于设定值时,系统不会返回其实例规格的信息。
4
MinimumQueuePairNumberinteger

查询实例规格时,期望最小单块弹性 RDMA 网卡(ERI)的 QP(QueuePair)队列数上限。

说明 查询到实例规格的单块弹性 RDMA 网卡(ERI)的 QP(QueuePair)队列数上限小于设定值时,系统不会返回其实例规格的信息。
8
MinimumEriQuantityinteger

查询实例规格时,期望最小弹性 RDMA 网卡(ERI)数量。

说明 查询到实例规格的弹性 RDMA 网卡(ERI)数量小于设定值时,系统不会返回其实例规格的信息。
0
MinimumEniPrivateIpAddressQuantityinteger

查询实例规格时,期望最小单块弹性网卡的 IPv4 地址上限。

说明 查询到实例规格的单块弹性网卡的 IPv4 地址上限小于设定值时,系统不会返回其实例规格的信息。
2
MinimumEniIpv6AddressQuantityinteger

查询实例规格时,期望最小单块弹性网卡的 IPv6 地址上限。

说明 查询到实例规格的单块弹性网卡的 IPv6 地址上限小于设定值时,系统不会返回其实例规格的信息。
2
MinimumLocalStorageAmountinteger

查询实例规格时,期望最小实例挂载的本地盘的数量。

说明 查询到实例规格的实例挂载的本地盘的数量小于设定值时,系统不会返回其实例规格的信息。
4
MinimumLocalStorageCapacitylong

实例挂载的本地盘的单盘容量。单位:GiB

40
MinimumDiskQuantityinteger

查询实例规格时,期望最小支持挂载的云盘数量上限。

说明 查询到实例规格的支持挂载的云盘数量上限小于设定值时,系统不会返回其实例规格的信息。
4
LocalStorageCategorystring

本地盘类型。更多信息,请参见本地盘。取值范围:

  • local_hdd_pro:实例规格族 d1ne 和 d1 搭载的 SATA HDD 本地盘。
  • local_ssd_pro:实例规格族 i2、i2g、i1、ga1 和 gn5 等搭载的 NVMe SSD 本地盘。
local_ssd_pro
NvmeSupportstring

实例规格所挂载的云盘是否支持 NVMe。取值范围:

  • required:支持。表示云盘以 NVMe 的方式挂载。
  • unsupported:不支持。表示云盘不以 NVMe 的方式挂载。
required
MinimumBaselineCreditinteger

查询实例规格时,期望最小突发性能实例 t5、t6 的基准 vCPU 计算性能(所有 vCPU 之和)。

说明 查询到实例规格的突发性能实例 t5、t6 的基准 vCPU 计算性能(所有 vCPU 之和)小于设定值时,系统不会返回其实例规格的信息。
12
MinimumInitialCreditinteger

查询实例规格时,期望最小突发性能实例 t5、t6 的初始 vCPU 积分值。

说明 查询到实例规格的突发性能实例 t5、t6 的初始 vCPU 积分值小于设定值时,系统不会返回其实例规格的信息。
12
InstanceTypeFamiliesarray

指定查询的实例规格族数组。数组长度:1~10。

string

实例规格族。

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

指定查询的 GPU 类型数组。数组长度:1~10。

string

指定查询的 GPU 类型。

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

指定查询的实例规格分类数组。数组长度:1~10。

string

指定查询的实例规格分类。取值范围:

  • General-purpose: 通用型。
  • Compute-optimized:计算型。
  • Memory-optimized:内存型。
  • Big data:大数据型。
  • Local SSDs :本地 SSD 型。
  • High Clock Speed :高主频型。
  • Enhanced :增强型。
  • Shared:共享型。
  • Compute-optimized with GPU :GPU 计算型。
  • Visual Compute-optimized :视觉计算型。
  • Heterogeneous Service :异构服务型。
  • Compute-optimized with FPGA :FPGA 计算型。
  • Compute-optimized with NPU :NPU 计算型。
  • ECS Bare Metal :弹性裸金属服务器。
  • Super Computing Cluster:超级计算集群。
  • High Performance Compute:高性能计算型。
["General-purpose", "Compute-optimized", … "Enhanced"]
CpuArchitecturesarray

指定查询的 CPU 架构数组。数组长度:1~2。

string

指定查询的 CPU 架构。取值范围:

  • X86。
  • ARM。
["X86", "ARM"]
PhysicalProcessorModelsarray

指定查询的处理器型号数组。数组长度:1~10。

string

指定查询的处理器型号。

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

指定的本地盘类型数组。数组长度:1~2。

string

指定查询的本地盘类型。更多信息,请参见本地盘。取值范围:

  • local_hdd_pro:实例规格族 d1ne 和 d1 搭载的 SATA HDD 本地盘。
  • local_ssd_pro:实例规格族 i2、i2g、i1、ga1 和 gn5 等搭载的 NVMe SSD 本地盘。
["local_hdd_pro", "local_ssd_pro"]
MaxResultslong

分页查询时每页的最大条目数。最大值:1600

默认值:1600

10
NextTokenstring

查询凭证(Token)。取值为上一次调用该接口返回的 NextToken 参数值,初次调用接口时无需设置该参数。

e71d8a535bd9cc11

返回参数

名称类型描述示例值
object

查询的实例规格信息列表。

RequestIdstring

请求 ID。

00827261-20B7-4562-83F2-4DF39876A45A
InstanceTypesarray<object>

实例规格集合。

InstanceTypeobject

实例规格集合。

EniTotalQuantityinteger

支持挂载的所有网卡(包括主网卡、弹性网卡、中继网卡等)上限。

说明 该参数正在邀测中,暂未开放使用。
0
LocalStorageCategorystring

本地盘类型。更多信息,请参见本地盘。可能值:

  • local_hdd_pro:实例规格族 d1ne 和 d1 搭载的 SATA HDD 本地盘。
  • local_ssd_pro:实例规格族 i2、i2g、i1、ga1 和 gn5 等搭载的 NVMe SSD 本地盘。
local_ssd_pro
PrimaryEniQueueNumberinteger

主网卡默认队列数。

4
MemorySizefloat

内存大小。单位:GiB。

16
LocalStorageCapacitylong

实例挂载的本地盘的单盘容量。单位:GiB。

5000
InstanceFamilyLevelstring

实例规格族级别。可能值:

  • EntryLevel:入门级(共享型)。
  • EnterpriseLevel:企业级。
  • CreditEntryLevel:积分入门级。更多信息,请参见突发性能实例
EnterpriseLevel
InstancePpsRxlong

内网入方向网络收发包能力。单位:pps。

500000
EniIpv6AddressQuantityinteger

单块弹性网卡的 IPv6 地址上限。

1
MaximumQueueNumberPerEniinteger

单块弹性网卡最大队列数。包括主网卡及辅助网卡支持的队列数。

4
InstanceTypeIdstring

实例规格 ID。

ecs.g6.large
InstanceBandwidthRxinteger

最大内网入方向带宽限制。单位:kbit/s

1024000
SecondaryEniQueueNumberinteger

辅助弹性网卡默认队列数。

4
GPUSpecstring

GPU 类型。

NVIDIA V100
InstanceBandwidthTxinteger

最大内网出方向带宽限制。单位:kbit/s

1024000
QueuePairNumberinteger

单块弹性 RDMA 网卡(ERI)的 QP(QueuePair)队列数上限。

22
EriQuantityinteger

弹性 RDMA 网卡(ERI)数量。

说明 该参数正在邀测中,暂未开放使用。
0
GPUAmountinteger

GPU 数量。

0
TotalEniQueueQuantityinteger

实例规格允许修改的弹性网卡队列数总配额。

12
NvmeSupportstring

实例规格所挂载的云盘是否支持 NVMe。可能值:

  • required:支持。表示云盘以 NVMe 的方式挂载。
  • unsupported:不支持。表示云盘不以 NVMe 的方式挂载。
unsupported
DiskQuantityinteger

支持挂载的云盘数量上限。

17
InitialCreditinteger

突发性能实例 t5、t6 的初始 vCPU 积分值。

120
LocalStorageAmountinteger

实例挂载的本地盘的数量。

1
BaselineCreditinteger

突发性能实例 t5、t6 的基准 vCPU 计算性能(所有 vCPU 之和)。

4
InstancePpsTxlong

内网出方向网络收发包能力。单位:pps。

500000
EniPrivateIpAddressQuantityinteger

单块弹性网卡的 IPv4 地址上限。

10
CpuCoreCountinteger

vCPU 内核数目。

4
InstanceTypeFamilystring

实例规格族。

ecs.g6
EniQuantityinteger

支持挂载的弹性网卡上限。

3
EniTrunkSupportedboolean

实例规格所挂载的网卡是否支持中继。

说明 该参数正在邀测中,暂未开放使用。
true
CpuSpeedFrequencyfloat

CPU 基频,单位 GHz。

2.7
CpuTurboFrequencyfloat

CPU 睿频,单位 GHz。

3.5
PhysicalProcessorModelstring

处理器型号。

Intel Xeon(Ice Lake) Platinum 8369B
NetworkEncryptionSupportboolean

实例是否支持 VPC 网络流量加密,可能值:

  • true:支持 VPC 网络流量加密。
  • false:不支持 VPC 网络流量加密。
true
InstanceCategorystring

实例规格分类。可能值:

  • General-purpose: 通用型。
  • Compute-optimized:计算型。
  • Memory-optimized:内存型。
  • Big data:大数据型。
  • Local SSDs :本地 SSD 型。
  • High Clock Speed :高主频型。
  • Enhanced :增强型。
  • Shared:共享型。
  • Compute-optimized with GPU :GPU 计算型。
  • Visual Compute-optimized :视觉计算型。
  • Heterogeneous Service :异构服务型。
  • Compute-optimized with FPGA :FPGA 计算型。
  • Compute-optimized with NPU :NPU 计算型。
  • ECS Bare Metal :弹性裸金属服务器。
  • Super Computing Cluster:超级计算集群。
  • High Performance Compute:高性能计算型。
Big data
CpuArchitecturestring

CPU 架构,可能值:

  • X86。
  • ARM。
X86
GPUMemorySizefloat

规格对应的单块 GPU 显存。单位:GiB。

32
NetworkCardQuantityinteger

实例规格支持的物理网卡数量。

1
NetworkCardsarray<object>

物理网卡信息列表。

NetworkCardInfoobject

物理网卡信息。

NetworkCardIndexinteger

物理网卡索引。

1
SupportedBootModesarray

规格支持的启动模式。

SupportedBootModestring

启动模式,可能值:

  • BIOS。
  • UEFI。
BIOS
EnhancedNetworkobject
说明 该参数暂未开放使用。
SriovSupportboolean
说明 该参数暂未开放使用。
true
VfQueueNumberPerEniinteger
说明 该参数暂未开放使用。
5
CpuOptionsobject

CPU 设置。

SupportedTopologyTypesarray

实例规格支持的 CPU 拓扑类型数组。

SupportedTopologyTypestring

实例规格支持的 CPU 拓扑类型。可能值:

  • ContinuousCoreToHTMapping:实例的同一个 Core 的 HT 是连续的。
  • DiscreteCoreToHTMapping:实例的同一个 Core 的 HT 是离散的。
ContinuousCoreToHTMapping
ThreadsPerCoreinteger

CPU 每个核心的线程数。

说明 CpuOptions.ThreadsPerCore=1表示关闭 CPU 超线程。
2
Coreinteger

CPU 核心数。

2
CoreFactorinteger

CPU 选项步长。

2
HyperThreadingAdjustableboolean

是否支持开关超线程。

true
JumboFrameSupportboolean

是否支持巨型帧。

true
NextTokenstring

本次调用返回的查询凭证(Token)。

e71d8a535bd9cc11

示例

正常返回示例

JSON格式

{
  "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
        },
        "CpuOptions": {
          "SupportedTopologyTypes": {
            "SupportedTopologyType": [
              "ContinuousCoreToHTMapping"
            ]
          },
          "ThreadsPerCore": 2,
          "Core": 2,
          "CoreFactor": 2,
          "HyperThreadingAdjustable": true
        },
        "JumboFrameSupport": true
      }
    ]
  },
  "NextToken": "e71d8a535bd9cc11"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-11-25OpenAPI 返回结构发生变更查看变更详情
2024-10-31OpenAPI 返回结构发生变更查看变更详情
2024-07-03OpenAPI 返回结构发生变更查看变更详情
2024-04-24OpenAPI 返回结构发生变更查看变更详情
2024-04-12OpenAPI 入参发生变更查看变更详情
2022-12-19OpenAPI 返回结构发生变更查看变更详情
2022-09-07OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情