本介面主要用於查詢雲端伺服器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"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。