すべてのプロダクト
Search

このプロダクト

    Auto Scaling:DescribePatternTypes

    ドキュメントセンター

    Auto Scaling:DescribePatternTypes

    最終更新日:May 21, 2026

    インスタンスタイプを照会します。DescribePatternTypes オペレーションを呼び出す際、vSwitch ID、vCPU 数、メモリサイズ、インスタンスファミリー、上限価格などの属性を指定して、ビジネス要件を満たすインスタンスタイプを絞り込むことができます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ess:DescribePatternTypes

    list

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID。

    cn-hangzhou
    VSwitchId

    array

    任意

    vSwitch ID の配列。

    string

    任意

    vSwitch ID。

    vsw-bp14zolna43z266bq****
    ZoneId

    array

    任意

    ゾーン ID。vSwitch ID を指定した場合、このパラメーターは無効になります。

    string

    任意

    ゾーン ID。

    cn-hangzhou-g
    SpotStrategy

    string

    任意

    従量課金インスタンスに適用するプリエンプションポリシー。有効な値：

    • NoSpot： 通常の従量課金インスタンスとして作成されます。

    • SpotWithPriceLimit： ユーザー定義の上限価格を持つプリエンプティブルインスタンスとして作成されます。

    • SpotAsPriceGo： 購入時の市場価格が自動的に入札価格として使用されるプリエンプティブルインスタンスとして作成されます。

    デフォルト値： NoSpot。

    NoSpot
    Cores

    integer

    任意

    インスタンスタイプに割り当てる vCPU の数。

    2
    Memory

    number

    任意

    インスタンスタイプに割り当てるメモリサイズ (単位： GiB)。

    4
    MaxPrice

    number

    任意

    従量課金インスタンスまたはプリエンプティブルインスタンスの 1 時間あたりの上限価格。

    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 アクセラレーテッドなどのヘテロジニアスコンピューティング。

    • BareMetal： 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 の数。複数の vCPU 数を指定できます。

    integer

    任意

    インスタンスタイプに割り当てる vCPU の数。複数の vCPU 数を指定できます。

    2
    MemoryList

    array

    任意

    インスタンスタイプに割り当てるメモリサイズ (単位： GiB)。複数のメモリサイズを指定できます。

    number

    任意

    インスタンスタイプに割り当てるメモリサイズ (単位： GiB)。複数のメモリサイズを指定できます。

    4
    ChannelId

    integer

    任意

    チャネル ID。このパラメーターは公開用ではありません。

    79425074
    InstanceTypeFamilies

    array

    任意

    クエリ対象のインスタンスファミリー。1 回の呼び出しで 1～10 個のインスタンスファミリーをクエリできます。

    string

    任意

    クエリ対象のインスタンスファミリー。1 回の呼び出しで 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 アーキテクチャ。有効な値：

    説明

    1～2 個の CPU アーキテクチャを指定できます。

    • x86

    • Arm

    string

    任意

    インスタンスタイプの CPU アーキテクチャ。有効な値：

    説明

    1～2 個の CPU アーキテクチャを指定できます。

    • x86

    • Arm

    ["X86", "ARM"]
    PhysicalProcessorModels

    array

    任意

    インスタンスタイプのプロセッサモデル。1～10 個のプロセッサモデルを指定できます。

    string

    任意

    インスタンスタイプのプロセッサモデル。1～10 個のプロセッサモデルを指定できます。

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

    integer

    任意

    インスタンスあたりの Elastic Network Interface (ENI) の最小数。

    2
    MinimumEniPrivateIpAddressQuantity

    integer

    任意

    ENI あたりの IPv4 アドレスの最小数。

    2
    MinimumEniIpv6AddressQuantity

    integer

    任意

    ENI あたりの 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

    レスポンスのスキーマ

    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 使用率が低いものの、特定のケースでは変動する可能性があるシナリオに適しています。詳細については、「バーストパフォーマンスインスタンスの概要」をご参照ください。

    EnterpriseLevel
    InstanceTypeFamily

    string

    インスタンスファミリー。

    ecs.c7
    Cores

    integer

    インスタンスタイプに割り当てられる vCPU 数。

    4
    Memory

    number

    インスタンスタイプに割り当てられるメモリサイズ。単位：GiB。

    8

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。