全部產品
Search

搜尋本產品

    Auto Scaling：DescribePatternTypes - 根據執行個體屬性查詢執行個體規格

    文件中心

    Auto Scaling：DescribePatternTypes - 根據執行個體屬性查詢執行個體規格

    更新時間：May 21, 2026

    調用DescribePatternTypes介面，並可以指定交換器的ID、執行個體的vCPU核心數、記憶體大小、規格類型系列層級以及可接受的最高價格等參數，篩選出符合要求的執行個體規格。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ess:DescribePatternTypes

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    所屬地區的 ID。

    cn-hangzhou
    VSwitchId

    array

    否

    交換器的 ID 列表。

    string

    否

    交換器的 ID。

    vsw-bp14zolna43z266bq****
    ZoneId

    array

    否

    可用性區域 ID 列表。當傳入交換器 ID 時，此參數無效。

    string

    否

    可用性區域 ID。

    cn-hangzhou-g
    SpotStrategy

    string

    否

    後付費執行個體的搶佔策略。取值範圍：

    • NoSpot：普通的隨用隨付執行個體。

    • SpotWithPriceLimit：設定上限價格的搶佔式執行個體。

    • SpotAsPriceGo：系統自動出價，跟隨當前市場實際價格。

    預設值：NoSpot。

    NoSpot
    Cores

    integer

    否

    執行個體規格的 vCPU 核心數目。

    2
    Memory

    number

    否

    執行個體規格的記憶體大小，單位為 GiB。

    4
    MaxPrice

    number

    否

    隨用隨付執行個體或者搶佔式執行個體可接受的每小時最高價格。

    2
    InstanceFamilyLevel

    string

    否

    執行個體規格類型系列層級。取值範圍：

    • EntryLevel：入門級。

    • EnterpriseLevel：企業級。

    • CreditEntryLevel：積分入門級。詳情請參見突發效能執行個體。

    EnterpriseLevel
    ExcludedInstanceType

    array

    否

    需要排除的執行個體規格。通過使用萬用字元（*）可以排除單個規格或者整個規格類型系列。例如：

    • ecs.c6.large：表示排除 ecs.c6.large 執行個體規格。

    • ecs.c6.*：表示排除整個 c6 規格類型系列的執行個體規格。

    說明

    如果需要排除多個執行個體規格，請使用分隔字元（/）隔開單個執行個體規格。例如ecs.n1.small/ecs.n1.*/*7*。

    string

    否

    需要排除的執行個體規格。通過使用萬用字元（*）可以排除單個規格或者整個規格類型系列。例如：

    • ecs.c6.large：表示排除 ecs.c6.large 執行個體規格。

    • ecs.c6.*：表示排除整個 c6 規格類型系列的執行個體規格。

    說明

    如果需要排除多個執行個體規格，請使用分隔字元（/）隔開單個執行個體規格。例如ecs.n1.small/ecs.n1.*/*7*。

    ecs.c6.xlarge
    Architecture

    array

    否

    執行個體規格所屬的架構類型。取值範圍：

    • X86：X86 計算。

    • Heterogeneous：異構計算，例如 GPU 或 FPGA 等。

    • BareMental：ECS Bare Metal Instance。

    • Arm：Arm 計算。

    預設值：包含所有架構類型。

    string

    否

    執行個體規格所屬的架構類型。取值範圍：

    • X86：X86 計算。

    • Heterogeneous：異構計算，例如 GPU 或 FPGA 等。

    • BareMetal：ECS Bare Metal Instance。

    • Arm：Arm 計算。

    預設值：包含所有架構類型。

    X86
    BurstablePerformance

    string

    否

    是否為效能突發執行個體規格。取值範圍：

    • Exclude：不包含效能突發執行個體規格。

    • Include：包含效能突發執行個體規格。

    • Required：只包含效能突發執行個體規格。

    預設值：Include。

    Include
    CoresList

    array

    否

    執行個體規格的 vCPU 核心數目，可以指定多個。

    integer

    否

    執行個體規格的 vCPU 核心數目，可以指定多個。

    2
    MemoryList

    array

    否

    執行個體規格的記憶體大小，單位為 GiB，可以指定多個。

    number

    否

    執行個體規格的記憶體大小，單位為 GiB，可以指定多個。

    4
    ChannelId

    integer

    否

    渠道 ID，內部保留參數。

    79425074
    InstanceTypeFamilies

    array

    否

    指定查詢的執行個體規格類型系列。N 表示可以設定多個執行個體規格類型系列，N 的取值範圍：1~10。

    string

    否

    指定查詢的執行個體規格類型系列。N 表示可以設定多個執行個體規格類型系列，N 的取值範圍：1~10。

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

    integer

    否

    執行個體規格的最小 vCPU 核心數目。

    2
    MaximumCpuCoreCount

    integer

    否

    執行個體規格的最大 vCPU 核心數目。

    4
    GpuSpecs

    array

    否

    GPU 類型。

    string

    否

    GPU 類型。

    ["NVIDIA V100"]
    InstanceCategories

    array

    否

    執行個體規格分類。取值範圍：

    • 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 ：ECS Bare Metal Instance。

    • High Performance Compute：高效能運算型。

    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 ：ECS Bare Metal Instance。

    • High Performance Compute：高效能運算型。

    ["Compute-optimized with GPU"]
    CpuArchitectures

    array

    否

    執行個體規格的 CPU 架構。取值範圍：

    說明

    N 表示可以設定多個 CPU 架構，N 的取值範圍：1~2。

    • X86。

    • ARM。

    string

    否

    執行個體規格的 CPU 架構。取值範圍：

    說明

    N 表示可以設定多個 CPU 架構，N 的取值範圍：1~2。

    • X86。

    • ARM。

    ["X86", "ARM"]
    PhysicalProcessorModels

    array

    否

    執行個體的處理器型號。N 表示可以設定多個處理器型號，N 的取值範圍：1~10。

    string

    否

    執行個體的處理器型號。N 表示可以設定多個處理器型號，N 的取值範圍：1~10。

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

    integer

    否

    執行個體最小支援掛載的彈性網卡上限。

    2
    MinimumEniPrivateIpAddressQuantity

    integer

    否

    執行個體最小單塊彈性網卡的 IPv4 地址上限。

    2
    MinimumEniIpv6AddressQuantity

    integer

    否

    執行個體最小單塊彈性網卡的 IPv6 地址上限。

    1
    MinimumInitialCredit

    integer

    否

    執行個體最小突發效能執行個體 t5、t6 的初始 vCPU 積分值。

    12
    MinimumBaselineCredit

    integer

    否

    執行個體最小突發效能執行個體 t5、t6 的基準 vCPU 計算效能（所有 vCPU 之和）。

    12
    MinimumMemorySize

    number

    否

    執行個體最小記憶體。單位：GiB。

    4
    MaximumMemorySize

    number

    否

    執行個體最大記憶體。單位：GiB。

    4
    MinimumGpuAmount

    integer

    否

    執行個體最小 GPU 數目。取值範圍：正整數。

    2
    MaximumGpuAmount

    integer

    否

    執行個體最大 GPU 數目。取值範圍：正整數。

    2

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    PatternTypes

    array<object>

    合格執行個體規格。

    object

    InstanceType

    string

    執行個體規格名稱。

    ecs.c7.xlarge
    InstanceFamilyLevel

    string

    執行個體規格類型系列層級。

    • EntryLevel：入門級，即共用型執行個體規格。成本更低，但是無法保證執行個體計算效能的穩定。適用於平時 CPU 使用率低的業務情境。更多資訊，請參見共用型。

    • EnterpriseLevel：企業級。效能穩定，資源獨享，適用於對穩定性要求高的業務情境。更多資訊，請參見執行個體規格類型系列。

    • CreditEntryLevel：積分入門級，即突發效能執行個體。通過 CPU 積分來保證計算效能，適用於平時 CPU 使用率低、偶有突發 CPU 使用率的情況。更多資訊，請參見突發效能執行個體。

    EnterpriseLevel
    InstanceTypeFamily

    string

    執行個體規格類型系列。

    ecs.c7
    Cores

    integer

    執行個體規格的 vCPU 核心數。

    4
    Memory

    number

    執行個體規格的記憶體大小，單位為 GiB。

    8

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PatternTypes": [
    {
      "InstanceType": "ecs.c7.xlarge",
      "InstanceFamilyLevel": "EnterpriseLevel",
      "InstanceTypeFamily": "ecs.c7",
      "Cores": 4,
      "Memory": 8
    }
  ]
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。