すべてのプロダクト
Search

このプロダクト

    Auto Scaling:DescribePatternTypes

    ドキュメントセンター

    Auto Scaling:DescribePatternTypes

    最終更新日:Sep 17, 2026

    インスタンス属性を指定してスケーリング設定を構成する際に、vCPU 数、メモリサイズ、インスタンスファミリーレベル、許容される最大値などの指定されたインスタンス属性に一致するインスタンスタイプを照会します。この操作では DescribePatternTypes API オペレーションを呼び出します。

    今すぐお試しください

    この 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: エントリーレベル。共有インスタンスタイプを指します。これらのインスタンスタイプはコスト効率に優れていますが、安定したコンピューティングパフォーマンスは保証されません。CPU 使用率が低いシナリオに適しています。詳細については、「共有インスタンスタイプ」を参照してください。

    • EnterpriseLevel: エンタープライズレベル。これらのインスタンスタイプは安定したパフォーマンスと専用リソースを提供します。高い安定性が求められるシナリオに適しています。詳細については、「インスタンスファミリー」を参照してください。

    • CreditEntryLevel: クレジットベースのエントリーレベル。バースト可能インスタンスを指します。これらのインスタンスタイプは CPU クレジットを使用してコンピューティングパフォーマンスを確保します。CPU 使用率が通常は低く、時折バーストが発生するシナリオに適しています。詳細については、「バースト可能インスタンス」を参照してください。

    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: Elastic Compute Service ベアメタルインスタンスサーバー。

    • Arm: Arm コンピューティング。

    デフォルト値: すべてのアーキテクチャタイプ。

    string

    任意

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

    • X86: x86 コンピューティング。

    • Heterogeneous: ヘテロジニアスコンピューティング (GPU や FPGA など)。

    • BareMental: Elastic Compute Service ベアメタルインスタンスサーバー。

    • 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
    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: Elastic Compute Service ベアメタルインスタンスサーバー。

    • High Performance Compute: ハイパフォーマンスコンピューティング (HPC)。

    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: Elastic Compute Service ベアメタルインスタンスサーバー。

    • High Performance Compute: ハイパフォーマンスコンピューティング (HPC)。

    Compute-optimized with GPU
    CpuArchitectures

    array

    任意

    インスタンスタイプの CPU アーキテクチャ。

    string

    任意

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

    説明

    N は複数の CPU アーキテクチャを設定できることを示します。N の有効な値: 1～2。

    • X86。

    • ARM。

    X86
    PhysicalProcessorModels

    array

    任意

    インスタンスのプロセッサモデル。N は複数のプロセッサモデルを設定できることを示します。N の有効な値: 1～10。

    string

    任意

    インスタンスのプロセッサモデル。N は複数のプロセッサモデルを設定できることを示します。N の有効な値: 1～10。

    Intel Xeon(Ice Lake) Platinum 8369B
    MinimumEniQuantity

    integer

    任意

    インスタンスにアタッチできるエラスティックネットワークインターフェイス (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
    }
  ]
}

    エラーコード

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

    変更履歴

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