全部产品
Search
文档中心

云服务器 ECS:DescribeInstanceTypes - 查询云服务器ECS提供的实例规格资源

更新时间:Mar 19, 2024

调用DescribeInstanceTypes查询云服务器ECS提供的所有实例规格的信息,也可以查询指定实例规格的信息。

接口说明

调用接口前,您需要注意:

  • MaxResults(每页最大条目数)参数的最大值为 100,对于在 2022 年调用过本 API 的用户,MaxResults 参数的最大值仍为 1600,在 2023 年 11 月 15 日及之后,我们将对所有用户的 MaxResults 参数的最大值缩小到 100,不再支持 1600,若您调用该 API 时未传入 NextToken 参数进行分页获取,默认只返回规格第一页(不超过 100 条)数据,若需要更多数据,请您传入 NextToken 进行分页获取或传入过滤条件来限制返回的数据范围。

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

  • DescribeInstanceTypes 仅查询实例规格的配置和性能信息。如果您需要查询具体地域下可购买的实例规格,请使用 DescribeAvailableResource

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

调试

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

授权信息

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

请求参数

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

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

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

ecs.g6
InstanceTypesarray

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

string

指定查询的实例规格。N 表示可以设置多个实例规格,N 的取值范围:1~10。当该参数不传值时,默认查询所有实例规格的信息。

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
MaxResultslong

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

默认值:1600

10
NextTokenstring

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

e71d8a535bd9cc11

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

00827261-20B7-4562-83F2-4DF39876A45A
InstanceTypesobject []

实例规格集合。

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
NetworkCardsobject []

物理网卡信息列表。

NetworkCardIndexinteger

物理网卡索引。

1
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
            }
          ]
        }
      }
    ]
  },
  "NextToken": "e71d8a535bd9cc11"
}

错误码

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

变更历史

变更时间变更内容概要操作
2022-12-19OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
2022-09-07OpenAPI 入参发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:MinimumCpuCoreCount
    新增入参:MaximumCpuCoreCount
    新增入参:MinimumMemorySize
    新增入参:MaximumMemorySize
    新增入参:MinimumGPUAmount
    新增入参:MaximumGPUAmount
    新增入参:GPUSpec
    新增入参:InstanceCategory
    新增入参:CpuArchitecture
    新增入参:MinimumCpuSpeedFrequency
    新增入参:MaximumCpuSpeedFrequency
    新增入参:MinimumCpuTurboFrequency
    新增入参:MaximumCpuTurboFrequency
    新增入参:PhysicalProcessorModel
    新增入参:InstanceFamilyLevel
    新增入参:MinimumInstancePpsRx
    新增入参:MinimumInstancePpsTx
    新增入参:MinimumInstanceBandwidthRx
    新增入参:MinimumInstanceBandwidthTx
    新增入参:MinimumPrimaryEniQueueNumber
    新增入参:MinimumSecondaryEniQueueNumber
    新增入参:MinimumEniQuantity
    新增入参:MinimumQueuePairNumber
    新增入参:MinimumEriQuantity
    新增入参:MinimumEniPrivateIpAddressQuantity
    新增入参:MinimumEniIpv6AddressQuantity
    新增入参:MinimumLocalStorageAmount
    新增入参:MinimumLocalStorageCapacity
    新增入参:MinimumDiskQuantity
    新增入参:LocalStorageCategory
    新增入参:NvmeSupport
    新增入参:MinimumBaselineCredit
    新增入参:MinimumInitialCredit
出参OpenAPI 返回结构发生变更