すべてのプロダクト
Search
ドキュメントセンター

Auto Scaling:CreateScalingConfiguration

最終更新日:Sep 17, 2026

スケーリンググループ ID、インスタンスタイプ、インスタンスイメージなどの情報を指定して CreateScalingConfiguration 操作の呼び出しにより、スケーリンググループ用の ECS タイプのスケーリング設定を作成します。

操作説明

操作の説明

スケーリング設定は、エラスティックスケールアウトに使用される ECS インスタンステンプレートを指定します。以下のインスタンス設定メソッドがサポートされています。

  • InstancePatternInfo.N: インテリジェント設定モード。特定のインスタンスタイプを指定する必要はありません。ビジネス要件に基づいて、vCPU 数、メモリサイズ、インスタンスファミリーレベル、最大値を指定するだけです。システムは要件を満たすインスタンスタイプを自動的にフィルターし、最も価格の低いインスタンスタイプを優先的に選択して ECS インスタンスを作成します。このモードは、ネットワークタイプが VPC のスケーリンググループにのみ適用され、スケールアウト時のインスタンスタイプの在庫不足のリスクを効果的に低減できます。

  • InstanceType: 単一のインスタンスタイプを指定します。

  • InstanceTypes.N: 複数のインスタンスタイプを指定します。

  • InstanceTypeOverride.N: 複数のインスタンスタイプを指定し、異なるインスタンスタイプに重みを設定します。

  • Cpu および Memory: vCPU とメモリの有効値を指定してインスタンスタイプを定義します。Auto Scaling は、I/O 最適化やゾーンなどの要因に基づいて利用可能なインスタンスタイプを決定し、価格が最も低いインスタンスを価格順に作成します。このメソッドは、スケーリンググループのスケーリングポリシーがコスト最適化であり、スケーリング設定でインスタンスタイプが指定されていない場合にのみ適用されます。

  • 以下のいずれかのメソッドを使用してプライマリネットワークインターフェイスを構成できます。ただし、API 呼び出しごとに使用できるメソッドは 1 つだけです。両方のメソッドを同じ時間に使用すると、呼び出しは失敗し、エラーメッセージが返されます。

    • SecurityGroupId、SecurityGroupIds.N、Ipv6AddressCount などのパラメーターを使用して、プライマリネットワークインターフェイスを直接構成します。

    • NetworkInterfaces.N を使用して、プライマリおよびセカンダリネットワークインターフェイスを構成します。このパラメーターを使用する場合は、プライマリネットワークインターフェイスを構成する必要があります。NetworkInterfaces.N.InstanceType が Primary に設定されている場合、プライマリネットワークインターフェイスが構成されます。NetworkInterfaces.N.InstanceType が Secondary に設定されているか、空の場合、セカンダリネットワークインターフェイスが構成されます。

説明

InstanceType、InstanceTypes.N、InstanceTypeOverride.N、および Cpu と Memory の 4 つのメソッドを同じ時間に指定することはできません。ただし、InstanceType または InstanceTypes.N を InstancePatternInfo.N と一緒に指定することはできます。InstancePatternInfo.N と一緒に指定した場合、Auto Scaling はスケールアウトに指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプが在庫切れの場合、InstancePatternInfo.N 設定に一致するインスタンスタイプが使用されます。

今すぐお試しください

この 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:CreateScalingConfiguration

create

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingGroupId

string

必須

スケーリング設定が属するスケーリンググループの ID。

asg-bp14wlu85wrpchm0****

ImageId

string

任意

イメージファイルの ID。イメージは ECS インスタンスの自動作成に使用されます。

説明

このパラメーターは ImageName パラメーターと同じ効果を持ちます。いずれか一方のみをセットできます。ImageName パラメーターをセットした場合、ImageId パラメーターは無視されます (オプション)。

centos6u5_64_20G_aliaegis****.vhd

ImageName

string

任意

イメージファイルの名前。イメージ名はリージョン内で一意です。このパラメーターを使用して Alibaba Cloud Marketplace のイメージを指定することはできません。

説明

このパラメーターは ImageId パラメーターと同じ効果を持ちます。いずれか一方のみをセットできます。ImageId パラメーターをセットした場合、ImageName パラメーターは無視されます (オプション)。

イメージ****

InstanceType

string

任意

ECS インスタンスのインスタンスタイプ。詳細については、「Instance families」を参照してください。

説明

InstanceType、InstanceTypes、InstanceTypeOverrides、および Cpu と Memory の 4 つのメソッドを同じ時間に指定することはできません。ただし、API 呼び出し時に InstanceType を InstancePatternInfo と一緒に指定することはできます。この場合、Auto Scaling はスケールアウトに指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプが在庫切れの場合、InstancePatternInfo 設定に一致するインスタンスタイプが使用されます。

ecs.g6.large

Cpu

integer

任意

vCPU の数。単位: コア。

Cpu と Memory の両方を指定して、インスタンスタイプの有効値を定義できます。たとえば、Cpu を 2、Memory を 16 にセットすると、2 vCPU と 16 GiB のメモリを持つすべてのインスタンスタイプを定義できます。Auto Scaling は、I/O 最適化やゾーンなどの要因に基づいて利用可能なインスタンスタイプを決定し、価格が最も低いインスタンスを価格順に作成します。

説明

この設定は、コスト最適化モードが有効になっており、スケーリング設定でインスタンスタイプが指定されていない場合にのみ効果があります。

2

Memory

integer

任意

メモリサイズ。単位: GiB。

Cpu と Memory の両方を指定して、インスタンスタイプの有効値を定義できます。たとえば、Cpu を 2、Memory を 16 にセットすると、2 vCPU と 16 GiB のメモリを持つすべてのインスタンスタイプを定義できます。Auto Scaling は、I/O 最適化やゾーンなどの要因に基づいて利用可能なインスタンスタイプを決定し、価格が最も低いインスタンスを価格順に作成します。

説明

この設定は、コスト最適化モードが有効になっており、スケーリング設定でインスタンスタイプが指定されていない場合にのみ効果があります。

16

DeploymentSetId

string

任意

ECS インスタンスが属するデプロイメントセットの ID。

ds-bp1frxuzdg87zh4pz****

SecurityGroupId

string

任意

ECS インスタンスが属するセキュリティグループの ID。同じセキュリティグループ内の ECS インスタンスは相互にアクセスできます。

sg-280ih****

IoOptimized

string

任意

インスタンスが I/O 最適化インスタンスであるかどうかを指定します。有効な値:

  • none: インスタンスは I/O 最適化インスタンスではありません。

  • optimized: インスタンスは I/O 最適化インスタンスです。

retired instance types のインスタンスの場合、デフォルト値は none です。その他のインスタンスタイプのインスタンスの場合、デフォルト値は optimized です。

optimized

InternetChargeType

string

任意

ネットワーク使用量の課金方法。有効な値:

  • PayByBandwidth: 帯域幅課金。InternetMaxBandwidthOut の値が固定帯域幅値として使用されます。

  • PayByTraffic: トラフィック課金。InternetMaxBandwidthOut の値が最大値として使用されます。課金は実際のネットワークトラフィックに基づいて行われます。

このパラメーターが指定されていない場合、クラシックネットワークのデフォルト値は PayByBandwidth、VPC のデフォルト値は PayByTraffic です。

PayByTraffic

InternetMaxBandwidthIn

integer

任意

最大インバウンドパブリック帯域幅。単位: Mbit/s。有効な値:

  • 最大アウトバウンドパブリック帯域幅が 10 Mbit/s 以下の場合: 1~10。デフォルト値: 10。

  • 最大アウトバウンドパブリック帯域幅が 10 Mbit/s より大きい場合: 1~InternetMaxBandwidthOut の値。デフォルト値: InternetMaxBandwidthOut の値。

10

InternetMaxBandwidthOut

integer

任意

最大アウトバウンドパブリック帯域幅。単位: Mbit/s。有効な値: 0~100。

デフォルト値: 0。

10

SystemDisk.Category

string

任意

システムクラウドディスクのカテゴリ。有効な値:

  • cloud: 基本クラウドディスク。

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_essd: ESSD (エンタープライズ SSD)。

  • cloud_auto: ESSD AutoPL クラウドディスク。

このパラメーターは SystemDiskCategories.N と一緒に指定できません。このパラメーターも SystemDiskCategories.N も指定されていない場合、デフォルト値が使用されます。インスタンスタイプがシリーズ I のインスタンスタイプであり、インスタンスが I/O 最適化インスタンスではない場合、デフォルト値は cloud です。それ以外の場合、デフォルト値は cloud_efficiency です。

cloud_ssd

SystemDisk.Size

integer

任意

システムクラウドディスクのサイズ。単位: GiB。有効な値:

  • 基本クラウドディスク: 20~500。

  • ESSD:
    • PL0: 1~2048。

    • PL1: 20~2048。

    • PL2: 461~2048。

    • PL3: 1261~2048。

  • ESSD AutoPL クラウドディスク: 1~2048。

  • その他のクラウドディスクタイプ: 20~2048。

このパラメーターの値は max{1, ImageSize} 以上である必要があります。

デフォルト値: max{40, ImageSize}。

100

SystemDisk.DiskName

string

任意

システムクラウドディスクの名前。名前は 2~128 文字で、英字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。名前は英字または漢字で始める必要があり、http:// または https:// で始めることはできません。

cloud_ssdSystem

SystemDisk.Description

string

任意

システムクラウドディスクの説明。説明は 2~256 文字で、http:// または https:// で始めることはできません。

テストシステムディスク

SystemDisk.AutoSnapshotPolicyId

string

任意

システムクラウドディスクに適用される自動スナップショットポリシーの ID。

sp-bp12m37ccmxvbmi5****

SystemDisk.PerformanceLevel

string

任意

ディスクが標準 SSD の場合のシステムクラウドディスクのパフォーマンスレベル (PL) の設定項目。有効な値:

  • PL0: 単一の ESSD で最大 10,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL1: 単一の ESSD で最大 50,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL2: 単一の ESSD で最大 100,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL3: 単一の ESSD で最大 1,000,000 のランダム読み取り/書き込み IOPS を配信できます。

デフォルト値: PL1。

説明

ESSD のパフォーマンスレベルの選択方法の詳細については、「 ESSDs 」を参照してください。

PL1

ScalingConfigurationName

string

任意

スケーリング設定の名前。名前は 2~64 文字で、英字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を含めることができます。名前は英字、数字、または漢字で始める必要があります。

名前は、同じリージョン内の同じスケーリンググループにあるスケーリング設定間で一意である必要があります。このパラメーターを指定しない場合、デフォルトでスケーリング設定 ID が使用されます。

スケーリングconfig****

LoadBalancerWeight

integer

任意

関連付けられたロードバランサーインスタンスのバックエンドサーバーとしての ECS インスタンスの重み。有効な値: 1~100。

デフォルト値: 50。

50

Tags

string

任意

ECS インスタンスのタグ。タグはキーと値のペアとして指定されます。最大 20 個のタグを指定できます。タグキーと値には以下の制限が適用されます。

  • タグキーは最大 64 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。タグキーを空の文字列にすることはできません。

  • タグ値は最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。タグ値は空の文字列にすることができます。

{"キー1":"値1","キー2":"値2", ... "キー5":"値5"}

UserData

string

任意

ECS インスタンスのユーザーデータ。データは Base64 でエンコーディングされている必要があります。エンコーディング前の生データの最大値は 32 KB です。

ZWNobyBoZWxsbyBlY3Mh

KeyPairName

string

任意

ECS インスタンスへのログインに使用されるキーペアの名前。

  • Windows インスタンスの場合、このパラメーターは無視され、デフォルトで空になります。

  • Linux インスタンスの場合、初期化時にパスワードベースのログインが無効になります。

KeyPairTest

RamRoleName

string

任意

ECS インスタンスに関連付けられた RAM ロールの名前。名前は RAM によって提供および管理されます。 ListRoles を呼び出して、利用可能な RAM ロールをクエリできます。RAM ロールの作成方法の詳細については、「 CreateRole 」を参照してください。

ramロール****

SecurityEnhancementStrategy

string

任意

セキュリティ強化を有効にするかどうかを指定します。有効な値:

  • Active: セキュリティ強化がアクティブな状態です。この値はパブリックイメージにのみ適用されます。

  • Deactive: セキュリティ強化が無効です。この値はすべてのイメージタイプに適用されます。

Active

InstanceName

string

任意

スケーリング設定を使用した自動作成によって作成される ECS インスタンスの名前。

インスタンス****

HostName

string

任意

ECS インスタンスのホスト名。ピリオド (.) またはハイフン (-) を最初または最後の文字として使用したり、連続して使用したりすることはできません。命名規則はインスタンスタイプによって異なります。

  • Windows インスタンス: ホスト名は 2~15 文字で、英字、数字、ハイフン (-) を含めることができます。ホスト名にピリオド (.) を含めたり、すべて数字にしたりすることはできません。

  • その他のインスタンス (Linux など): ホスト名は 2~64 文字で、複数のピリオド (.) を含めることができます。2 つのピリオド (.) の間の各セグメントには、英字、数字、ハイフン (-) を含めることができます。

ホスト****

SpotStrategy

string

任意

従量課金インスタンスのプリエンプションポリシー。有効な値:

  • NoSpot: 通常の従量課金インスタンス。

  • SpotWithPriceLimit: ユーザー定義の最大時間単価を持つスポットインスタンス。

  • SpotAsPriceGo: 購入時の市場価格で価格設定されたスポットインスタンス。

デフォルト値: NoSpot。

NoSpot

PasswordInherit

boolean

任意

イメージにプリセットされたパスワードを使用するかどうかを指定します。このパラメーターを使用するには、イメージにパスワードが設定されていることを確認してください。有効な値:

  • true: イメージのプリセットパスワードが使用されます。

  • false: イメージのプリセットパスワードは使用されません。

false

Password

string

任意

ECS インスタンスのパスワード。パスワードは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。以下の特殊文字がサポートされています。

()` ~!@#$%^&*-_+=\|{}[]:;'<>,.?/

Windows インスタンスの場合、パスワードをスラッシュ (/) で始めることはできません。

説明

Password パラメーターを指定する場合は、パスワードの漏洩を防ぐために HTTPS を使用してリクエストを送信してください。

123abc****

ResourceGroupId

string

任意

ECS インスタンスが属するリソースグループの ID。

rg-リソース****

HpcClusterId

string

任意

ECS インスタンスが属する HPC クラスターの ID。

hpc-クラスターid

InstanceDescription

string

任意

ECS インスタンスの説明。説明は 2~256 文字で、http:// または https:// で始めることはできません。

テストインスタンス

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。

クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認してください。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「How to ensure idempotence」を参照してください。

123e4567-e89b-12d3-a456-42665544****

Ipv6AddressCount

integer

任意

ネットワークインターフェイスに割り当てられるランダムに生成された IPv6 アドレスの数。

1

CreditSpecification

string

任意

バースト可能インスタンスの実行パターン。有効な値:

  • Standard: 標準パターン。

  • Unlimited: 無制限版。

詳細については、「バースト可能インスタンスの概要」のパフォーマンススキーマセクションを参照してください。

標準

ImageFamily

string

任意

イメージ ファミリーの名前。このパラメーターをセットして、指定されたイメージ ファミリーからインスタンス作成用の最新の利用可能なイメージを読み取り、インスタンスを作成できます。ImageId パラメーターがすでに指定されている場合、このパラメーターはセットできません。

hangzhou-daily-update

ZoneId

string

任意

ECS インスタンスのゾーン ID。

cn-hangzhou-g

DedicatedHostId

string

任意

ECS インスタンスを専用ホスト上に作成するかどうかを指定します。専用ホストはスポットインスタンスの作成をサポートしていないため、DedicatedHostId パラメーターを指定すると、リクエスト内の SpotStrategy および SpotPriceLimit のセットは自動的に無視されます。

DescribeDedicatedHosts を呼び出して、専用ホスト ID のリストをクエリできます。

dh-bp67acfmxazb4p****

Affinity

string

任意

専用ホスト上のインスタンスが専用ホストに関連付けられているかどうかを指定します。有効な値:

  • default: インスタンスは専用ホストに関連付けられていません。節約モードが有効になっているインスタンスが再起動されると、元の専用ホストの利用可能なリソースが不足している場合、インスタンスは自動 Deployment リソースプール内の別の専用ホストに配置される可能性があります。

  • host: インスタンスは専用ホストに関連付けられています。節約モードが有効になっているインスタンスが再起動されると、インスタンスは元の専用ホスト上に残ります。元の専用ホストの利用可能なリソースが不足している場合、インスタンスの再起動は失敗します。

デフォルト値: default。

デフォルト

Tenancy

string

任意

インスタンスを専用ホスト上に作成するかどうかを指定します。有効な値:

  • default: インスタンスは専用ホスト上には作成されません。

  • host: インスタンスは専用ホスト上に作成されます。API 呼び出しで DedicatedHostId パラメーターを指定しない場合、Alibaba Cloud はインスタンス用の専用ホストを自動的に選択します。

デフォルト値: default。

デフォルト

SchedulerOptions

object

任意

スケジューラオプション。

["testManagedPrivateSpaceId****"]

PrivatePoolOptions.MatchCriteria

string

任意

インスタンス起動用の非公開プールオプション。エラスティシティ保証またはキャパシティ予約が効果を持つと、起動時にインスタンスが使用するための非公開プールが生成されます。有効な値:

  • Open: オープンモード。システムは利用可能なオープン非公開プール容量を自動的にマッチングします。一致する非公開プール容量が利用できない場合、パブリックプールリソースが使用されます。このモードでは、API 呼び出し時に PrivatePoolOptions.Id パラメーターをセットする必要はありません。

  • Target: 指定モード。インスタンスは、指定された非公開プールの容量を使用して起動します。指定された非公開プール容量が利用できない場合、インスタンスの起動は失敗します。このモードでは、非公開プール ID を指定する必要があります。PrivatePoolOptions.Id パラメーターは必須です。

  • None: なしモード。インスタンスは非公開プール容量を使用せずに起動します。

Open

PrivatePoolOptions.Id

string

任意

非公開プール ID。エラスティシティ保証またはキャパシティ予約の ID です。

eap-bp67acfmxazb4****

SpotDuration

integer

任意

スポットインスタンスの保持期間。単位: 時間。有効な値:

  • 1: インスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間自動的にリリースされないことを保証します。1 時間後、システムは入札価格とマーケットプレイス価格を自動的に比較し、リソース在庫を確認して、インスタンスを保持するか取り消すかを決定します。

  • 0: インスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間実行されることを保証しません。システムは入札価格とマーケットプレイス価格を自動的に比較し、リソース在庫を確認して、インスタンスを保持するか取り消すかを決定します。

説明

Alibaba Cloud は、インスタンスが取り消される 5 分前に ECS システムイベント通知を送信します。スポットインスタンスは秒単位で課金されます。API 呼び出し時に、予想されるタスク実行時間に基づいて、適切な保持期間を選択してください。

デフォルト値: 1。

1

SpotInterruptionBehavior

string

任意

スポットインスタンスの中断パターン。Terminate (デフォルト) のみがサポートされており、インスタンスを直接リリースします。

Terminate

InstanceTypes

array

任意

インスタンスタイプ。

ecs.g6.large

string

任意

インスタンスタイプ。N の有効な値: 1~20。スケーリング設定で最大 20 個のインスタンスタイプを指定できます。

N の値はインスタンスタイプの優先度を示します。N の値が小さいほど優先度が高くなります。最も優先度の高いインスタンスタイプを使用してインスタンスを作成できない場合、Auto Scaling は自動的に次に優先度の高いインスタンスタイプを使用します。

説明

InstanceType、InstanceTypes、InstanceTypeOverrides、および Cpu と Memory の 4 つの方法を同時に指定することはできません。ただし、API 呼び出し時に InstanceTypes を InstancePatternInfo と一緒に指定することはできます。この場合、Auto Scaling はスケールアウトに指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプの在庫がない場合、InstancePatternInfo 設定に一致するインスタンスタイプが使用されます。

ecs.g6.large

InstanceTypeOverride

array<object>

任意

インスタンスタイプ情報。

object

任意

インスタンスタイプ情報。

InstanceType

string

任意

スケーリング設定内のインスタンスタイプの容量を指定するには、このパラメーターと InstanceTypeOverride.N.WeightedCapacity の両方を指定します。

このパラメーターはインスタンスタイプを指定します。このパラメーターには N 個の値を指定できます。InstanceTypeOverride.N.WeightedCapacity パラメーターと組み合わせることで、カスタム重みを持つマルチインスタンスタイプサポートの拡張を提供します。N の有効な値: 1~20。

説明

このパラメーターは、InstanceTypes.N または InstanceType と一緒に指定できません。

InstanceType の有効な値: 購入可能な ECS インスタンスタイプ。詳細については、「インスタンスファミリー」を参照してください。

ecs.c5.xlarge

WeightedCapacity

integer

任意

スケーリング設定内のインスタンスタイプの容量を指定するには、まず InstanceTypeOverride.N.InstanceType を指定し、次にこのパラメーターを指定します。2 つのパラメーターは 1 対 1 で対応していることが必須であり、N の値は一致している必要があります。

このパラメーターはインスタンスタイプの重みを指定します。これは、スケーリンググループ内のこのタイプの単一インスタンスの容量を表します。重みが大きいほど、予想される容量を満たすために必要なこのタイプのインスタンス数が少なくなります。

インスタンスタイプは vCPU 数、メモリサイズ、その他のパフォーマンスメトリクスが異なる場合があるため、要件に基づいて異なるインスタンスタイプに異なる重みを設定できます。

例:

  • 現在の容量: 0。

  • 予想されるインスタンス数: 6。

  • ecs.c5.xlarge の容量: 4。

予想される容量を満たすために、スケーリンググループは 2 個の ecs.c5.xlarge インスタンスをスケールアウトします。

説明

スケールアウト中、スケーリンググループの容量は、最大容量 (MaxSize) とインスタンスタイプの最大重みの合計を超えることはできません。

WeightedCapacity の有効な値: 1~500。

4

DataDisk

array<object>

任意

データクラウドディスク情報。

object

任意

データクラウドディスク情報。

PerformanceLevel

string

任意

ディスクが標準 SSD の場合のデータクラウドディスクのパフォーマンスレベル (PL) の設定項目。N の値は DataDisk.N.Category=cloud_essd の N と一致している必要があります。有効な値:

  • PL0: 単一の ESSD で最大 10,000 のランダム読み取り/書き込み IOPS を実現できます。

  • PL1: 単一の ESSD で最大 50,000 のランダム読み取り/書き込み IOPS を実現できます。

  • PL2: 単一の ESSD で最大 100,000 のランダム読み取り/書き込み IOPS を実現できます。

  • PL3: 単一の ESSD で最大 1,000,000 のランダム読み取り/書き込み IOPS を実現できます。

デフォルト値: PL1。

説明

ESSD のパフォーマンスレベルの選択方法の詳細については、「 ESSD 」を参照してください。

PL1

AutoSnapshotPolicyId

string

任意

データクラウドディスク N に適用される自動スナップショットポリシーの ID。N の有効な値: 1~16。

sp-bp19nq9enxqkomib****

Encrypted

string

任意

データクラウドディスク N を暗号化するかどうかを指定します。N の有効な値: 1~16。有効な値:

  • true: 暗号化されています。

  • false: 暗号化されていません。

デフォルト値: false。

false

Description

string

任意

データクラウドディスク N の説明。N の有効な値: 1~16。説明は 2~256 文字で、http:// または https:// で始めることはできません。

テストデータディスク

SnapshotId

string

任意

データクラウドディスク N の作成に使用されるスナップショットの ID。N の有効な値: 1~16。このパラメーターが指定されると、DataDisk.N.Size は無視され、作成されるディスクのサイズは指定されたスナップショットのサイズになります。

スナップショットが 2013 年 7 月 15 日以前に作成された場合、呼び出しは拒否され、エラーメッセージ InvalidSnapshot.TooOld が返されます。

s-280s7****

Categories

array

任意

データクラウドディスク N のディスクタイプ。最初の N は N 番目のデータクラウドディスクを示します。有効な値: 1~16。2 番目の N はデータクラウドディスクの N 番目のディスクタイプを示します。有効な値: 1~4。API 呼び出し時に、スケーリング設定内のデータクラウドディスクに対して最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は自動的に次のディスクタイプを試してデータクラウドディスクを作成します。有効な値:

  • cloud: 基本クラウドディスク。インスタンスと一緒に作成された基本クラウドディスクの DeleteWithInstance プロパティは true にセットされます。

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_auto: ESSD AutoPL クラウドディスク。

  • cloud_regional_disk_auto: リージョン ESSD。

説明

このパラメーターは DataDisk.N.Category と一緒に指定できません。

cloud

string

任意

データクラウドディスク N のディスクタイプ。最初の N は N 番目のデータクラウドディスクを示します。有効な値: 1~16。2 番目の N はデータクラウドディスクの N 番目のディスクタイプを示します。有効な値: 1~4。API 呼び出し時に、スケーリング設定内のデータクラウドディスクに対して最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は自動的に次のディスクタイプを試してデータクラウドディスクを作成します。有効な値:

  • cloud: 基本クラウドディスク。インスタンスと一緒に作成された基本クラウドディスクの DeleteWithInstance プロパティは true にセットされます。

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_auto: ESSD AutoPL クラウドディスク。

  • cloud_regional_disk_auto: リージョン ESSD。

説明

このパラメーターは DataDisk.N.Category と一緒に指定できません。

cloud

Size

integer

任意

データクラウドディスク N のサイズ。N の有効な値: 1~16。単位: GiB。有効な値:

  • cloud: 5~2000。

  • cloud_efficiency: 20~32768。

  • cloud_ssd: 20~32768。

  • cloud_essd: 20~32768。

  • ephemeral_ssd: 5~800。

このパラメーターが指定された後、ディスクサイズはスナップショットのサイズ (スナップショットは SnapshotId で指定) 以上である必要があります。

100

Device

string

任意

データクラウドディスク N のマウントポイント。N の有効な値: 1~16。このパラメーターを指定しない場合、ECS インスタンスの自動作成時のデフォルトの動作では、システムがマウントポイントを割り当てます。マウントポイントの有効値は /dev/xvdb から /dev/xvdz です。

/dev/xvdb

DiskName

string

任意

データクラウドディスク N の名前。N の有効な値: 1~16。名前は 2~128 文字で、英字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。名前は英字または漢字で始める必要があり、http:// または https:// で始めることはできません。

cloud_ssdData

Category

string

任意

データクラウドディスク N のカテゴリ。N の有効な値: 1~16。有効な値:

  • cloud: 基本クラウドディスク。インスタンスと一緒に作成された基本クラウドディスクの DeleteWithInstance プロパティは true にセットされます。

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_auto: ESSD AutoPL クラウドディスク。

  • cloud_regional_disk_auto: リージョン ESSD。

このパラメーターは DataDisk.N.Categories.N と一緒に指定できません。このパラメーターも DataDisk.N.Categories.N も指定されていない場合、デフォルト値が使用されます。

  • I/O 最適化インスタンスの場合、デフォルト値は cloud_efficiency です。

  • 非 I/O 最適化インスタンスの場合、デフォルト値は cloud です。

cloud_ssd

DeleteWithInstance

boolean

任意

インスタンスがリリースされるときにデータクラウドディスク N をリリースするかどうかを指定します。N の有効な値: 1~16。有効な値:

  • true: インスタンスがリリースされるときにディスクもリリースされます。

  • false: インスタンスがリリースされるときにディスクは保持されます。

このパラメーターは、独立したクラウドディスク (DataDisk.N.Category が cloud、cloud_efficiency、cloud_ssd、cloud_essd、または cloud_auto に設定されている) に対してのみ設定できます。それ以外の場合はエラーが返されます。

デフォルト値: true。

true

KMSKeyId

string

任意

データクラウドディスク N の KMS キーの ID。N の有効な値: 1~16。

0e478b7a-4262-4802-b8cb-00d3fb40****

ProvisionedIops

integer

任意

データクラウドディスクのプロビジョニングされた IOPS (Input/Output Operations Per Second) パフォーマンスメトリクス。

説明

IOPS (Input/Output Operations Per Second) は、ブロックストレージデバイスが 1 秒間にプロセスできる読み取りおよび書き込み (出力/入力) 操作の数を測定します。単位: 操作/秒。

100

BurstingEnabled

boolean

任意

データクラウドディスクのバースト機能を有効にするかどうかを指定します。有効な値:

  • true: 有効。

  • false: 無効。

説明

このパラメーターは、DataDisk.Categorycloud_auto にセットされている場合にのみサポートされます。

詳細については、「ESSD AutoPL クラウドディスク」を参照してください。

false

SpotPriceLimit

array<object>

任意

スポットインスタンス情報。

object

任意

スポットインスタンス情報。

PriceLimit

number

任意

スポットインスタンスの入札価格。N の有効な値: 1~20。このパラメーターは、SpotStrategy が SpotWithPriceLimit にセットされている場合にのみ効果があります。

0.5

InstanceType

string

任意

スポットインスタンスのインスタンスタイプ。N の有効な値: 1~20。このパラメーターは、SpotStrategy が SpotWithPriceLimit にセットされている場合にのみ効果があります。

ecs.g6.large

SecurityGroupIds

array

任意

ECS インスタンスが追加されるセキュリティグループの ID。N の有効な値は、インスタンスが属することができるセキュリティグループの最大値によって異なります。詳細については、「使用制限」のセキュリティグループセクションを参照してください。

説明

SecurityGroupId と SecurityGroupIds.N の両方を指定することはできません。

sg-bp18kz60mefs****

string

任意

ECS インスタンスが追加されるセキュリティグループの ID。N の有効な値は、インスタンスが属することができるセキュリティグループの最大値によって異なります。詳細については、「使用制限」のセキュリティグループセクションを参照してください。

説明

SecurityGroupId と SecurityGroupIds.N の両方を指定することはできません。

sg-bp18kz60mefs****

InstancePatternInfo

array<object>

任意

インテリジェントモードでのインスタンスタイプ関連情報。

object

任意

インテリジェントモードでのインスタンスタイプ関連情報。

Cores

integer

任意

インテリジェント構成モードでのインスタンスタイプの vCPU コア数。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。詳細については、「Instance families」を参照してください。N の有効値: 1~10。

次の項目に注意してください。

  • InstancePatternInfo.N パラメーターは、ネットワークタイプが VPC (Virtual Private Cloud) のスケーリンググループにのみ適用されます。

  • InstancePatternInfo.N パラメーターを使用する場合は、InstancePatternInfo.N.Cores と InstancePatternInfo.N.Memory の両方を指定する必要があります。

  • InstanceType または InstanceTypes.N パラメーターを使用してインスタンスタイプを指定している場合、Auto Scaling はスケールアウト時に指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプが在庫切れの場合、Auto Scaling は InstancePatternInfo.N パラメーターの値に一致するインスタンスタイプの中から最も低価格のインスタンスタイプをスケールアウトに使用します。

2

InstanceFamilyLevel

string

任意

インテリジェント構成モードでのインスタンスファミリーレベル。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。有効な値:

  • EntryLevel: エントリーレベル。共有インスタンスタイプを指します。これらのインスタンスタイプは低コストですが、安定インスタンスのコンピューティングパフォーマンスを保証できません。CPU 使用率が低いシナリオに適しています。詳細については、「Shared instance families」を参照してください。

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

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

N の有効値: 1~10。

EnterpriseLevel

MaxPrice

number

任意

インテリジェント構成モードでの従量課金インスタンスまたはスポットインスタンスの 1 時間あたりの最大価格。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。N の有効値: 1~10。

説明

SpotStrategy が SpotWithPriceLimit にセットされている場合、このパラメーターは必須です。それ以外の場合、このパラメーターはオプションです。

2

Memory

number

任意

インテリジェント構成モードでのインスタンスタイプのメモリサイズ。単位: GiB。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。詳細については、「Instance families」を参照してください。N の有効値: 1~10。

4

ExcludedInstanceType

array

任意

除外するインスタンスタイプ。ワイルドカード文字 (*) を使用して、単一のインスタンスタイプまたはインスタンスファミリー全体を除外できます。例:

  • ecs.c6.large: ecs.c6.large インスタンスタイプを除外します。

  • ecs.c6.*: c6 インスタンスファミリー全体を除外します。

string

任意

除外するインスタンスタイプ。ワイルドカード文字 (*) を使用して、単一のインスタンスタイプまたはインスタンスファミリー全体を除外できます。例:

  • ecs.c6.large: ecs.c6.large インスタンスタイプを除外します。

  • ecs.c6.*: c6 インスタンスファミリー全体を除外します。

ecs.n1.small/ecs.n1.*/*7*

Architecture

array

任意

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

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

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

  • BareMetal: Elastic Compute サービスベアメタルインスタンス。

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

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

string

任意

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

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

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

  • BareMetal: Elastic Compute サービスベアメタルインスタンス。

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

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

X86

BurstablePerformance

string

任意

バースト可能インスタンスタイプを含めるかどうかを指定します。有効な値:

  • Exclude: バースト可能インスタンスタイプを除外します。

  • Include: バースト可能インスタンスタイプを含めます。

  • Required: バースト可能インスタンスタイプのみを含めます。

デフォルト値: Include。

Include

InstanceTypeFamilies

array

任意

照会するインスタンスファミリー。N は複数のインスタンスファミリーを指定できることを示します。N の有効値: 1~10。

string

任意

指定されたインスタンスファミリー。N は複数のインスタンスファミリーを指定できることを示します。N の有効値: 1~10。

ecs.g6

MinimumCpuCoreCount

integer

任意

インスタンスタイプの vCPU コアの最小数。

2

MaximumCpuCoreCount

integer

任意

インスタンスタイプの vCPU コアの最大数。

説明

MaximumCpuCoreCount の値は、MinimumCpuCoreCount の値の 4 倍を超えることはできません。

4

GpuSpecs

array

任意

GPU タイプ。

string

任意

GPU タイプ。

NVIDIA V100

InstanceCategories

array

任意

インスタンスのカテゴリ。有効な値:

説明

N は複数のインスタンスカテゴリを指定できることを示します。N の有効値: 1~10。

  • 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

任意

インスタンスのカテゴリ。有効な値:

説明

N は複数のインスタンスカテゴリを指定できることを示します。N の有効値: 1~10。

  • 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 アーキテクチャ。有効な値:

説明

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

  • X86。

  • ARM。

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、Intel Xeon(Skylake) Platinum 8163、...、Intel Xeon(Cascade Lake) Platinum 8269CY

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

SystemDiskCategories

array

任意

システムクラウドディスクのディスクタイプ。N の有効値: 1~4。スケーリング設定でシステムクラウドディスクに最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプを使用できない場合、Auto Scaling は次の優先度のディスクタイプを自動的に試してシステムクラウドディスクを作成します。有効な値:

  • cloud: 基本クラウドディスク。

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

説明

このパラメーターと SystemDisk.Category を同時に指定することはできません。

cloud

string

任意

システムクラウドディスクのディスクタイプ。N の有効値: 1~4。スケーリング設定でシステムクラウドディスクに最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプを使用できない場合、Auto Scaling は次の優先度のディスクタイプを自動的に試してシステムクラウドディスクを作成します。有効な値:

  • cloud: 基本クラウドディスク。

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

説明

このパラメーターと SystemDisk.Category を同時に指定することはできません。

cloud

SystemDisk.Encrypted

boolean

任意

システムクラウドディスクを暗号化するかどうかを指定します。有効な値:

  • true: システムクラウドディスクを暗号化します。

  • false: システムクラウドディスクを暗号化しません。

デフォルト値: false。

false

SystemDisk.KMSKeyId

string

任意

システムクラウドディスクに使用される Key Management サービス (KMS) キーの ID。

0e478b7a-4262-4802-b8cb-00d3fb40****

SystemDisk.EncryptAlgorithm

string

任意

システムクラウドディスクに使用される暗号化アルゴリズム。有効な値:

  • AES-256。

  • SM4-128。

デフォルト値: AES-256。

AES-256

SystemDisk.ProvisionedIops

integer

任意

システムクラウドディスクのプロビジョニングされた IOPS (Input/Output Operations Per Second) のパフォーマンスメトリクス。

説明

IOPS (Input/Output Operations Per Second) は、ブロックストレージデバイスが 1 秒間に処理できる読み取りおよび書き込み (出力/入力) 操作の数を測定します。単位: 操作/秒。

100

SystemDisk.BurstingEnabled

boolean

任意

システムクラウドディスクのバースト機能を有効にするかどうかを指定します。有効な値:

  • true: 機能を有効にします。

  • false: 機能を有効にしません。

説明

このパラメーターは、SystemDisk.Category が cloud_auto にセットされている場合にのみサポートされます。

詳細については、「ESSD AutoPL cloud disks」を参照してください。

false

ImageOptions.LoginAsNonRoot

boolean

任意

ECS インスタンスがログインに ecs-user ユーザーを使用するかどうかを指定します。詳細については、「Manage the logon name of an ECS instance」を参照してください。有効な値:

  • true: はい。

  • false: いいえ。

デフォルト値: false。

false

DeletionProtection

boolean

任意

ECS インスタンスのリリース保護プロパティ。このプロパティは従量課金インスタンスにのみ適用され、ECS コンソールから、または DeleteInstance 操作を呼び出してインスタンスを直接リリースできるかどうかを指定します。有効な値:

  • true: リリース保護を有効にします。ECS コンソールから、または API オペレーションを呼び出してインスタンスを直接リリースすることはできません。これにより、Auto Scaling のスケールアウト中に作成されたインスタンスが誤って削除されるのを防ぎます。

  • false: リリース保護を無効にします。ECS コンソールから、または API オペレーションを呼び出してインスタンスを直接リリースできます。

デフォルト値: false。

説明

このプロパティは、Auto Scaling の通常のスケールインアクティビティには影響しません。リリース保護が有効になっている従量課金インスタンスも、スケールインアクティビティ中にリリースされる可能性があります。

false

StorageSetId

string

任意

ストレージセットの ID。

ss-bp67acfmxazb4p****

StorageSetPartitionNumber

integer

任意

ストレージセットのパーティションの最大数。有効な値: 2 以上の整数。

2

CustomPriorities

array<object>

任意

ECS インスタンスタイプ + vSwitch 組み合わせのカスタム優先度。

説明

このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。

優先度の高い ECS インスタンスタイプ + vSwitch の組み合わせに基づいて ECS インスタンスを作成できない場合、Auto Scaling は次の優先度の ECS インスタンスタイプ + vSwitch の組み合わせを自動的に選択して ECS インスタンスを作成します。

説明

一部の ECS インスタンスタイプ + vSwitch 組み合わせに対してのみカスタム優先度を指定した場合、指定されていない組み合わせの優先度は指定されたものよりも低くなります。指定されていない組み合わせは、スケーリンググループの vSwitch の順序とスケーリング設定のインスタンスタイプの順序に基づいて引き続き優先順位が付けられます。たとえば、スケーリンググループの vSwitch の順序が vsw1 と vsw2、スケーリング設定のインスタンスタイプの順序が type1 と type2、カスタム優先度の順序が ["vsw2+type2", "vsw1+type2"] である場合、最終的な優先度は vsw2+type2 > vsw1+type2 > vsw1+type1 > vsw2+type1 となります。

object

任意

ECS インスタンスタイプ + vSwitch 組み合わせのカスタム優先度。

重要 このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。

InstanceType

string

任意

CustomPriorities フィールドは、ECS インスタンスタイプ + vSwitch 組み合わせのカスタム優先度を指定します。CustomPriorities.N.InstanceType パラメーターは、カスタム優先度における ECS インスタンスのインスタンスタイプを指定します。

説明

このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。インスタンスタイプ (InstanceType) は、スケーリング設定のインスタンスタイプリストに含まれている必要があります。

優先度の高い ECS インスタンスタイプ + vSwitch の組み合わせに基づいて ECS インスタンスを作成できない場合、Auto Scaling は次の優先度の ECS インスタンスタイプ + vSwitch の組み合わせを自動的に選択して ECS インスタンスを作成します。

説明

一部の ECS インスタンスタイプ + vSwitch 組み合わせに対してのみカスタム優先度を指定した場合、指定されていない組み合わせの優先度は指定されたものよりも低くなります。指定されていない組み合わせは、スケーリンググループの vSwitch の順序とスケーリング設定のインスタンスタイプの順序に基づいて引き続き優先順位が付けられます。たとえば、スケーリンググループの vSwitch の順序が vsw1 と vsw2、スケーリング設定のインスタンスタイプの順序が type1 と type2、カスタム優先度の順序が ["vsw2+type2", "vsw1+type2"] である場合、最終的な優先度は vsw2+type2 > vsw1+type2 > vsw1+type1 > vsw2+type1 となります。

ecs.g6.large

VswitchId

string

任意

CustomPriorities.N.VswitchId パラメーターは、カスタム優先度における vSwitch の ID を指定します。

説明

このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。vSwitch は、スケーリンググループの vSwitch リストに含まれている必要があります。

vsw-bp14zolna43z266bq****

NetworkInterfaces

array<object>

任意

ネットワークインターフェイス (ENI) のリスト。

object

任意

ネットワークインターフェイス (ENI) のリスト。

InstanceType

string

任意

ネットワークインターフェイス (ENI) のタイプ。NetworkInterfaces.N を使用する場合、プライマリネットワークインターフェイス (ENI) を設定する必要がありますが、SecurityGroupId または SecurityGroupIds.N パラメーターを同時に設定することはできません。有効な値:

  • Primary: プライマリネットワークインターフェイス (ENI)。

  • Secondary: セカンダリネットワークインターフェイス (ENI)。

デフォルト値: Secondary。

Primary

NetworkInterfaceTrafficMode

string

任意

ネットワークインターフェイスコントローラー (NIC) の通信パターン。有効な値:

  • 標準: TCP 通信パターンを使用します。

  • HighPerformance: Elastic RDMA Interface (ERI) を有効にし、RDMA 通信パターンを使用します。

デフォルト値: 標準。

説明

RDMA モードのネットワークインターフェイス (ENI) の数は、インスタンスファミリーの制限を超えることはできません。詳細については、「Instance families」を参照してください。

HighPerformance

Ipv6AddressCount

integer

任意

プライマリ ENI 用にランダムに生成される IPv6 アドレスの数。次の項目に注意してください。

  • このパラメーターは、NetworkInterfaces.N.InstanceType が Primary にセットされている場合にのみ効果があります。

  • NetworkInterface.N.InstanceType が Secondary にセットされているか、空の場合、このパラメーターは設定できません。

  • このパラメーターを設定した後、Ipv6AddressCount パラメーターは設定できません。

1

SecurityGroupIds

array

任意

ネットワークインターフェイス (ENI) が属する 1 つ以上のセキュリティグループの ID。

string

任意

ネットワークインターフェイス (ENI) が属する 1 つ以上のセキュリティグループの ID。次の項目に注意してください。

  • NetworkInterfaces.N.InstanceType が Primary にセットされている場合、このパラメーターを設定する必要があります。この場合、このパラメーターは SecurityGroupIds.N と同じ効果を持ちますが、SecurityGroupId または SecurityGroupIds.N を同時に設定することはできません。

  • NetworkInterfaces.N.InstanceType が Secondary にセットされているか、空の場合、このパラメーターはオプションです。デフォルト値は、ECS インスタンスのセキュリティグループ (プライマリネットワークインターフェイス (ENI) のセキュリティグループ) です。

sg-uf6ij8dwxh****

SecondaryPrivateIpAddressCount

integer

任意

ENI に割り当てるセカンダリ非公開 IPv4 アドレスの数。有効な値: 1~49。

  • この値は、インスタンスタイプの IP アドレス数の制限を超えることはできません。詳細については、「Instance families」を参照してください。

  • NetworkInterface.N.SecondaryPrivateIpAddressCount は、ENI にセカンダリ非公開 IPv4 アドレスを割り当てるために使用されます (ENI のプライマリ非公開 IP アドレスは除く)。システムは、ENI が属する vSwitch (NetworkInterface.N.VSwitchId) の利用可能な CIDR ブロックから IP アドレスをランダムに割り当てます。

2

VSwitchIds

array

任意

ネットワークインターフェイス (ENI) が属する vSwitch の ID。N は複数の vSwitch を設定できることを示します。N の有効値: 1~10。

次の項目に注意してください。

  • InstanceType が Primary にセットされている場合、このパラメーターは設定できません。デフォルト値はインスタンスの vSwitch です。

  • InstanceType が Secondary にセットされているか、空の場合、このパラメーターはオプションです。

  • システムは、プライマリネットワークインターフェイス (ENI) と同じゾーンにあり、利用可能な IP アドレスが最も多い vSwitch を選択します。

string

任意

ネットワークインターフェイス (ENI) が属する vSwitch の ID。N は複数の vSwitch を設定できることを示します。N の有効値: 1~10。

次の項目に注意してください。

  • InstanceType が Primary にセットされている場合、このパラメーターは設定できません。デフォルト値はインスタンスの vSwitch です。

  • InstanceType が Secondary にセットされているか、空の場合、このパラメーターはオプションです。

  • システムは、プライマリネットワークインターフェイス (ENI) と同じゾーンにあり、利用可能な IP アドレスが最も多い vSwitch を選択します。

vsw-bp67acfmxazb4p****

DedicatedHostClusterId

string

任意

専用ホストクラスターの ID。

dc-2zedxc67zqzt7lb4****

SecurityOptions

object

任意

セキュリティオプション。

ConfidentialComputingMode

string

任意

機密コンピューティングモード。有効な値:

TDX

HttpEndpoint

string

任意

インスタンスメタデータへのアクセスチャンネルを有効にするかどうかを指定します。有効な値:

  • enabled: アクセスチャンネルを有効にします。

  • disabled: アクセスチャンネルを無効にします。

デフォルト値: enabled。

説明

インスタンスメタデータの詳細については、「インスタンスメタデータの概要」を参照してください。

有効

HttpTokens

string

任意

インスタンスメタデータへのアクセスにセキュリティ拡張モード (IMDSv2) を強制的に使用するかどうかを指定します。有効な値:

  • optional: セキュリティ拡張モードを強制的に使用しません。

  • required: セキュリティ拡張モードを強制的に使用します。この値を設定した後、通常モードではインスタンスメタデータにアクセスできません。

デフォルト値: optional。

説明

インスタンスメタデータアクセスモードの詳細については、「インスタンスメタデータアクセスモード」を参照してください。

オプション

ResourcePoolOptions

object

任意

インスタンス作成時に使用されるリソースプールポリシー。このパラメーターを設定した後、次の項目に注意してください。

  • このパラメーターは、従量課金インスタンスが作成される場合にのみ効果があります。

  • このパラメーターは、PrivatePoolOptions.MatchCriteria または PrivatePoolOptions.Id と一緒に設定することはできません。

Strategy

string

任意

リソースプールには、Elasticity Assurance または Capacity Reservation の効果後に生成される非公開プールと、パブリックプールが含まれます。これらのプールはインスタンスの起動に使用できます。有効な値:

  • PrivatePoolFirst: 非公開プール優先。この戦略が選択され、ResourcePoolOptions.PrivatePoolIds が指定されているか、PrivatePoolTags の条件が満たされている場合、対応する非公開プールが最初に使用されます。非公開プールが指定されていないか、指定された非公開プールの容量が不足している場合、オープンタイプの非公開プールが自動的にマッチングされます。一致する非公開プールが利用できない場合、パブリックプールがインスタンスの作成に使用されます。

  • PrivatePoolOnly: 非公開プールのみ。この戦略が選択されている場合、ResourcePoolOptions.PrivatePoolIds を指定する必要があります。指定された非公開プールの容量が不足している場合、インスタンスの作成は失敗します。

  • PublicPoolFirst: パブリックプール優先。パブリックプールが最初にインスタンスの作成に使用されます。パブリックプールのリソースが不足している場合、非公開プールのリソースが補充として使用されます。オープンタイプの非公開プールが最初に自動的にマッチングされます。一致する非公開プールが利用できない場合、ResourcePoolOptions.PrivatePoolIds で指定された Target タイプの非公開プール、または一致する PrivatePoolTags の条件が使用されます。

    説明

    この戦略は招待プレビュー中であり、現在ご利用いただけません。

  • None: リソースプールポリシーを使用しません。

デフォルト値: None。

PrivatePoolFirst

PrivatePoolIds

array

任意

非公開プールの ID。Elasticity Assurance ID または Capacity Reservation ID です。Target モードの非公開プール ID のみを渡すことができます。このパラメーターは、PrivatePoolTags パラメーターと一緒に指定することはできません。

string

任意

非公開プールの ID。Elasticity Assurance ID または Capacity Reservation ID です。Target モードの非公開プール ID のみを渡すことができます。このパラメーターは、PrivatePoolTags パラメーターと一緒に指定することはできません。N の有効値: 1~20。

eap-bp67acfmxazb4****

PrivatePoolTags

array<object>

任意

利用可能な Target 非公開プールをタグでフィルターします。N の有効値: 1~20。 注意:

  • このパラメーターが設定されている場合、システムはアカウントに関連付けられ、指定されたタグに一致し、スケーリンググループの制約 (ゾーンやインスタンスタイプなど) を満たす Target 非公開プールのみをフィルターします。

  • タグマッチングルールのルール: 非公開プールは指定されたすべてのタグに一致する必要があります。

  • このパラメーターは、PrivatePoolIds パラメーターと一緒に指定することはできません。

object

任意

利用可能な Target 非公開プールをタグでフィルターします。N の有効値: 1~20。 注意:

  • このパラメーターが設定されている場合、システムはアカウントに関連付けられ、指定されたタグに一致し、スケーリンググループの制約 (ゾーンやインスタンスタイプなど) を満たす Target 非公開プールのみをフィルターします。

  • タグマッチングルールのルール: 非公開プールは指定されたすべてのタグに一致する必要があります。

  • このパラメーターは、PrivatePoolIds パラメーターと一緒に指定することはできません。

Key

string

任意

非公開プールのタグキー。

利用可能な Target 非公開プールをタグでフィルターします。N の有効値: 1~20。注意:

このパラメーターが設定されている場合、システムはアカウントに関連付けられ、指定されたタグに一致し、スケーリンググループの制約 (ゾーンやインスタンスタイプなど) を満たす Target 非公開プールのみをフィルターします。 タグマッチングルールのルール: 非公開プールは指定されたすべてのタグに一致する必要があります。 このパラメーターは、PrivatePoolIds パラメーターと一緒に指定することはできません。

TestKey

Value

string

任意

非公開プールのタグ値。

TestValue

SecondaryEniVSwitchConstraint

string

任意

セカンダリネットワークインターフェイス (ENI) に対して VSwitchIds パラメーターが設定されている場合、セカンダリネットワークインターフェイス (ENI) 用に VSwitchIds リストから vSwitch を選択する必要があるかどうかを指定します。

  • Strict: 厳格モード。VSwitchIds 内のどの vSwitch も条件を満たさない場合、インスタンスの作成は失敗します。

  • Tolerant: 寛容モード。VSwitchIds 内のどの vSwitch も条件を満たさない場合、セカンダリネットワークインターフェイス (ENI) は設定されませんが、インスタンスはアクティブなステータスで作成されます。

デフォルト値: Strict。

Strict

レスポンスフィールド

フィールド

説明

object

ScalingConfigurationId

string

スケーリング設定の ID。

asc-bp1ffogfdauy0nu5****

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

{
  "ScalingConfigurationId": "asc-bp1ffogfdauy0nu5****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

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

変更履歴

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