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

Auto Scaling:ModifyScalingConfiguration

最終更新日:Jul 02, 2026

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

操作説明

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

  • 以下のいずれかのメソッドでプライマリネットワークインターフェース(NIC)をバインドできます。ただし、1 つのリクエストで使用できるのは 1 つのメソッドのみです。両方のメソッドを使用すると、呼び出しが失敗し、エラーメッセージが返されます。一方のメソッドでスケーリング設定を変更すると、もう一方のメソッドで設定された NIC 構成はクリアされます。

    • SecurityGroupId、SecurityGroupIds、Ipv6AddressCount などのパラメーターを使用してプライマリ NIC の構成を設定します。

    • NetworkInterfaces パラメーターを使用してプライマリ NIC とセカンダリ NIC の構成を設定します。NetworkInterfaces パラメーターを使用する場合、プライマリ NIC を構成する必要があります。NetworkInterface.InstanceType が Primary に設定されている場合、プライマリ NIC が構成されます。NetworkInterface.InstanceType が Secondary に設定されているか空の場合、セカンダリ NIC が構成されます。

今すぐお試しください

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

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

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 サービスサーバーのホスト名。ピリオド(.)またはハイフン(-)を最初または最後の文字として使用できず、連続するピリオド(.)またはハイフン(-)は許可されません。命名規則はインスタンスタイプによって異なります:

  • 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

任意

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

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: ベーシッククラウドディスク。

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

  • cloud_ssd: 標準 SSD。

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

  • ephemeral_ssd: ローカル SSD。

このパラメーターは SystemDiskCategories と同時に指定できません。このパラメーターも SystemDiskCategories も指定されていない場合、デフォルト値が使用されます。インスタンスタイプが第 I 世代インスタンスファミリーに属し、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} 以上である必要があります。

50

SystemDisk.DiskName

string

任意

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

cloud_ssdSystem

SystemDisk.Description

string

任意

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

Test system disk.

SystemDisk.AutoSnapshotPolicyId

string

任意

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

sp-bp12m37ccmxvbmi5****

SystemDisk.PerformanceLevel

string

任意

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

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

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

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

  • PL3: 単一ディスクで最大 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 ロールの名前。名前は Resource Access Management(RAM)によって提供および管理されます。ListRoles 操作を呼び出して使用可能な RAM ロールをクエリできます。RAM ロールの作成方法の詳細については、CreateRole 操作を参照してください。

RamRoleTest

PasswordInherit

boolean

任意

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

false

Tags

string

任意

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

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

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

{"key1":"value1","key2":"value2", ... "key5":"value5"}

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-clusterid

InstanceDescription

string

任意

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

Test instance.

Ipv6AddressCount

integer

任意

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

1

CreditSpecification

string

任意

バースト可能インスタンスの実行モードを変更します。有効な値:

Standard

ImageFamily

string

任意

イメージ ファミリーの名前。このパラメーターを設定すると、指定されたイメージ ファミリー内の最新の使用可能なイメージがインスタンスの作成に使用されます。ImageId を設定している場合、このパラメーターは設定できません。

hangzhou-daily-update

ZoneId

string

任意

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

cn-hangzhou-g

DedicatedHostId

string

任意

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

DescribeDedicatedHosts API オペレーションを呼び出して、専用ホスト ID のリストをクエリできます。

dh-bp67acfmxazb4p****

Affinity

string

任意

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

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

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

デフォルト値: default。

default

Tenancy

string

任意

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

  • default: 非専用ホストインスタンスを作成します。

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

デフォルト値: default。

default

SchedulerOptions

object

任意

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

["testManagedPrivateSpaceId****"]

PrivatePoolOptions.MatchCriteria

string

任意

インスタンス起動の非公開プールオプション。非公開プールは、エラスティシティ保証またはキャパシティ予約が有効になった後に生成されます。インスタンスの起動時に非公開プールを選択できます。有効な値:

  • Open: オープンモード。システムはオープン非公開プールを自動的にマッチングします。一致する非公開プールがない場合、パブリックプールが使用されます。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 システムイベント通知を送信します。スポットインスタンスは秒単位で課金されます。予想されるタスク実行時間に基づいて保護期間を設定してください。

デフォルト値: 1。

1

SpotInterruptionBehavior

string

任意

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

Terminate

DataDisks

array<object>

任意

データクラウドディスク情報のコレクション。

object

任意

データクラウドディスク情報のコレクション。

PerformanceLevel

string

任意

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

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

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

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

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

説明

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

PL1

AutoSnapshotPolicyId

string

任意

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

sp-bp19nq9enxqkomib****

Encrypted

string

任意

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

  • true: ディスクを暗号化します。

  • false: ディスクを暗号化しません。

false

Description

string

任意

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

Test data disk.

SnapshotId

string

任意

データクラウドディスクの作成に使用されるスナップショットの ID。このパラメーターを指定すると、DataDisk.Size は無視されます。作成されるディスクの実際のサイズは、指定されたスナップショットのサイズになります。

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

s-snapshot****

Categories

array

任意

データクラウドディスクの複数のディスクタイプ。有効な値:

  • cloud: ベーシッククラウドディスク。インスタンスと共に作成されたベーシッククラウドディスクの DeleteWithInstance 属性は true に設定されます。

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_auto: ESSD AutoPL。

  • cloud_regional_disk_auto: リージョナル ESSD。

説明

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

string

任意

データクラウドディスクの複数のディスクタイプ。優先度の高いディスクタイプが使用できない場合、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.Category と同時に指定できません。

cloud

Size

integer

任意

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

  • cloud: 5~2000。

  • cloud_efficiency: 20~32768。

  • cloud_ssd: 20~32768。

  • cloud_essd: 20~32768。

  • ephemeral_ssd: 5~800。

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

100

Device

string

任意

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

/dev/xvdd

DiskName

string

任意

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

cloud_ssdData

Category

string

任意

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

  • cloud: ベーシッククラウドディスク。インスタンスと共に作成されたベーシッククラウドディスクの DeleteWithInstance 属性は true に設定されます。

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_auto: ESSD AutoPL。

  • cloud_regional_disk_auto: リージョナル ESSD。

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

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

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

cloud_ssd

DeleteWithInstance

boolean

任意

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

  • true: インスタンスのリリース時にディスクをリリースします。

  • false: インスタンスのリリース時にディスクを保持します。

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

true

KMSKeyId

string

任意

データクラウドディスクの KMS キーの ID。

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: 無効。

説明

このパラメーターは SystemDisk.Categorycloud_auto に設定されている場合にのみサポートされます。

false

SpotPriceLimits

array<object>

任意

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

object

任意

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

PriceLimit

number

任意

スポットインスタンスの入札価格。このパラメーターは SpotStrategy が SpotWithPriceLimit に設定されている場合にのみ有効です。

0.125

InstanceType

string

任意

スポットインスタンスのインスタンスタイプ

ecs.g6.large

InstanceTypes

array

任意

複数のインスタンスタイプをサポートするためのインスタンスタイプ。InstanceTypes を指定した場合、InstanceType は無視されます。

優先度の高いインスタンスタイプでインスタンスを作成できない場合、Auto Scaling は自動的に次の優先度のインスタンスタイプを選択してインスタンスを作成します。

string

任意

複数のインスタンスタイプをサポートするためのインスタンスタイプ。InstanceTypes を指定した場合、InstanceType は無視されます。

優先度の高いインスタンスタイプでインスタンスを作成できない場合、Auto Scaling は自動的に次の優先度のインスタンスタイプを選択してインスタンスを作成します。

ecs.g6.large

InstanceTypeOverrides

array<object>

任意

指定されたインスタンスタイプの情報。

object

任意

指定されたインスタンスタイプの情報。

InstanceType

string

任意

To specify the capacity of an instance type in the scaling configuration, specify both this parameter and InstanceTypeOverride.WeightedCapacity.

This parameter specifies the instance type. You can specify multiple instance types and use the InstanceTypeOverride.WeightedCapacity parameter to assign custom weights to each type.

説明

You cannot specify this parameter together with instanceTypes.

Valid values of InstanceType: ECS instance types that are available for purchase.

ecs.c5.xlarge

WeightedCapacity

integer

任意

To scale the scaling group based on instance type capacity, specify this parameter after specifying LaunchTemplateOverride.InstanceType.

This parameter specifies the weight of the instance type, which represents the capacity of a single instance of this type in the scaling group. A larger weight means fewer instances of this type are required to meet the expected capacity.

Because instance types differ in vCPU count, memory size, and other performance metrics, you can assign different weights to different instance types based on your requirements.

Example:

  • Current capacity: 0.

  • Expected number of instances: 6.

  • Capacity of ecs.c5.xlarge: 4.

To meet the expected capacity, the scaling group scales out 2 ecs.c5.xlarge instances.

説明

During a scale-out, the capacity of the scaling group cannot exceed the sum of the maximum capacity (MaxSize) and the maximum weight of the instance types.

Valid values of WeightedCapacity: 1 to 500.

4

SecurityGroupIds

array

任意

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

string

任意

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

sg-bp18kz60mefs****

InstancePatternInfos

array<object>

任意

The collection of intelligent configuration information used to filter instance types that meet the requirements.

object

任意

The collection of intelligent configuration information used to filter instance types that meet the requirements.

Cores

integer

任意

The number of vCPU cores of the instance type in intelligent configuration mode, used to filter instance types that meet the requirements. For more information, see Instance families.

Note the following information:

  • The InstancePatternInfo parameter applies only to scaling groups that use the VPC network type.

  • You must specify both InstancePatternInfo.Cores and InstancePatternInfo.Memory.

  • If you have specified instance types by using the InstanceType or InstanceTypes parameter, Auto Scaling preferentially uses the specified instance types for scale-out. When the specified instance types are out of stock, Auto Scaling selects the lowest-priced instance type from those that match the InstancePatternInfo parameter values.

2

InstanceFamilyLevel

string

任意

The level of the instance family, used to filter instance types that meet the requirements. This parameter takes effect when CostOptimization is enabled. Valid values:

  • EntryLevel: entry level, which refers to shared instance types. These types are more cost-effective but do not guarantee stable computing performance. They are suitable for scenarios with low CPU utilization. For more information, see Shared instance families.

  • EnterpriseLevel: enterprise level. These types provide stable performance and dedicated resources. They are suitable for scenarios that require high stability. For more information, see Instance families.

  • CreditEntryLevel: credit-based entry level, which refers to burstable instances. These types use CPU credits to ensure computing performance. They are suitable for scenarios with low average CPU utilization and occasional bursts. For more information, see Overview of burstable instances.

EnterpriseLevel

MaxPrice

number

任意

The maximum hourly price for pay-as-you-go or spot instances in intelligent configuration mode, used to filter instance types that meet the requirements.

説明

This parameter is required when SpotStrategy is set to SpotWithPriceLimit. In other cases, this parameter is optional.

2

Memory

number

任意

The memory size of the instance type in intelligent configuration mode. Unit: GiB. This parameter is used to filter instance types that meet the requirements.

4

Architectures

array

任意

The architecture types of the instance type. Valid values:

  • X86: X86 computing.

  • Heterogeneous: heterogeneous computing, such as GPU or FPGA.

  • BareMental: ECS Bare Metal Instance server.

  • Arm: Arm computing.

Default value: all architecture types are included.

string

任意

The architecture types of the instance type. Valid values:

  • X86: X86 computing.

  • Heterogeneous: heterogeneous computing, such as GPU or FPGA.

  • BareMental: ECS Bare Metal Instance server.

  • Arm: Arm computing.

Default value: all architecture types are included.

X86

BurstablePerformance

string

任意

Specifies whether to include burstable instance types. Valid values:

  • Exclude: excludes burstable instance types.

  • Include: includes burstable instance types.

  • Required: includes only burstable instance types.

Default value: Include.

Include

ExcludedInstanceTypes

array

任意

The instance types to exclude. You can use wildcard characters (*) to exclude a single instance type or an entire instance family. Examples:

  • ecs.c6.large: excludes the ecs.c6.large instance type.

  • ecs.c6.*: excludes the entire c6 instance family.

string

任意

The instance types to exclude. You can use wildcard characters (*) to exclude a single instance type or an entire instance family. Examples:

  • ecs.c6.large: excludes the ecs.c6.large instance type.

  • ecs.c6.*: excludes the entire c6 instance family.

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

InstanceTypeFamilies

array

任意

The instance families to query. N indicates that you can specify multiple instance families. Valid values of N: 1 to 10.

string

任意

The instance families to query. N indicates that you can specify multiple instance families. Valid values of N: 1 to 10.

ecs.g6

MinimumCpuCoreCount

integer

任意

The minimum number of vCPU cores of the instance.

2

MaximumCpuCoreCount

integer

任意

The maximum number of vCPU cores of the instance type.

説明

MaximumCpuCoreCount cannot exceed 4 times the value of MinimumCpuCoreCount.

4

GpuSpecs

array

任意

The GPU type.

string

任意

The GPU type.

NVIDIA V100

InstanceCategories

array

任意

The categorization of the instance type. Valid values:

  • General-purpose: general purpose.

  • Compute-optimized: compute optimized.

  • Memory-optimized: memory optimized.

  • Big data: big data.

  • Local SSDs: local SSD.

  • High Clock Speed: high frequency.

  • Enhanced: enhanced.

  • Shared: shared.

  • Compute-optimized with GPU: GPU compute optimized.

  • Visual Compute-optimized: visual compute optimized.

  • Heterogeneous Service: heterogeneous service.

  • Compute-optimized with FPGA: FPGA compute optimized.

  • Compute-optimized with NPU: NPU compute optimized.

  • ECS Bare Metal: ECS Bare Metal Instance server.

  • High Performance Compute: high-performance computing (HPC).

string

任意

The categorization of the instance type. Valid values:

  • General-purpose: general purpose.

  • Compute-optimized: compute optimized.

  • Memory-optimized: memory optimized.

  • Big data: big data.

  • Local SSDs: local SSD.

  • High Clock Speed: high frequency.

  • Enhanced: enhanced.

  • Shared: shared.

  • Compute-optimized with GPU: GPU compute optimized.

  • Visual Compute-optimized: visual compute optimized.

  • Heterogeneous Service: heterogeneous service.

  • Compute-optimized with FPGA: FPGA compute optimized.

  • Compute-optimized with NPU: NPU compute optimized.

  • ECS Bare Metal: ECS Bare Metal Instance server.

  • High Performance Compute: high-performance computing (HPC).

Compute-optimized with GPU

CpuArchitectures

array

任意

The CPU architectures of the instance. Valid values:

説明

N indicates that you can specify multiple CPU architectures. Valid values of N: 1 to 2.

  • X86.

  • ARM.

string

任意

The CPU architecture of the instance type. Valid values:

説明

N indicates that you can specify multiple CPU architectures. Valid values of N: 1 to 2.

  • X86.

  • ARM.

X86

PhysicalProcessorModels

array

任意

The processor models of the instance. N indicates that you can specify multiple processor models. Valid values of N: 1 to 10.

string

任意

The processor models of the instance. N indicates that you can specify multiple processor models. Valid values of N: 1 to 10.

Intel Xeon(Ice Lake) Platinum 8369B

MinimumEniQuantity

integer

任意

The minimum number of elastic network interfaces (ENIs) that the instance supports.

2

MinimumEniPrivateIpAddressQuantity

integer

任意

The minimum number of IPv4 addresses per elastic network interface (ENI) of the instance.

2

MinimumEniIpv6AddressQuantity

integer

任意

The minimum number of IPv6 addresses per elastic network interface (ENI) of the instance. [_single.params.InstancePatternInfos.

1

MinimumInitialCredit

integer

任意

The minimum initial vCPU credits for burstable instances (t5 and t6).

12

MinimumBaselineCredit

integer

任意

The minimum baseline vCPU computing performance (sum of all vCPUs) for burstable instances (t5 and t6).

12

MinimumMemorySize

number

任意

The minimum memory size of the instance. Unit: GiB.

4

MaximumMemorySize

number

任意

The maximum memory size of the instance. Unit: GiB.

4

MinimumGpuAmount

integer

任意

The minimum number of GPUs of the instance. Valid values: positive integers.

2

MaximumGpuAmount

integer

任意

The maximum number of GPUs of the instance. Valid values: positive integers.

2

SystemDiskCategories

array

任意

The multiple disk types of the system cloud disk. When a disk type of higher priority cannot be used, Auto Scaling automatically attempts the next-priority disk type to create the system cloud disk. Valid values:

  • cloud: basic cloud disk.

  • cloud_efficiency: ultra cloud disk.

  • cloud_ssd: standard SSD.

  • cloud_essd: ESSD.

説明

You cannot specify this parameter together with SystemDisk.Category.

string

任意

The multiple disk types of the system cloud disk. When a disk type of higher priority cannot be used, Auto Scaling automatically attempts the next-priority disk type to create the system cloud disk. Valid values:

  • cloud: basic cloud disk.

  • cloud_efficiency: ultra cloud disk.

  • cloud_ssd: standard SSD.

  • cloud_essd: ESSD.

説明

You cannot specify this parameter together with SystemDisk.Category.

cloud

Password

string

任意

The password of the ECS instance. The password must be 8 to 30 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. The following special characters are supported:

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

For Windows instances, the password cannot start with a forward slash (/).

説明

If you specify Password, use HTTPS to send the request to prevent password leaks.

123abc****

SystemDisk.Encrypted

boolean

任意

Specifies whether to encrypt the system cloud disk. Valid values:

  • true: encrypts the disk.

  • false: does not encrypt the disk.

Default value: false.

false

SystemDisk.KMSKeyId

string

任意

The ID of the KMS key used for the system cloud disk.

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

SystemDisk.EncryptAlgorithm

string

任意

The encryption algorithm for the system cloud disk. Valid values:

  • AES-256.

  • SM4-128.

Default value: AES-256.

AES-256

SystemDisk.ProvisionedIops

integer

任意

The provisioned IOPS (Input/Output Operations Per Second) performance metrics for the system disk.

説明

IOPS (Input/Output Operations Per Second) indicates the number of I/O operations that can be processed per second. It measures the read/write (output/input) capability of block storage.

100

SystemDisk.BurstingEnabled

boolean

任意

Specifies whether to enable the burst (performance burst) feature for the system cloud disk. Valid values:

  • true: enabled.

  • false: not enabled.

説明

This parameter is supported only when SystemDisk.Category is set to cloud_auto.

false

ImageOptions.LoginAsNonRoot

boolean

任意

Specifies whether the ECS instance uses the ecs-user user for logon. For more information, see Manage the logon name of an ECS instance. [Manage the logon name of an ECS instance](~~ 管理 ECS 实例的登录名

false

DeletionProtection

boolean

任意

The release protection property of the instance. Specifies whether the instance can be directly released from the ECS console or by calling the DeleteInstance operation, to prevent the instance from being accidentally deleted. Valid values:

  • true: Enables release protection. The instance cannot be directly released from the ECS console or by calling the DeleteInstance operation.

  • false: Disables release protection. The instance can be directly released from the ECS console or by calling the DeleteInstance operation.

説明

This property applies only to pay-as-you-go instances. It prevents instances scaled out by Auto Scaling from being accidentally deleted, but does not affect normal scale-in activities. Instances with release protection enabled can still be released by scale-in activities.

false

StorageSetId

string

任意

The ID of the storage set.

ss-bp67acfmxazb4p****

StorageSetPartitionNumber

integer

任意

The maximum number of partitions in the storage set. The value must be an integer that is greater than or equal to 2.

2

CustomPriorities

array<object>

任意

The custom priorities of ECS instance type and vSwitch combinations.

重要 This parameter takes effect only when the scaling policy of the scaling group is set to priority policy.

If an instance cannot be created based on the instance type and vSwitch combination with the highest priority, Auto Scaling automatically selects the combination with the next highest priority to create the instance.

説明

If you specify custom priorities for only some instance type and vSwitch combinations, the unspecified combinations have lower priorities than the specified ones. The priorities of the unspecified combinations are determined by the order of vSwitches in the scaling group and the order of instance types in the scaling configuration.

  • For example, if the vSwitch order in the scaling group is vsw1 and vsw2, the instance type order in the scaling configuration is type1 and type2, and the custom priority order is ["vsw2+type2", "vsw1+type2"], the final priority is: "vsw2+type2" > "vsw1+type2" > "vsw1+type1" > "vsw2+type1".

object

任意

InstanceType

string

任意

The instance type of the ECS instance.

説明

The instance type must be included in the instance type list of the scaling configuration.

ecs.c6a.4xlarge

VswitchId

string

任意

The ID of the vSwitch.

説明

The vSwitch must be included in the vSwitch list of the scaling group.

vsw-bp14zolna43z266bq****

NetworkInterfaces

array<object>

任意

The list of elastic network interfaces (ENIs).

object

任意

The elastic network interface (ENI).

InstanceType

string

任意

The type of the elastic network interface (ENI). When you use this parameter, you must use NetworkInterfaces to set the primary network interface controller (NIC). You cannot set SecurityGroupId or SecurityGroupIds at the same time. Valid values:

  • Primary: primary ENI.

  • Secondary: secondary ENI.

Default value: Secondary.

Primary

NetworkInterfaceTrafficMode

string

任意

The communication mode of the network interface controller (NIC). Valid values:

  • Standard: uses the TCP communication mode.

  • HighPerformance: enables the Elastic RDMA Interface (ERI) and uses the RDMA communication mode.

Default value: Standard.

説明

The number of elastic network interfaces (ENIs) in RDMA mode cannot exceed the limit of the instance family. For more information, see Instance families.

HighPerformance

Ipv6AddressCount

integer

任意

The number of randomly generated IPv6 addresses for the primary ENI. Note the following items:

This parameter takes effect only when NetworkInterface.InstanceType is set to Primary. If NetworkInterface.InstanceType is set to Secondary or left empty, you cannot specify this parameter.

After you specify this parameter, you cannot specify Ipv6AddressCount.

1

SecurityGroupIds

array

任意

The IDs of one or more security groups to which the elastic network interface (ENI) belongs.

string

任意

The IDs of one or more security groups to which the elastic network interface (ENI) belongs. Note the following items:

  • If NetworkInterface.InstanceType is set to Primary, you must set this parameter. In this case, this parameter has the same effect as SecurityGroupIds, but you cannot set SecurityGroupId or SecurityGroupIds again.

  • If NetworkInterface.InstanceType is set to Secondary or left empty, this parameter is optional. The default value is the security group of the ECS instance, which is the security group of the primary elastic network interface (ENI).

sg-2ze55shrxxxxx

SecondaryPrivateIpAddressCount

integer

任意

The number of secondary private IPv4 addresses to assign to the ENI. Valid values: 1 to 49.

  • The value cannot exceed the IP address limit for the instance type. For more information, see Instance families.

  • NetworkInterface.N.SecondaryPrivateIpAddressCount specifies the number of secondary private IPv4 addresses to assign to the ENI (excluding the primary private IP address of the ENI). The system randomly assigns IP addresses from the available CIDR block of the vSwitch (NetworkInterface.N.VSwitchId) to which the ENI belongs.

6

DedicatedHostClusterId

string

任意

The ID of the dedicated host cluster.

dc-zm04u8r3lohsq****

SecurityOptions

object

任意

The security options.

ConfidentialComputingMode

string

任意

The confidential computing mode. Valid values:

TDX

HttpEndpoint

string

任意

Specifies whether to enable the access channel for instance metadata. Valid values:

  • enabled: enabled.

  • disabled: disabled.

Default value: enabled.

説明

For more information about instance metadata, see Overview of ECS instance metadata.

enabled

HttpTokens

string

任意

Specifies whether to forcefully use the security-hardened mode (IMDSv2) to access instance metadata. Valid values:

  • optional: does not forcefully use the security-hardened mode.

  • required: forcefully uses the security-hardened mode. After you set this value, instance metadata cannot be accessed in normal mode.

Default value: optional.

説明

For more information about the modes for accessing instance metadata, see Access mode of instance metadata.

optional

InternetMaxBandwidthIn

integer

任意

The maximum inbound bandwidth for public network traffic. Unit: Mbit/s. Valid values:

  • If the purchased maximum outbound bandwidth for public network traffic is less than or equal to 10 Mbit/s: 1 to 10. Default value: 10.

  • If the purchased maximum outbound bandwidth for public network traffic is greater than 10 Mbit/s: 1 to the value of InternetMaxBandwidthOut. Default value: the value of InternetMaxBandwidthOut.

10

ResourcePoolOptions

object

任意

The resource pool policy used when instances are created. After you specify this parameter, note the following items:

  • This parameter takes effect only when pay-as-you-go instances are created.

  • This parameter cannot be specified together with PrivatePoolOptions.MatchCriteria or PrivatePoolOptions.Id.

Strategy

string

任意

Resource pools include private pools generated after elasticity assurance or capacity reservation takes effect, and public pools, which are available for instance startup. Valid values:

  • PrivatePoolFirst: private pool first. When this strategy is selected and ResourcePoolOptions.PrivatePoolIds is specified or PrivatePoolTags conditions are met, the corresponding private pools are used first. If no private pool is specified or the specified private pool has insufficient capacity, open-type private pools are automatically matched. If no matching private pool is available, the public pool is used to create instances.

  • PrivatePoolOnly: private pool only. When this strategy is selected, you must specify ResourcePoolOptions.PrivatePoolIds. If the specified private pool has insufficient capacity, the instance fails to start.

  • PublicPoolFirst: public pool first. The public pool is used first to create instances. When public pool resources are insufficient, private pool resources are used as a supplement. Open-type private pools are automatically matched first. If no matching private pool is available, the Target-type private pools specified by ResourcePoolOptions.PrivatePoolIds or matching PrivatePoolTags conditions are used. (This strategy is in invitational preview and is not available for use.)

  • None: does not use a resource pool strategy.

Default value: None.

PrivatePoolFirst

PrivatePoolIds

array

任意

The IDs of private pools, which are the IDs of elasticity assurance or capacity reservation. Only Target-type private pool IDs can be specified. This parameter cannot be specified together with the PrivatePoolTags parameter.

string

任意

The ID of a private pool, which is the ID of an elasticity assurance or capacity reservation. Only Target-type private pool IDs can be specified. This parameter cannot be specified together with the PrivatePoolTags parameter. Valid values of N: 1 to 20.

eap-bp67acfmxazb4****

PrivatePoolTags

array<object>

任意

Filters available Target private pools by tags. Valid values of N: 1 to 20. Note:

  • When this parameter is specified, the system filters only the Target private pools associated with the account that match the tags and satisfy the scaling group constraints such as zone and instance type.

  • Tag matching rule: A private pool must match all specified tags.

  • This parameter cannot be specified together with the PrivatePoolIds parameter.

object

任意

Filters available Target private pools by tags. Valid values of N: 1 to 20. Note:

  • When this parameter is specified, the system filters only the Target private pools associated with the account that match the tags and satisfy the scaling group constraints such as zone and instance type.

  • Tag matching rule: A private pool must match all specified tags.

  • This parameter cannot be specified together with the PrivatePoolIds parameter.

Key

string

任意

The tag key of the private pool.

TestKey

Value

string

任意

The tag value of the private pool.

TestValue

InstanceTypeCandidateOptions

object

任意

After the alternative mode is enabled, when issues such as insufficient inventory occur, similar instance types of the same size are supplemented based on the currently selected instance types, or vSwitches in alternative zones are created and added to the scaling group.

Enabled

boolean

任意

Specifies whether to enable the alternative mode.

true

MaxPrice

number

任意

The maximum price for alternative instance types.

1.5

AllowDifferentGeneration

boolean

任意

Specifies whether to allow supplementing instance types of other generations.

  • For example, if the current instance type is ecs.c7.large, enabling this option allows alternative instance types such as ecs.c6.large and ecs.c8.large.

true

AllowCrossAz

boolean

任意

Specifies whether to allow supplementing vSwitches in other zones.

説明

The instance type remains unchanged. Only alternative zones are selected. When all selected zones in the scaling group cannot be used for scale-out due to issues such as insufficient inventory, new zone vSwitches are automatically added to the scaling group based on this configuration. For example, if the scaling group is configured with the cn-hangzhou-h and cn-hangzhou-g zones, and neither zone can be used for scale-out, Auto Scaling may create a vSwitch in cn-hangzhou-k based on real-time inventory and add it to the scaling group.

true

AllowCidrBlocks

array

任意

The CIDR blocks for optional vSwitches when supplementing vSwitches in other zones is allowed.

string

任意

The CIDR blocks for optional vSwitches when supplementing vSwitches in other zones is allowed.

172.16.0.0/24

レスポンスフィールド

フィールド

説明

object

The response returned after the scaling configuration is modified.

RequestId

string

The request ID.

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

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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