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

本接口主要用于查询云服务器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暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
InstanceTypeFamily	string	否	实例规格所属的实例规格族。取值请参见 DescribeInstanceTypeFamilies 。关于实例规格族的更多信息，请参见实例规格族。	ecs.g6
InstanceTypes	array	否	指定的实例规格数组。数组长度：1~10。当该参数不传值时，默认查询所有实例规格的信息。
	string	否	实例规格。	ecs.g6.large
MinimumCpuCoreCount	integer	否	查询实例规格时，期望最小 vCPU 内核的数目。取值范围：正整数。说明查询到实例规格的 vCPU 内核数目小于设定值时，系统不会返回其实例规格的信息。	2
MaximumCpuCoreCount	integer	否	查询实例规格时，期望最大 vCPU 内核的数目。取值范围：正整数。说明查询到实例规格的 vCPU 内核数目大于设定值时，系统不会返回其实例规格的信息。	10
MinimumMemorySize	float	否	查询实例规格时，期望最小内存。单位：GiB。说明查询到实例规格的内存大小小于设定值时，系统不会返回其实例规格的信息。	20
MaximumMemorySize	float	否	查询实例规格时，期望最大内存。单位：GiB。说明查询到实例规格的内存大小大于设定值时，系统不会返回其实例规格的信息。	60
MinimumGPUAmount	integer	否	查询实例规格时，期望最小 GPU 数目。取值范围：正整数。说明查询到实例规格的 GPU 数目小于设定值时，系统不会返回其实例规格的信息。	3
MaximumGPUAmount	integer	否	查询实例规格时，期望最大 GPU 数目。取值范围：正整数。说明查询到实例规格的 GPU 数目大于设定值时，系统不会返回其实例规格的信息。	10
GPUSpec	string	否	GPU 类型。说明支持模糊匹配，如某规格的 GPU 类型为 NVIDIA V100，输入 NVIDIA 也可查询到该规格信息。	NVIDIA V100
InstanceCategory	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：高性能计算型。	Big data
CpuArchitecture	string	否	CPU 架构。取值范围： X86。 ARM。	X86
MinimumCpuSpeedFrequency	float	否	查询实例规格时，期望最小主频。说明查询到实例规格的主频小于设定值时，系统不会返回其实例规格的信息。	2.5
MaximumCpuSpeedFrequency	float	否	查询实例规格时，期望最大主频。说明查询到实例规格的主频大于设定值时，系统不会返回其实例规格的信息。	3.2
MinimumCpuTurboFrequency	float	否	查询实例规格时，期望最小睿频。说明查询到实例规格的睿频小于设定值时，系统不会返回其实例规格的信息。	3.2
MaximumCpuTurboFrequency	float	否	查询实例规格时，期望最大睿频。说明查询到实例规格的睿频大于设定值时，系统不会返回其实例规格的信息。	4.1
PhysicalProcessorModel	string	否	处理器型号。说明支持模糊匹配，如某规格的处理器型号为 Intel Xeon(Ice Lake) Platinum 8369B，输入 Intel 也可查询到该规格信息。	Intel Xeon(Ice Lake) Platinum 8369B
InstanceFamilyLevel	string	否	实例规格族级别。取值范围： EntryLevel：入门级（共享型）。 EnterpriseLevel：企业级。 CreditEntryLevel：积分入门级。	EntryLevel
MinimumInstancePpsRx	long	否	查询实例规格时，期望最小内网入方向网络收发包能力。单位：pps。说明查询到实例规格的内网入方向网络收发包能力小于设定值时，系统不会返回其实例规格的信息。	15
MinimumInstancePpsTx	long	否	查询实例规格时，期望最小内网出方向网络收发包能力。单位：pps。说明查询到实例规格的内网出方向网络收发包能力小于设定值时，系统不会返回其实例规格的信息。	15
MinimumInstanceBandwidthRx	integer	否	查询实例规格时，期望最小内网入方向带宽限制，单位：kbit/s。说明查询到实例规格的内网入方向带宽限制小于设定值时，系统不会返回其实例规格的信息。	12288
MinimumInstanceBandwidthTx	integer	否	查询实例规格时，期望最小内网出方向带宽限制，单位：kbit/s。说明查询到实例规格的内网出方向带宽限制小于设定值时，系统不会返回其实例规格的信息。	12288
MinimumPrimaryEniQueueNumber	integer	否	查询实例规格时，期望最小主网卡默认队列数。说明查询到实例规格的主网卡默认队列数小于设定值时，系统不会返回其实例规格的信息。	8
MinimumSecondaryEniQueueNumber	integer	否	查询实例规格时，期望最小辅助弹性网卡默认队列数。说明查询到实例规格的辅助弹性网卡默认队列数小于设定值时，系统不会返回其实例规格的信息。	4
MinimumEniQuantity	integer	否	查询实例规格时，期望最小支持挂载的弹性网卡上限。说明查询到实例规格的支持挂载的弹性网卡上限小于设定值时，系统不会返回其实例规格的信息。	4
MinimumQueuePairNumber	integer	否	查询实例规格时，期望最小单块弹性 RDMA 网卡（ERI）的 QP（QueuePair）队列数上限。说明查询到实例规格的单块弹性 RDMA 网卡（ERI）的 QP（QueuePair）队列数上限小于设定值时，系统不会返回其实例规格的信息。	8
MinimumEriQuantity	integer	否	查询实例规格时，期望最小弹性 RDMA 网卡（ERI）数量。说明查询到实例规格的弹性 RDMA 网卡（ERI）数量小于设定值时，系统不会返回其实例规格的信息。	0
MinimumEniPrivateIpAddressQuantity	integer	否	查询实例规格时，期望最小单块弹性网卡的 IPv4 地址上限。说明查询到实例规格的单块弹性网卡的 IPv4 地址上限小于设定值时，系统不会返回其实例规格的信息。	2
MinimumEniIpv6AddressQuantity	integer	否	查询实例规格时，期望最小单块弹性网卡的 IPv6 地址上限。说明查询到实例规格的单块弹性网卡的 IPv6 地址上限小于设定值时，系统不会返回其实例规格的信息。	2
MinimumLocalStorageAmount	integer	否	查询实例规格时，期望最小实例挂载的本地盘的数量。说明查询到实例规格的实例挂载的本地盘的数量小于设定值时，系统不会返回其实例规格的信息。	4
MinimumLocalStorageCapacity	long	否	实例挂载的本地盘的单盘容量。单位：GiB	40
MinimumDiskQuantity	integer	否	查询实例规格时，期望最小支持挂载的云盘数量上限。说明查询到实例规格的支持挂载的云盘数量上限小于设定值时，系统不会返回其实例规格的信息。	4
LocalStorageCategory	string	否	本地盘类型。更多信息，请参见本地盘。取值范围： local_hdd_pro：实例规格族 d1ne 和 d1 搭载的 SATA HDD 本地盘。 local_ssd_pro：实例规格族 i2、i2g、i1、ga1 和 gn5 等搭载的 NVMe SSD 本地盘。	local_ssd_pro
NvmeSupport	string	否	实例规格所挂载的云盘是否支持 NVMe。取值范围： required：支持。表示云盘以 NVMe 的方式挂载。 unsupported：不支持。表示云盘不以 NVMe 的方式挂载。	required
MinimumBaselineCredit	integer	否	查询实例规格时，期望最小突发性能实例 t5、t6 的基准 vCPU 计算性能（所有 vCPU 之和）。说明查询到实例规格的突发性能实例 t5、t6 的基准 vCPU 计算性能（所有 vCPU 之和）小于设定值时，系统不会返回其实例规格的信息。	12
MinimumInitialCredit	integer	否	查询实例规格时，期望最小突发性能实例 t5、t6 的初始 vCPU 积分值。说明查询到实例规格的突发性能实例 t5、t6 的初始 vCPU 积分值小于设定值时，系统不会返回其实例规格的信息。	12
InstanceTypeFamilies	array	否	指定查询的实例规格族数组。数组长度：1~10。
	string	否	实例规格族。	["ecs.g6", "ecs.c6", … "ecs.r6"]
GpuSpecs	array	否	指定查询的 GPU 类型数组。数组长度：1~10。
	string	否	指定查询的 GPU 类型。	["NVIDIA V100", "NVIDIA T4", … "NVIDIA A10"]
InstanceCategories	array	否	指定查询的实例规格分类数组。数组长度：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"]
CpuArchitectures	array	否	指定查询的 CPU 架构数组。数组长度：1~2。
	string	否	指定查询的 CPU 架构。取值范围： X86。 ARM。	["X86", "ARM"]
PhysicalProcessorModels	array	否	指定查询的处理器型号数组。数组长度：1~10。
	string	否	指定查询的处理器型号。	["Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY"]
LocalStorageCategories	array	否	指定的本地盘类型数组。数组长度：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"]
MaxResults	long	否	分页查询时每页的最大条目数。最大值：1600 默认值：1600	10
NextToken	string	否	查询凭证（Token）。取值为上一次调用该接口返回的 NextToken 参数值，初次调用接口时无需设置该参数。	e71d8a535bd9cc11

返回参数

名称	类型	描述	示例值
	object	查询的实例规格信息列表。
RequestId	string	请求 ID。	00827261-20B7-4562-83F2-4DF39876A45A
InstanceTypes	array<object>	实例规格集合。
InstanceType	object	实例规格集合。
EniTotalQuantity	integer	支持挂载的所有网卡（包括主网卡、弹性网卡、中继网卡等）上限。说明该参数正在邀测中，暂未开放使用。	0
LocalStorageCategory	string	本地盘类型。更多信息，请参见本地盘。可能值： local_hdd_pro：实例规格族 d1ne 和 d1 搭载的 SATA HDD 本地盘。 local_ssd_pro：实例规格族 i2、i2g、i1、ga1 和 gn5 等搭载的 NVMe SSD 本地盘。	local_ssd_pro
PrimaryEniQueueNumber	integer	主网卡默认队列数。	4
MemorySize	float	内存大小。单位：GiB。	16
LocalStorageCapacity	long	实例挂载的本地盘的单盘容量。单位：GiB。	5000
InstanceFamilyLevel	string	实例规格族级别。可能值： EntryLevel：入门级（共享型）。 EnterpriseLevel：企业级。 CreditEntryLevel：积分入门级。更多信息，请参见突发性能实例。	EnterpriseLevel
InstancePpsRx	long	内网入方向网络收发包能力。单位：pps。	500000
EniIpv6AddressQuantity	integer	单块弹性网卡的 IPv6 地址上限。	1
MaximumQueueNumberPerEni	integer	单块弹性网卡最大队列数。包括主网卡及辅助网卡支持的队列数。	4
InstanceTypeId	string	实例规格 ID。	ecs.g6.large
InstanceBandwidthRx	integer	最大内网入方向带宽限制。单位：kbit/s	1024000
SecondaryEniQueueNumber	integer	辅助弹性网卡默认队列数。	4
GPUSpec	string	GPU 类型。	NVIDIA V100
InstanceBandwidthTx	integer	最大内网出方向带宽限制。单位：kbit/s	1024000
QueuePairNumber	integer	单块弹性 RDMA 网卡（ERI）的 QP（QueuePair）队列数上限。	22
EriQuantity	integer	弹性 RDMA 网卡（ERI）数量。说明该参数正在邀测中，暂未开放使用。	0
GPUAmount	integer	GPU 数量。	0
TotalEniQueueQuantity	integer	实例规格允许修改的弹性网卡队列数总配额。	12
NvmeSupport	string	实例规格所挂载的云盘是否支持 NVMe。可能值： required：支持。表示云盘以 NVMe 的方式挂载。 unsupported：不支持。表示云盘不以 NVMe 的方式挂载。	unsupported
DiskQuantity	integer	支持挂载的云盘数量上限。	17
InitialCredit	integer	突发性能实例 t5、t6 的初始 vCPU 积分值。	120
LocalStorageAmount	integer	实例挂载的本地盘的数量。	1
BaselineCredit	integer	突发性能实例 t5、t6 的基准 vCPU 计算性能（所有 vCPU 之和）。	4
InstancePpsTx	long	内网出方向网络收发包能力。单位：pps。	500000
EniPrivateIpAddressQuantity	integer	单块弹性网卡的 IPv4 地址上限。	10
CpuCoreCount	integer	vCPU 内核数目。	4
InstanceTypeFamily	string	实例规格族。	ecs.g6
EniQuantity	integer	支持挂载的弹性网卡上限。	3
EniTrunkSupported	boolean	实例规格所挂载的网卡是否支持中继。说明该参数正在邀测中，暂未开放使用。	true
CpuSpeedFrequency	float	CPU 基频，单位 GHz。	2.7
CpuTurboFrequency	float	CPU 睿频，单位 GHz。	3.5
PhysicalProcessorModel	string	处理器型号。	Intel Xeon(Ice Lake) Platinum 8369B
NetworkEncryptionSupport	boolean	实例是否支持 VPC 网络流量加密，可能值： true：支持 VPC 网络流量加密。 false：不支持 VPC 网络流量加密。	true
InstanceCategory	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：高性能计算型。	Big data
CpuArchitecture	string	CPU 架构，可能值： X86。 ARM。	X86
GPUMemorySize	float	规格对应的单块 GPU 显存。单位：GiB。	32
NetworkCardQuantity	integer	实例规格支持的物理网卡数量。	1
NetworkCards	array<object>	物理网卡信息列表。
NetworkCardInfo	object	物理网卡信息。
NetworkCardIndex	integer	物理网卡索引。	1
SupportedBootModes	array	规格支持的启动模式。
SupportedBootMode	string	启动模式，可能值： BIOS。 UEFI。	BIOS
EnhancedNetwork	object	说明该参数暂未开放使用。
SriovSupport	boolean	说明该参数暂未开放使用。	true
VfQueueNumberPerEni	integer	说明该参数暂未开放使用。	5
CpuOptions	object	CPU 设置。
SupportedTopologyTypes	array	实例规格支持的 CPU 拓扑类型数组。
SupportedTopologyType	string	实例规格支持的 CPU 拓扑类型。可能值： ContinuousCoreToHTMapping：实例的同一个 Core 的 HT 是连续的。 DiscreteCoreToHTMapping：实例的同一个 Core 的 HT 是离散的。	ContinuousCoreToHTMapping
ThreadsPerCore	integer	CPU 每个核心的线程数。说明 `CpuOptions.ThreadsPerCore=1`表示关闭 CPU 超线程。	2
Core	integer	CPU 核心数。	2
CoreFactor	integer	CPU 选项步长。	2
HyperThreadingAdjustable	boolean	是否支持开关超线程。	true
JumboFrameSupport	boolean	是否支持巨型帧。	true
NextToken	string	本次调用返回的查询凭证（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-25	OpenAPI 返回结构发生变更	查看变更详情
2024-10-31	OpenAPI 返回结构发生变更	查看变更详情
2024-07-03	OpenAPI 返回结构发生变更	查看变更详情
2024-04-24	OpenAPI 返回结构发生变更	查看变更详情
2024-04-12	OpenAPI 入参发生变更	查看变更详情
2022-12-19	OpenAPI 返回结构发生变更	查看变更详情
2022-09-07	OpenAPI 入参发生变更、OpenAPI 返回结构发生变更	查看变更详情