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

Auto Scaling:ModifyScalingConfiguration

最終更新日:Sep 17, 2026

現在のスケーリング設定がビジネス要件を満たしていない場合に、ECS タイプのスケーリング設定 (スケールアウト用の ECS インスタンステンプレート) を変更します。

操作説明

操作の説明

  • スケーリング設定の名前を変更する場合は、同じスケーリンググループ内に同じ名前のスケーリング設定が存在しないことを確認してください。

  • 次のいずれかのメソッドを使用してプライマリネットワークインターフェースを設定できます。ただし、各 API 呼び出しで使用できるのは 1 つのメソッドのみです。両方のメソッドを使用すると、呼び出しは失敗し、エラーメッセージが返されます。

    • SecurityGroupIdSecurityGroupIds.NIpv6AddressCount などのパラメーターを使用して、プライマリネットワークインターフェースを直接設定します。

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

    説明

    スケーリング設定を変更し、前述のいずれかのメソッドを選択してネットワークインターフェースを設定すると、他のメソッドでセットされたネットワークインターフェース構成はクリアされます。

今すぐお試しください

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

update

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingConfigurationId

string

必須

変更するスケーリング設定の ID。

asc-bp16har3jpj6fjbx****

IoOptimized

string

任意

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

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

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

none

SpotStrategy

string

任意

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

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

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

  • SpotAsPriceGo: 購入時の市場価格が入札価格として自動的に使用されるスポットインスタンス。

NoSpot

ScalingConfigurationName

string

任意

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

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

test-modify

InstanceName

string

任意

スケーリング設定に基づく自動作成によって作成される ECS インスタンスの名前。

inst****

HostName

string

任意

Elastic Computing サービス (ECS) サーバーのホスト名。ピリオド (.) またはハイフン (-) を先頭または末尾の文字として使用したり、連続して使用したりすることはできません。命名規則はインスタンスタイプによって異なります。

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

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

hos****

ImageId

string

任意

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

説明

スケーリング設定で以前に使用されていたイメージにシステムクラウドディスクとデータクラウドディスクが含まれている場合、イメージを変更するとデータクラウドディスクの情報は消去されます。

centos6u5_64_20G_aliaegis_2014****.vhd

ImageName

string

任意

イメージファイルの名前。イメージ名はリージョン内で一意である必要があります。ImageId を指定した場合、ImageName は無視されます。

ImageName を使用して Alibaba Cloud Marketplace のイメージを指定することはできません。

suse11sp3_64_20G_aliaegis_2015****.vhd

Cpu

integer

任意

vCPU の数。

CPU と Memory の両方を指定して、インスタンスタイプの有効値を定義できます。たとえば、CPU を 2、Memory を 16 に設定すると、2 vCPU と 16 GiB のメモリを持つすべてのインスタンスタイプが定義されます。Auto Scaling は、I/O 最適化設定やゾーンなどの要因に基づいてアクティブなインスタンスタイプのセットを決定し、価格によるソートに基づいて最低価格でインスタンスを作成します。

説明

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

2

Memory

integer

任意

メモリサイズ。

CPU と Memory の両方を指定して、インスタンスタイプの有効値を定義できます。たとえば、CPU を 2、Memory を 16 に設定すると、2 vCPU と 16 GiB のメモリを持つすべてのインスタンスタイプが定義されます。Auto Scaling は、I/O 最適化設定やゾーンなどの要因に基づいてアクティブなインスタンスタイプのセットを決定し、価格によるソートに基づいて最低価格でインスタンスを作成します。

説明

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

16

InternetChargeType

string

任意

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

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

  • PayByTraffic: トラフィック課金。InternetMaxBandwidthOut の値がピーク帯域幅として使用されます。実際のネットワークトラフィックに基づいて課金されます。

PayByBandwidth

InternetMaxBandwidthOut

integer

任意

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

デフォルト値: 0。

10

SystemDisk.Category

string

任意

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

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

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

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

このパラメーターは SystemDiskCategories.N と共に指定することはできません。このパラメーターも SystemDiskCategories.N も指定されていない場合、デフォルト値が使用されます。インスタンスタイプが第 1 世代インスタンスファミリーに属し、かつインスタンスが I/O 最適化インスタンスではない場合、デフォルト値は cloud です。それ以外の場合、デフォルト値は cloud_efficiency です。

cloud_efficiency

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}。

50

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

任意

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

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

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

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

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

説明

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

PL0

LoadBalancerWeight

integer

任意

SLB バックエンドサーバーの重み。有効な値: 1~100。

50

UserData

string

任意

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

ZWNobyBoZWxsbyBlY3Mh

KeyPairName

string

任意

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

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

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

KeyPair_Name

RamRoleName

string

任意

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

RamRoleTest

PasswordInherit

boolean

任意

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

false

Tags

string

任意

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

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

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

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

DeploymentSetId

string

任意

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

ds-bp13v7bjnj9gis****

SecurityGroupId

string

任意

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

sg-F876F****

Override

boolean

任意

既存のデータをオーバーライドするかどうかを指定します。有効な値:

  • true: 既存のデータをオーバーライドします。

  • false: 既存のデータをオーバーライドしません。

true

ResourceGroupId

string

任意

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

abcd1234abcd****

HpcClusterId

string

任意

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

hpc-クラスターid

InstanceDescription

string

任意

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

テストインスタンス

Ipv6AddressCount

integer

任意

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

1

CreditSpecification

string

任意

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

標準

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

任意

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

  • デフォルト: インスタンスは専用ホストに関連付けられていません。節約モードが有効になっているインスタンスが停止後に再起動されると、元の専用ホストのリソースが不足している場合、インスタンスは自動デプロイリソースプール内の別の専用ホストにデプロイされます。

  • host: インスタンスは専用ホストに関連付けられています。節約モードが有効になっているインスタンスが停止後に再起動されると、インスタンスは引き続き元の専用ホストにデプロイされます。元の専用ホストのリソースが不足している場合、インスタンスの再起動は失敗します。

デフォルト

Tenancy

string

任意

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

  • デフォルト: 専用ホスト上にないインスタンスを作成します。

  • host: 専用ホスト上にインスタンスを作成します。DedicatedHostId を指定しない場合、Alibaba Cloud はインスタンスの専用ホストを自動的に選択します。

デフォルト

SchedulerOptions

object

任意

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

["testManagedPrivateSpaceId****"]

PrivatePoolOptions.MatchCriteria

string

任意

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

  • Open: オープンモード。システムは利用可能なオープンの非公開プールキャパシティを自動的にマッチングします。一致する非公開プールキャパシティが利用できない場合、パブリックプールリソースが使用されます。PrivatePoolOptions.Id を指定する必要はありません。

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

  • None: 非公開プールは使用されません。インスタンスは起動時に非公開プールキャパシティを使用しません。

Open

PrivatePoolOptions.Id

string

任意

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

eap-bp67acfmxazb4****

SpotDuration

integer

任意

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

  • 1: インスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間以内に自動リリースされないことを保証します。1 時間後、システムは入札価格と市場価格を自動的に比較し、リソースインベントリをチェックして、インスタンスの自動リリースを保持するかどうかを決定します。

  • 0: インスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間実行されることを保証しません。システムは入札価格と市場価格を自動的に比較し、リソースインベントリをチェックして、インスタンスの自動リリースを保持するかどうかを決定します。

説明

Alibaba Cloud は、インスタンスがリリースされる 5 分前に ECS システムイベント通知を送信します。スポットインスタンスは秒単位で課金されます。予想されるタスク実行時間に基づいて適切な保持期間を選択することをお勧めします。

デフォルト値: 1。

1

SpotInterruptionBehavior

string

任意

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

Terminate

DataDisk

array<object>

任意

データクラウドディスクのリスト。

object

任意

データクラウドディスクのリスト。

PerformanceLevel

string

任意

ディスクが ESSD の場合のデータクラウドディスクのパフォーマンスレベル (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 を配信できます。

説明

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

PL1

AutoSnapshotPolicyId

string

任意

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

sp-bp19nq9enxqkomib****

Encrypted

string

任意

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

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

  • 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-スナップショット****

Categories

array

任意

データクラウドディスク N の複数のディスクタイプ。最初の N はデータクラウドディスク N を示します。有効な値: 1~16。2 番目の N はデータクラウドディスク N の N 番目のディスクタイプを示します。有効な値: 1~4。これは、スケーリング設定内のデータクラウドディスクに対して最大 4 つのディスクタイプを指定できることを意味します。N の値が small であるほど優先度が高くなります。優先度の高いディスクタイプが利用できない場合、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 の N 番目のディスクタイプを示します。有効な値: 1~4。これは、スケーリング設定内のデータクラウドディスクに対して最大 4 つのディスクタイプを指定できることを意味します。N の値が small であるほど優先度が高くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は自動的に次の優先度のディスクタイプを試行してデータクラウドディスクを作成します。有効な値:

  • cloud: 基本クラウドディスク。インスタンスと共に作成された基本クラウドディスクの DeleteWithInstance 属性は true にセットされます。

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

説明

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

cloud

Size

integer

任意

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

  • cloud: 5~2000。

  • cloud_efficiency: 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 に設定されている) に対してのみ設定できます。それ以外の場合はエラーが返されます。

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 にセットされている場合にのみサポートされます。

false

SpotPriceLimit

array<object>

任意

スポットインスタンス情報のコレクション。

object

任意

スポットインスタンス情報のコレクション。

PriceLimit

number

任意

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

0.125

InstanceType

string

任意

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

ecs.g6.large

InstanceTypes

array

任意

複数のインスタンスタイプをサポートするためのインスタンスタイプ。InstanceTypes.N が指定されている場合、InstanceType は無視されます。N の有効な値: 1~20。これは、スケーリング設定内で最大 20 のインスタンスタイプを指定できることを意味します。

N は、現在のスケーリング設定におけるインスタンスタイプの優先度を表します。インスタンスタイプ 1 が最も高い優先度を持ち、数値が大きくなるにつれて優先度は低くなります。優先度の高いインスタンスタイプを使用してインスタンスを作成できない場合、Auto Scaling は自動的に次の優先度のインスタンスタイプを選択してインスタンスを作成します。

ecs.g6.large

string

任意

複数のインスタンスタイプをサポートするためのインスタンスタイプ。InstanceTypes.N が指定されている場合、InstanceType は無視されます。N の有効な値: 1~20。これは、スケーリング設定内で最大 20 のインスタンスタイプを指定できることを意味します。

N は、現在のスケーリング設定におけるインスタンスタイプの優先度を表します。インスタンスタイプ 1 が最も高い優先度を持ち、数値が大きくなるにつれて優先度は低くなります。優先度の高いインスタンスタイプを使用してインスタンスを作成できない場合、Auto Scaling は自動的に次の優先度のインスタンスタイプを選択してインスタンスを作成します。

ecs.g6.large

InstanceTypeOverride

array<object>

任意

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

object

任意

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

InstanceType

string

任意

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

このパラメーターはインスタンスタイプを指定します。このパラメーターに N 個の値を指定し、InstanceTypeOverride.N.WeightedCapacity パラメーターを使用して、複数のインスタンスタイプのカスタム重みをサポートできます。N の有効な値: 1~20。

説明

このパラメーターと instanceTypes を同じ時間に指定することはできません。

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

SecurityGroupIds

array

任意

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

説明

SecurityGroupId と SecurityGroupIds.N を同じ時間に指定することはできません。

sg-bp18kz60mefs****

string

任意

セキュリティグループの ID。

sg-bp18kz60mefs****

InstancePatternInfo

array<object>

任意

インテリジェントモードにおけるインスタンスタイプ関連情報。

object

任意

インテリジェントモードにおけるインスタンスタイプ関連情報。

Cores

integer

任意

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

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

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

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

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

2

InstanceFamilyLevel

string

任意

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

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

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

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

N の有効値: 1~10。

EnterpriseLevel

MaxPrice

number

任意

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

説明

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

2

Memory

number

任意

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

4

Architecture

array

任意

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

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

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

  • BareMental: ECS Bare Metal Instance サーバー。

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

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

string

任意

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

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

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

  • BareMental: ECS Bare Metal Instance サーバー。

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

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

X86

BurstablePerformance

string

任意

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

  • Exclude: バースト可能インスタンスタイプは含まれません。

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

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

デフォルト値: Include。

Include

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*

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

InstanceTypeFamilies

array

任意

指定されたインスタンスファミリー。

string

任意

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

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

MinimumCpuCoreCount

integer

任意

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

2

MaximumCpuCoreCount

integer

任意

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

説明

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

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: 高性能コンピューティング (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: ECS Bare Metal Instance サーバー。

  • High Performance Compute: 高性能コンピューティング (HPC)。

Compute-optimized with GPU

CpuArchitectures

array

任意

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

string

任意

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

説明

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

  • X86。

  • ARM。

["X86", "ARM"]

PhysicalProcessorModels

array

任意

インスタンスのプロセッサモデル。

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 の予想最小値。有効な値: 1 以上の正の整数。

2

MaximumGpuAmount

integer

任意

インスタンスの GPU の予想最大値。有効な値: 1 以上の正の整数。

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

Password

string

任意

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

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

Windows インスタンスの場合、パスワードの先頭を転送スラッシュ (/) にすることはできません。

説明

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

123abc****

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 にセットされている場合にのみサポートされます。

false

ImageOptions.LoginAsNonRoot

boolean

任意

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

  • true: はい。

  • false: いいえ。

false

DeletionProtection

boolean

任意

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

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

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

説明

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

false

StorageSetId

string

任意

ストレージセットの ID。

ss-bp67acfmxazb4p****

StorageSetPartitionNumber

integer

任意

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

2

CustomPriorities

array<object>

任意

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

説明

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

優先度の高い 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 の組み合わせのカスタム優先度。

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

InstanceType

string

任意

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

説明

このパラメーターは、スケーリンググループのスケーリングポリシーが優先度ポリシーにセットされている場合にのみ効果を持ちます。インスタンスタイプ (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 を指定します。

説明

このパラメーターは、スケーリンググループのスケーリングポリシーが優先度ポリシーにセットされている場合にのみ効果を持ちます。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) の通信モード。有効な値:

  • Standard: TCP 通信モードを使用します。

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

デフォルト値: Standard。

説明

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

HighPerformance

Ipv6AddressCount

integer

任意

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

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

  • NetworkInterfaces.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-2ze55shrh****

SecondaryPrivateIpAddressCount

integer

任意

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

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

  • 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。

説明

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

オプション

InternetMaxBandwidthIn

integer

任意

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

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

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

10

ResourcePoolOptions

object

任意

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

  • このパラメーターは、従量課金インスタンスを作成する場合にのみ効果を持ちます。

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

Strategy

string

任意

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

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

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

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

    説明

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

  • 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

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

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

変更履歴

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