本接口主要用于查询云服务器ECS提供的所有实例规格的信息列表并关联获取实例规格的详细信息,也可根据特定条件查询指定实例规格的信息,帮助您了解不同实例规格的配置和性能,以便选择适合自己业务需求的实例。
接口说明
-
分页查询:您可以设置 MaxResults 参数以限制返回值中实例规格的条目数,如果只返回了部分被查询到的实例规格的条目数,则会同步返回 NextToken 参数值。再次调用该接口,设置上次调用该接口返回的 NextToken 参数值以及 MaxResults 参数,以实现分页查询实例规格信息。
-
若您调用该 API 时未传入 NextToken 参数进行分页获取,默认只返回第一页(不超过 100 条)数据,若需要更多数据,请您传入 NextToken 进行分页获取或传入过滤条件来限制返回的数据范围。
MaxResults(每页最大条目数)参数的最大值为 100,对于在 2022 年调用过本 API 的用户,MaxResults 参数的最大值仍为 1600,在 2023 年 11 月 15 日及之后,我们将对所有用户的 MaxResults 参数的最大值缩小到 100,不再支持 1600。
-
DescribeInstanceTypes 仅查询实例规格的配置和性能信息。如果您需要查询具体地域下可购买的实例规格,请使用 DescribeAvailableResource 。
-
如果您需要使用非售卖可见的实例规格或特别的规格需求,请提交工单。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceTypeFamily |
string |
否 |
实例规格所属的实例规格族。取值请参见 DescribeInstanceTypeFamilies 。 关于实例规格族的更多信息,请参见实例规格族。 |
ecs.g6 |
| InstanceTypes |
array |
否 |
指定的实例规格数组。数组长度:1~10。当该参数不传值时,默认查询所有实例规格的信息。 |
ecs.g6.large |
|
string |
否 |
实例规格。 |
ecs.g6.large |
|
| MinimumCpuCoreCount |
integer |
否 |
查询实例规格时,期望最小 vCPU 内核的数目。取值范围:正整数。 说明
查询到实例规格的 vCPU 内核数目小于设定值时,系统不会返回其实例规格的信息。 |
2 |
| MaximumCpuCoreCount |
integer |
否 |
查询实例规格时,期望最大 vCPU 内核的数目。取值范围:正整数。 说明
查询到实例规格的 vCPU 内核数目大于设定值时,系统不会返回其实例规格的信息。 |
10 |
| MinimumMemorySize |
number |
否 |
查询实例规格时,期望最小内存。单位:GiB。 说明
查询到实例规格的内存大小小于设定值时,系统不会返回其实例规格的信息。 |
20 |
| MaximumMemorySize |
number |
否 |
查询实例规格时,期望最大内存。单位:GiB。 说明
查询到实例规格的内存大小大于设定值时,系统不会返回其实例规格的信息。 |
60 |
| MinimumGPUAmount |
integer |
否 |
查询实例规格时,期望最小 GPU 数目。取值范围:正整数。 说明
查询到实例规格的 GPU 数目小于设定值时,系统不会返回其实例规格的信息。 |
3 |
| MaximumGPUAmount |
integer |
否 |
查询实例规格时,期望最大 GPU 数目。取值范围:正整数。 说明
查询到实例规格的 GPU 数目大于设定值时,系统不会返回其实例规格的信息。 |
10 |
| GPUSpec |
string |
否 |
GPU 类型。 说明
支持模糊匹配,如某规格的 GPU 类型为 NVIDIA V100,输入 NVIDIA 也可查询到该规格信息。 |
NVIDIA V100 |
| InstanceCategory |
string |
否 |
实例规格分类。取值范围:
|
Big data |
| CpuArchitecture |
string |
否 |
CPU 架构。取值范围:
|
X86 |
| MinimumCpuSpeedFrequency |
number |
否 |
查询实例规格时,期望最小主频。 说明
查询到实例规格的主频小于设定值时,系统不会返回其实例规格的信息。 |
2.5 |
| MaximumCpuSpeedFrequency |
number |
否 |
查询实例规格时,期望最大主频。 说明
查询到实例规格的主频大于设定值时,系统不会返回其实例规格的信息。 |
3.2 |
| MinimumCpuTurboFrequency |
number |
否 |
查询实例规格时,期望最小睿频。 说明
查询到实例规格的睿频小于设定值时,系统不会返回其实例规格的信息。 |
3.2 |
| MaximumCpuTurboFrequency |
number |
否 |
查询实例规格时,期望最大睿频。 说明
查询到实例规格的睿频大于设定值时,系统不会返回其实例规格的信息。 |
4.1 |
| PhysicalProcessorModel |
string |
否 |
处理器型号。 说明
支持模糊匹配,如某规格的处理器型号为 Intel Xeon(Ice Lake) Platinum 8369B,输入 Intel 也可查询到该规格信息。 |
Intel Xeon(Ice Lake) Platinum 8369B |
| InstanceFamilyLevel |
string |
否 |
实例规格族级别。取值范围:
|
EntryLevel |
| MinimumInstancePpsRx |
integer |
否 |
查询实例规格时,期望最小内网入方向网络收发包能力。单位:pps。 说明
查询到实例规格的内网入方向网络收发包能力小于设定值时,系统不会返回其实例规格的信息。 |
15 |
| MinimumInstancePpsTx |
integer |
否 |
查询实例规格时,期望最小内网出方向网络收发包能力。单位: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 |
integer |
否 |
实例挂载的本地盘的单盘容量。单位:GiB |
40 |
| MinimumDiskQuantity |
integer |
否 |
查询实例规格时,期望最小支持挂载的云盘数量上限。 说明
查询到实例规格的支持挂载的云盘数量上限小于设定值时,系统不会返回其实例规格的信息。 |
4 |
| LocalStorageCategory |
string |
否 |
本地盘类型。更多信息,请参见本地盘。取值范围:
|
local_ssd_pro |
| NvmeSupport |
string |
否 |
实例规格所挂载的云盘是否支持 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", … "Enhanced"] |
|
| CpuArchitectures |
array |
否 |
指定查询的 CPU 架构数组。数组长度:1~2。 |
|
|
string |
否 |
指定查询的 CPU 架构。取值范围:
|
["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", "local_ssd_pro"] |
|
| MaxResults |
integer |
否 |
分页查询时每页的最大条目数。最大值:1600 默认值:1600 |
10 |
| NextToken |
string |
否 |
查询凭证(Token)。取值为上一次调用该接口返回的 NextToken 参数值,初次调用接口时无需设置该参数。 |
e71d8a535bd9cc11 |
| AdditionalAttributes |
array |
否 |
指定需要返回的规格高级特性列表。 |
|
|
string |
否 |
其他属性值。N 的取值范围为 1~20。取值范围:
|
NetworkInfo.BandwidthWeighting |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
查询的实例规格信息列表。 |
||
| RequestId |
string |
请求 ID。 |
00827261-20B7-4562-83F2-4DF39876A45A |
| InstanceTypes |
object |
||
| InstanceType |
array<object> |
实例规格集合。 |
|
|
array<object> |
实例规格集合。 |
||
| EniTotalQuantity |
integer |
支持挂载的所有网卡(包括主网卡、弹性网卡、中继网卡等)上限。 说明
该参数正在邀测中,暂未开放使用。 |
0 |
| LocalStorageCategory |
string |
本地盘类型。更多信息,请参见本地盘。可能值:
|
local_ssd_pro |
| PrimaryEniQueueNumber |
integer |
主网卡默认队列数。 |
4 |
| MemorySize |
number |
内存大小。单位:GiB。 |
16 |
| LocalStorageCapacity |
integer |
实例挂载的本地盘的单盘容量。单位:GiB。 |
5000 |
| InstanceFamilyLevel |
string |
实例规格族级别。可能值:
|
EnterpriseLevel |
| InstancePpsRx |
integer |
内网入方向网络收发包能力。单位: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。可能值:
|
unsupported |
| DiskQuantity |
integer |
支持挂载的云盘数量上限。 |
17 |
| InitialCredit |
integer |
突发性能实例 t5、t6 的初始 vCPU 积分值。 |
120 |
| LocalStorageAmount |
integer |
实例挂载的本地盘的数量。 |
1 |
| BaselineCredit |
integer |
突发性能实例 t5、t6 的基准 vCPU 计算性能(所有 vCPU 之和)。 |
4 |
| InstancePpsTx |
integer |
内网出方向网络收发包能力。单位:pps。 |
500000 |
| EniPrivateIpAddressQuantity |
integer |
单块弹性网卡的 IPv4 地址上限。 |
10 |
| CpuCoreCount |
integer |
vCPU 内核数目。 |
4 |
| InstanceTypeFamily |
string |
实例规格族。 |
ecs.g6 |
| EniQuantity |
integer |
支持挂载的弹性网卡上限。 |
3 |
| EniTrunkSupported |
boolean |
实例规格所挂载的网卡是否支持中继。 说明
该参数正在邀测中,暂未开放使用。 |
true |
| CpuSpeedFrequency |
number |
CPU 基频,单位 GHz。 |
2.7 |
| CpuTurboFrequency |
number |
CPU 睿频,单位 GHz。 |
3.5 |
| PhysicalProcessorModel |
string |
处理器型号。 |
Intel Xeon(Ice Lake) Platinum 8369B |
| NetworkEncryptionSupport |
boolean |
实例是否支持 VPC 网络流量加密,可能值:
说明
该参数正在邀测中,暂未开放使用。 |
true |
| InstanceCategory |
string |
实例规格分类。可能值:
|
Big data |
| CpuArchitecture |
string |
CPU 架构,可能值:
|
X86 |
| GPUMemorySize |
number |
规格对应的单块 GPU 显存。单位:GiB。 |
32 |
| NetworkCardQuantity |
integer |
实例规格支持的物理网卡数量。 |
1 |
| NetworkCards |
object |
||
| NetworkCardInfo |
array<object> |
物理网卡信息列表。 |
|
|
object |
物理网卡信息。 |
||
| NetworkCardIndex |
integer |
物理网卡索引。 |
1 |
| SupportedBootModes |
object |
||
| SupportedBootMode |
array |
规格支持的启动模式。 |
|
|
string |
启动模式,可能值:
|
BIOS |
|
| EnhancedNetwork |
object |
说明
该参数暂未开放使用。 |
|
| SriovSupport |
boolean |
说明
该参数暂未开放使用。 |
true |
| VfQueueNumberPerEni |
integer |
说明
该参数暂未开放使用。 |
5 |
| RssSupport |
boolean |
说明
该参数暂未开放使用。 |
true |
| CpuOptions |
object |
CPU 设置。 |
|
| SupportedTopologyTypes |
object |
||
| SupportedTopologyType |
array |
实例规格支持的 CPU 拓扑类型数组。 |
|
|
string |
实例规格支持的 CPU 拓扑类型。可能值:
|
ContinuousCoreToHTMapping |
|
| ThreadsPerCore |
integer |
CPU 每个核心的线程数。 说明
|
2 |
| Core |
integer |
CPU 核心数。 |
2 |
| CoreFactor |
integer |
CPU 选项步长。 |
2 |
| HyperThreadingAdjustable |
boolean |
是否支持开关超线程。 |
true |
| NestedVirtualizationSupport |
string |
||
| JumboFrameSupport |
boolean |
是否支持巨型帧。 |
true |
| Clock |
object |
规格支持的时钟。 |
|
| PtpSupport |
string |
是否支持开启 PTP,可能值:
|
unsupported |
| Attributes |
object |
||
| Attribute |
array<object> |
规格属性列表。 |
|
|
object |
规格属性。 |
||
| Name |
string |
属性名。 |
VirtualIntelSpeedSelectTechnologySupport |
| Value |
string |
属性值。 |
1 |
| NetworkInfo |
object |
网络相关信息。 |
|
| BandwidthWeighting |
object |
规格支持的带宽权重 |
|
| WeightingInfos |
object |
||
| WeightingInfo |
array<object> |
带宽权重信息。需要在入参 AdditionalAttributes 中指定 NetworkInfo.BandwidthWeighting 时才返回该字段。 |
|
|
object |
|||
| Name |
string |
带宽权重名称 |
Default |
| VpcBandwidth |
integer |
网络基础带宽。单位:Kbit/s |
20480000 |
| VpcBurstBandwidth |
integer |
网络突发带宽,该规格不支持网络性能突发时不返回。单位:Kbit/s |
25600000 |
| EbsBandwidth |
integer |
存储基础带宽。单位:Kbit/s |
10000000 |
| EbsBurstBandwidth |
integer |
存储突发带宽,该规格不支持存储性能突发时不返回。单位:Kbit/s |
20000000 |
| 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,
"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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。