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

Auto Scaling:DescribeScalingConfigurations

最終更新日:Oct 13, 2026

インスタンスタイプやイメージを含む ECS タイプのスケーリング設定を照会し、スケールアウト時に使用される ECS インスタンステンプレートの詳細を取得します。

今すぐお試しください

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

get

*スケーリンググループ。

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

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

必須

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

cn-qingdao

PageNumber

integer

任意

スケーリング設定リストのページ番号。開始値は 1 です。

デフォルト値: 1

1

PageSize

integer

任意

ページングクエリのページング設定項目でセットされた 1 ページあたりのエントリ数。最大値: 50。

デフォルト値: 10

50

ScalingGroupId

string

任意

スケーリンググループの ID。スケーリンググループ内のすべてのスケーリング設定を照会できます。

asg-bp17pelvl720x3v7****

ScalingConfigurationIds

array

任意

照会するスケーリング設定の ID。

クエリ結果には、アクティブなスケーリング設定と非アクティブなスケーリング設定の両方が含まれます。状態はレスポンスパラメーター LifecycleState で示されます。

string

任意

照会するスケーリング設定の ID。

クエリ結果には、アクティブなスケーリング設定と非アクティブなスケーリング設定の両方が含まれます。状態はレスポンスパラメーター LifecycleState で示されます。

asc-bp17pelvl720x5ub****

ScalingConfigurationNames

array

任意

照会するスケーリング設定の名前。

クエリ結果では、無効なスケーリング設定名は無視され、エラーは返されません。

string

任意

照会するスケーリング設定の名前。

クエリ結果では、無効なスケーリング設定名は無視され、エラーは返されません。

scalingcon****

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエスト ID。

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

PageNumber

integer

現在のページ番号。

1

PageSize

integer

1 ページあたりのエントリ数。

50

TotalCount

integer

スケーリング設定の総数。

1

ScalingConfigurations

array<object>

スケーリング設定。

array<object>

スケーリング設定。

DeploymentSetId

string

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

ds-bp1frxuzdg87zh4p****

CreationTime

string

スケーリング設定が作成された時間。時間は ISO 8601 規格に従い、YYYY-MM-DDTHH:mmZ フォーマットで表されます。時間は協定世界時 (UTC) で表示されます。

2014-08-14T10:58Z

ScalingConfigurationName

string

スケーリング設定名。

scalingconfigura****

SystemDiskDescription

string

システムクラウドディスクの説明。

Test system disk.

KeyPairName

string

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

keypair****

SecurityGroupId

string

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

sg-bp18kz60mefs****

PrivatePoolOptions.Id

string

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

eap-bp67acfmxazb4****

SystemDiskAutoSnapshotPolicyId

string

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

sp-bp12m37ccmxvbmi5****

SpotStrategy

string

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

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

  • SpotWithPriceLimit: 1 時間あたりの最大値価格が設定されたスポットインスタンス。

  • SpotAsPriceGo: 現在の市場価格に基づいてシステムが自動的に入札するスポットインスタンス。

NoSpot

ScalingGroupId

string

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

asg-bp17pelvl720x3v7****

Affinity

string

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

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

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

default

Tenancy

string

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

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

  • host: 専用ホストにインスタンスを作成します。DedicatedHostId パラメーターを指定しない場合、Alibaba Cloud はインスタンス用の専用ホストを自動的に選択します。 デフォルト値: default。

default

SystemDiskSize

integer

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

100

Ipv6AddressCount

integer

エラスティックネットワークインターフェイス (NIC) に対してランダムに生成される IPv6 アドレスの数。

1

SpotDuration

integer

スポットインスタンスの保護期間。単位: 時間。

1

LifecycleState

string

スケーリンググループ内のスケーリング設定のライフサイクルステータス。有効な値:

  • Active: スケーリング設定はアクティブです。スケーリンググループは、アクティブなスケーリング設定を使用して ECS インスタンスを自動作成します。

  • Inacitve: スケーリング設定は非アクティブです。非アクティブなスケーリング設定はスケーリンググループ内に存在しますが、スケーリンググループはこれらを使用して ECS インスタンスを自動作成しません。

Active

InstanceName

string

ECS インスタンス名。

instance****

SecurityEnhancementStrategy

string

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

  • Active: セキュリティ強化を有効にします。この値はパブリックイメージにのみ適用されます。

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

Active

UserData

string

ECS インスタンスのユーザーデータ。

echo hello ecs!

PrivatePoolOptions.MatchCriteria

string

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

  • Open: オープンモード。システムは Open タイプの非公開プールを自動的にマッチングします。一致する非公開プールがない場合、システムはパブリックプールからのリソースを使用してインスタンスを起動します。

  • Target: ターゲットモード。システムは指定された非公開プールを使用してインスタンスを起動します。指定された非公開プールが利用できない場合、インスタンスの起動は失敗します。

  • None: 非公開プールなし。システムは非公開プールを使用せずにインスタンスを起動します。

Open

DedicatedHostId

string

ECS インスタンスを作成する専用ホストの ID。専用ホストはスポットインスタンスをサポートしていません。DedicatedHostId パラメーターを指定すると、SpotStrategy パラメーターと SpotPriceLimit パラメーターは無視されます。 DescribeDedicatedHosts 操作を呼び出し、専用ホスト ID のリストをクエリできます。

dh-bp67acfmxazb4p****

InstanceGeneration

string

ECS インスタンスの世代。

ecs-3

HpcClusterId

string

ECS インスタンスが属する High Performance Computing (HPC) クラスターの ID。

hpc-clus****

PasswordInherit

boolean

イメージにプリセットされたパスワードを使用するかどうかを指定します。

true

Memory

integer

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

説明

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

16

ImageId

string

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

centos6u5_64_20G_aliaegis_2014****.vhd

ImageFamily

string

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

hangzhou-daily-update

ImageOwnerAlias

string

イメージのソース。有効な値:

  • system: Alibaba Cloud が提供するパブリックイメージ。

  • self: ユーザーが作成したカスタムイメージ。

  • others: 他の Alibaba Cloud ユーザーが提供する共有イメージまたはコミュニティイメージ。

  • marketplace: Alibaba Cloud マーケットプレイスが提供するイメージ。

system

LoadBalancerWeight

integer

ECS インスタンスを SLB バックエンドサーバーとして使用する場合の重み。有効な値: 1~100。

1

SystemDiskCategory

string

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

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

  • cloud_efficiency: Ultra ディスク。

  • cloud_ssd: 標準 SSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_essd: ESSD。

  • cloud_auto: ESSD AutoPL ディスク。

cloud

HostName

string

ECS インスタンスのホスト名。

LocalHost

SystemDiskName

string

システムクラウドディスクの名前。

cloud_ssd_Test

InternetMaxBandwidthOut

integer

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

10

InternetMaxBandwidthIn

integer

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

10

InstanceType

string

ECS インスタンスのインスタンスタイプ。

ecs.g6.large

InstanceDescription

string

ECS インスタンスの説明。

FinanceDept

IoOptimized

string

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

  • none: 非 I/O 最適化。

  • optimized: I/O 最適化。

none

RamRoleName

string

ECS インスタンスの Resource Access Management (RAM) ロールの名前。RAM ロールは RAM によって提供および維持されます。ListRoles 操作を呼び出し、利用可能な RAM ロールをクエリできます。

ramrole****

SystemDiskPerformanceLevel

string

システムクラウドディスクが ESSD (標準 SSD) である場合のパフォーマンスレベル。

PL1

Cpu

integer

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

説明

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

2

ResourceGroupId

string

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

rg-aekzn2ou7xo****

ZoneId

string

インスタンスのゾーン ID。DescribeZones 操作を呼び出し、ゾーンリストをクエリできます。

cn-hangzhou-g

InternetChargeType

string

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

  • PayByBandwidth: 帯域幅課金。この場合、InternetMaxBandwidthOut パラメーターは固定帯域幅値を指定します。

  • PayByTraffic: トラフィック課金。この場合、InternetMaxBandwidthOut パラメーターは帯域幅上限を指定し、実際のネットワークトラフィックに基づいて課金されます。

PayByTraffic

ImageName

string

イメージの名前。

centos6u5_64_20G_aliaegis_2014****.vhd

ScalingConfigurationId

string

スケーリング設定の ID。

asc-bp1ezrfgoyn5kijl****

CreditSpecification

string

バースト可能インスタンスのパフォーマンスモード。有効な値:

Standard

SpotInterruptionBehavior

string

スポットインスタンスの中断パターン。

Terminate

CustomPriorities

array<object>

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

重要 このパラメーターは、スケーリンググループのスケーリングポリシーが優先度ベースのポリシーにセットされている場合にのみ効果があります。
最も優先度の高い ECS インスタンスタイプと vSwitch の組み合わせを使用してインスタンスを作成できない場合、Auto Scaling は次に優先度の高い組み合わせを使用して ECS インスタンスを自動的に作成します。

説明

一部のインスタンスタイプと vSwitch の組み合わせに対してのみカスタム優先度を指定した場合、指定されていない組み合わせの優先度は指定されたものよりも低くなります。指定されていない組み合わせの優先度は、スケーリンググループ内の vSwitch のシーケンスとスケーリング設定内の ECS インスタンスタイプのシーケンスに基づいて決定されます。

  • たとえば、スケーリンググループ内の vSwitch のシーケンスが vsw1 と vsw2、スケーリング設定内の ECS インスタンスタイプのシーケンスが type1 と type2、カスタム優先度のシーケンスが ["vsw2+type2", "vsw1+type2"] である場合、最終的な優先度のシーケンスは "vsw2+type2" > "vsw1+type2" > "vsw1+type1" > "vsw2+type1" となります。

object

InstanceType

string

ECS インスタンスのインスタンスタイプ。

ecs.c6a.4xlarge

VswitchId

string

vSwitch の ID。

vsw-bp14zolna43z266bq****

DataDisks

array<object>

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

object

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

PerformanceLevel

string

データクラウドディスクが ESSD (標準 SSD) である場合のパフォーマンスレベル。

PL1

Description

string

データクラウドディスクの説明。

FinanceDept

SnapshotId

string

データクラウドディスクの作成に使用されるスナップショットの ID。

s-23f2i****

Device

string

データクラウドディスクのマウントポイント。

/dev/xvdb

Size

integer

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

  • cloud: 5~2000。

  • cloud_efficiency: 20~32768。

  • cloud_ssd: 20~32768。

  • cloud_essd: 20~32768。

  • ephemeral_ssd: 5~800。

200

DiskName

string

データクラウドディスクの名前。

cloud_ssdData

AutoSnapshotPolicyId

string

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

sp-bp19nq9enxqkomib****

Category

string

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

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

  • cloud_efficiency: Ultra ディスク。

  • cloud_ssd: 標準 SSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_essd: ESSD。

  • cloud_auto: ESSD AutoPL ディスク。

  • cloud_regional_disk_auto: リージョン ESSD。

cloud

KMSKeyId

string

データクラウドディスクを暗号化するために使用される Key Management サービス (KMS) キーの ID。

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

DeleteWithInstance

boolean

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

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

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

true

Encrypted

string

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

  • true: データクラウドディスクを暗号化します。

  • false: データクラウドディスクを暗号化しません。 デフォルト値: false。

false

Categories

array

データクラウドディスクのディスクタイプ。最初のディスクタイプが最も高い優先度を持ち、他のディスクタイプの優先度はシーケンスで低くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は次に優先度の高いディスクタイプを使用してデータクラウドディスクの作成を自動的に試みます。有効な値:

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

  • cloud_efficiency: Ultra ディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_auto: ESSD AutoPL ディスク。

  • cloud_regional_disk_auto: リージョン ESSD。

string

データクラウドディスクのディスクタイプ。最初のディスクタイプが最も高い優先度を持ち、他のディスクタイプの優先度はシーケンスで低くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は次に優先度の高いディスクタイプを使用してデータクラウドディスクの作成を自動的に試みます。有効な値:

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

  • cloud_efficiency: Ultra ディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • ephemeral_ssd: ローカル SSD。

  • cloud_auto: ESSD AutoPL ディスク。

  • cloud_regional_disk_auto: リージョン ESSD。

cloud_essd

ProvisionedIops

integer

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

説明

IOPS は 1 秒あたりの I/O 操作数を測定し、ブロックストレージの読み取りおよび書き込み機能を示します。単位: 操作/秒。

100

BurstingEnabled

boolean

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

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

  • false: 機能を無効にします。

説明

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

false

Tags

array<object>

タグ。

object

タグ。

Key

string

インスタンスのタグ N のキー。N の有効な値: 1~20。 このパラメーターを指定する場合、空文字列にすることはできません。タグキーの長さは最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

binary

Value

string

インスタンスのタグ N の値。N の有効な値: 1~20。 このパラメーターを指定する場合、空文字列にすることができます。タグ値の長さは最大 128 文字です。acs: で始めることはできず、http:// または https:// を含めることはできません。

alterTable

SpotPriceLimits

array<object>

スポットインスタンス。

object

スポットインスタンス。

InstanceType

string

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

ecs.g6.large

PriceLimit

number

スポットインスタンスの入札価格。

0.125

InstancePatternInfos

array<object>

要件を満たすインスタンスタイプをフィルター処理するために使用されるインテリジェント構成フォーマットのコレクション。

object

要件を満たすインスタンスタイプをフィルター処理するために使用されるインテリジェント構成フォーマットのコレクション。

MaxPrice

number

従量課金インスタンスまたはスポットインスタンスに対して許容される時間単価の最大値。

2

Cores

integer

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

2

Memory

number

インスタンスタイプのメモリサイズ。単位: GiB。

4

InstanceFamilyLevel

string

インスタンスファミリーのレベル。有効な値:

  • EntryLevel: エントリーレベルのインスタンスファミリー。共有インスタンスファミリーです。これらのインスタンスファミリーは費用対効果が高いですが、一貫したコンピューティングパフォーマンスは保証されません。CPU 使用率が低いワークロードに適しています。詳細なフォーマットについては、「共有インスタンスファミリー」を参照してください。

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

  • CreditEntryLevel: クレジットエントリーレベルのインスタンスファミリー。バースト可能インスタンスです。これらのインスタンスファミリーは CPU クレジットを使用してコンピューティングパフォーマンスを維持し、CPU 使用率は低いものの時折 CPU バーストが発生するワークロードに適しています。詳細なフォーマットについては、「バースト可能インスタンス」を参照してください。

EnterpriseLevel

Architectures

array

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

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

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

  • BareMental: ECS ベアメタルサーバー。

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

string

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

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

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

  • BareMental: ECS ベアメタルサーバー。

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

X86

BurstablePerformance

string

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

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

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

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

Include

ExcludedInstanceTypes

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*

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: ECS ベアメタルサーバー。

  • 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 ベアメタルサーバー。

  • 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

MinimumEniQuantity

integer

インスタンスにアタッチできるエラスティックネットワークインターフェース (ENI) の最大値の最小値。

2

MinimumEniPrivateIpAddressQuantity

integer

インスタンス上の単一のエラスティックネットワークインターフェース (ENI) でサポートされる IPv4 アドレスの最大値の最小値。各 ENI はネットワークインターフェースコントローラー (NIC) です。

2

MinimumEniIpv6AddressQuantity

integer

インスタンス上の単一のエラスティックネットワークインターフェース (ENI) でサポートされる IPv6 アドレスの最大値の最小値。各 ENI はネットワークインターフェースコントローラー (NIC) です。

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

システムクラウドディスクのディスクタイプ。最初のディスクタイプの優先度が最も高く、他のディスクタイプの優先度はシーケンスで低くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は次に優先度の高いディスクタイプを使用してシステムクラウドディスクの作成を自動的に呼び出します。有効な値:

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

  • cloud_efficiency: Ultra クラウドディスク。

  • cloud_ssd: 標準 SSD クラウドディスク。

  • cloud_essd: ESSD クラウドディスク。

string

システムクラウドディスクのディスクタイプ。最初のディスクタイプの優先度が最も高く、他のディスクタイプの優先度はシーケンスで低くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は次に優先度の高いディスクタイプを使用してシステムクラウドディスクの作成を自動的に呼び出します。有効な値:

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

  • cloud_efficiency: Ultra クラウドディスク。

  • cloud_ssd: 標準 SSD クラウドディスク。

  • cloud_essd: ESSD クラウドディスク。

cloud

WeightedCapacities

array

指定されたインスタンスタイプの重み。スケーリンググループ内で指定されたインスタンスタイプの単一インスタンスが提供する容量を示します。重みが大きいほど、予想される容量を満たすために必須となるそのインスタンスタイプのインスタンス数が少なくなります。

integer

指定されたインスタンスタイプの重み。スケーリンググループ内で指定されたインスタンスタイプの単一インスタンスが提供する容量を示します。重みが大きいほど、予想される容量を満たすために必須となるそのインスタンスタイプのインスタンス数が少なくなります。

4

InstanceTypes

array

ECS インスタンスのインスタンスタイプのコレクション。

string

ECS インスタンスのインスタンスタイプのコレクション。

ecs.g6.large

SecurityGroupIds

array

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

string

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

sg-bp18kz60mefs****

SchedulerOptions

object

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

ManagedPrivateSpaceId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

testManagedPrivateSpaceId

SystemDiskEncrypted

boolean

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

  • true: システムクラウドディスクは暗号化されています。

  • false: システムクラウドディスクは暗号化されていません。

false

SystemDiskKMSKeyId

string

システムクラウドディスクに使用される KMS キーの ID。

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

SystemDiskEncryptAlgorithm

string

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

  • AES-256。

  • SM4-128。

AES-256

SystemDiskProvisionedIops

integer

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

説明

IOPS は、1 秒間に処理できる I/O 操作の数を指し、ブロックストレージの読み取りおよび書き込み処理能力を示します。単位: 操作/秒。

100

SystemDiskBurstingEnabled

boolean

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

  • true: 有効。

  • false: 無効。

説明

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

false

ImageOptionsLoginAsNonRoot

boolean

ecs-user ユーザーとして ECS インスタンスにログインするかどうかを指定します。有効な値:

  • true: はい。

  • false: いいえ。

false

DeletionProtection

boolean

インスタンスのリリース保護プロパティ。ECS コンソールまたは DeleteInstance API オペレーションを使用してインスタンスを直接リリースできるかどうかを指定します。有効な値:

  • true: リリース保護が有効です。ECS コンソールまたは DeleteInstance API オペレーションを使用してインスタンスを直接リリースすることはできません。

  • false: リリース保護がシャットダウンされています。ECS コンソールまたは DeleteInstance API オペレーションを使用してインスタンスを直接リリースできます。

説明

このプロパティは従量課金インスタンスにのみ適用されます。スケールアウト時に Auto Scaling によって作成されたインスタンスが誤って削除されるのを防ぎますが、通常のスケールイン活動には影響しません。リリース保護が有効になっているインスタンスも、スケールイン活動中にリリースされる可能性があります。

false

StorageSetId

string

ストレージセットの ID。

ss-bp67acfmxazb4p****

StorageSetPartitionNumber

integer

ストレージセット内のパーティションの最大値。値は 2 以上の整数である必要があります。

2

NetworkInterfaces

array<object>

エラスティックネットワークインターフェイス (ENI) のリスト。各 ENI はネットワークインターフェースコントローラー (NIC) です。

object

エラスティックネットワークインターフェイス (ENI)。各 ENI はネットワークインターフェースコントローラー (NIC) です。

InstanceType

string

エラスティックネットワークインターフェイス (ENI) のタイプ。有効な値:

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

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

Primary

NetworkInterfaceTrafficMode

string

ネットワークインターフェースコントローラー (NIC) として機能するエラスティックネットワークインターフェース (ENI) の通信パターン。有効な値:

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

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

HighPerformance

Ipv6AddressCount

integer

プライマリ ENI に指定されたランダムに生成される IPv6 アドレスの数。

1

SecurityGroupIds

array

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

string

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

sg-2vc3e1v7xxxxx

SecondaryPrivateIpAddressCount

integer

ENI に指定されたセカンダリ非公開 IPv4 アドレスの数。有効な値: 1~49。

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

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

2

VSwitchIds

array

エラスティックネットワークインターフェイス (ENI) が属する vSwitch の ID。各 ENI はネットワークインターフェースコントローラー (NIC) です。

string

エラスティックネットワークインターフェイス (ENI) が属する vSwitch の ID。各 ENI はネットワークインターフェースコントローラー (NIC) です。

vsw-bp67acfmxazb4p****

DedicatedHostClusterId

string

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

dc-zm04u8r3lohsq****

PasswordSetted

boolean

インスタンスパスワードが設定されているかどうかを指定します。有効な値:

  • true: インスタンスパスワードが設定されています。

  • false: インスタンスパスワードが設定されていません。

false

SecurityOptions

object

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

ConfidentialComputingMode

string

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

TDX

HttpEndpoint

string

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

  • enabled: 有効。

  • disabled: 無効。

enabled

HttpTokens

string

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

  • optional: オプション。強制的に使用しません。

  • required: 必須。強制的に使用します。この値がセットされている場合、通常モードではインスタンスメタデータにアクセスできません。

optional

ResourcePoolOptions

object

インスタンスの作成時に使用されるリソースプールポリシー。

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

Strategy

string

リソースプールには、エラスティシティ保証または容量予約サービスが効果を持った後に生成される非公開プールと、インスタンスの起動呼び出し時に選択可能なパブリックプールが含まれます。有効な値:

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

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

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

  • None: リソースプールポリシーは使用されません。

PrivatePoolFirst

PrivatePoolIds

array

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

string

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

eap-bp67acfmxazb4****

PrivatePoolTags

array<object>

利用可能なターゲット非公開プールをタグでフィルター処理します。

object

利用可能なターゲット非公開プールをタグでフィルター処理します。

Key

string

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

TestKey

Value

string

非公開プールのタグ値。

TestValue

InstanceTypeCandidateOptions

object

フォールバックモードが設定された後、在庫不足などの問題が発生した場合、システムは選択されたインスタンスタイプを同じサイズの類似したインスタンスタイプで補充するか、フォールバックゾーンに vSwitch を作成してスケーリンググループに追加します。

Enabled

boolean

フォールバックモードを有効にするかどうかを指定します。

true

MaxPrice

number

フォールバックインスタンスタイプの最大値。

2

AllowDifferentGeneration

boolean

他の世代のインスタンスタイプによる補充を許可するかどうかを指定します。

  • たとえば、現在のインスタンスタイプが ecs.c7.large の場合、このオプションを有効にすると、ecs.c6.large や ecs.c8.large などのインスタンスタイプへのフォールバックが許可されます。

true

AllowCrossAz

boolean

他のゾーンの vSwitch の追加を許可するかどうかを指定します。

説明

インスタンスタイプは変更されず、代替として新しいゾーンのみが選択されます。在庫不足やその他の問題により、選択されたすべてのゾーンでスケーリンググループがスケールアウトに失敗した場合、この構成により新しいゾーンの vSwitch がスケーリンググループに自動的に追加されます。 たとえば、スケーリンググループに cn-hangzhou-h ゾーンと cn-hangzhou-g ゾーンが構成されており、両方のゾーンでスケールアウトに失敗した場合、Auto Scaling はリアルタイムの在庫に基づいて cn-hangzhou-k ゾーンに vSwitch を作成し、それをスケーリンググループに追加する場合があります。

true

AllowCidrBlocks

array

別のゾーンの vSwitch の追加が許可されている場合に選択できる vSwitch の CIDR ブロック。

string

別のゾーンの vSwitch の追加が許可されている場合に選択できる vSwitch の CIDR ブロック。

172.16.0.0/24

CpuOptions

object

CPU オプション。

NestedVirtualization

string

ハードウェアベースの入れ子になった仮想化を有効にするかどうかを指定します。有効な値:

  • enabled: 有効。

  • disabled: 無効。

enabled

SecondaryEniVSwitchConstraint

string

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

Strict

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "ScalingConfigurations": [
    {
      "DeploymentSetId": "ds-bp1frxuzdg87zh4p****",
      "CreationTime": "2014-08-14T10:58Z",
      "ScalingConfigurationName": "scalingconfigura****",
      "SystemDiskDescription": "Test system disk.",
      "KeyPairName": "keypair****",
      "SecurityGroupId": "sg-bp18kz60mefs****",
      "PrivatePoolOptions.Id": "eap-bp67acfmxazb4****",
      "SystemDiskAutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
      "SpotStrategy": "NoSpot",
      "ScalingGroupId": "asg-bp17pelvl720x3v7****",
      "Affinity": "default",
      "Tenancy": "default",
      "SystemDiskSize": 100,
      "Ipv6AddressCount": 1,
      "SpotDuration": 1,
      "LifecycleState": "Active",
      "InstanceName": "instance****",
      "SecurityEnhancementStrategy": "Active",
      "UserData": "echo hello ecs!\t\n",
      "PrivatePoolOptions.MatchCriteria": "Open",
      "DedicatedHostId": "dh-bp67acfmxazb4p****",
      "InstanceGeneration": "ecs-3",
      "HpcClusterId": "hpc-clus****",
      "PasswordInherit": true,
      "Memory": 16,
      "ImageId": "centos6u5_64_20G_aliaegis_2014****.vhd",
      "ImageFamily": "hangzhou-daily-update",
      "ImageOwnerAlias": "system",
      "LoadBalancerWeight": 1,
      "SystemDiskCategory": "cloud",
      "HostName": "LocalHost",
      "SystemDiskName": "cloud_ssd_Test",
      "InternetMaxBandwidthOut": 10,
      "InternetMaxBandwidthIn": 10,
      "InstanceType": "ecs.g6.large",
      "InstanceDescription": "FinanceDept",
      "IoOptimized": "none",
      "RamRoleName": "ramrole****",
      "SystemDiskPerformanceLevel": "PL1",
      "Cpu": 2,
      "ResourceGroupId": "rg-aekzn2ou7xo****",
      "ZoneId": "cn-hangzhou-g",
      "InternetChargeType": "PayByTraffic",
      "ImageName": "centos6u5_64_20G_aliaegis_2014****.vhd\t\n",
      "ScalingConfigurationId": "asc-bp1ezrfgoyn5kijl****",
      "CreditSpecification": "Standard",
      "SpotInterruptionBehavior": "Terminate",
      "CustomPriorities": [
        {
          "InstanceType": "ecs.c6a.4xlarge",
          "VswitchId": "vsw-bp14zolna43z266bq****\n"
        }
      ],
      "DataDisks": [
        {
          "PerformanceLevel": "PL1",
          "Description": "FinanceDept",
          "SnapshotId": "s-23f2i****",
          "Device": "/dev/xvdb",
          "Size": 200,
          "DiskName": "cloud_ssdData",
          "AutoSnapshotPolicyId": "sp-bp19nq9enxqkomib****",
          "Category": "cloud",
          "KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****",
          "DeleteWithInstance": true,
          "Encrypted": "false",
          "Categories": [
            "cloud_essd"
          ],
          "ProvisionedIops": 100,
          "BurstingEnabled": false
        }
      ],
      "Tags": [
        {
          "Key": "binary",
          "Value": "alterTable"
        }
      ],
      "SpotPriceLimits": [
        {
          "InstanceType": "ecs.g6.large\t\n",
          "PriceLimit": 0.125
        }
      ],
      "InstancePatternInfos": [
        {
          "MaxPrice": 2,
          "Cores": 2,
          "Memory": 4,
          "InstanceFamilyLevel": "EnterpriseLevel",
          "Architectures": [
            "X86"
          ],
          "BurstablePerformance": "Include",
          "ExcludedInstanceTypes": [
            "ecs.n1.small/ecs.n1.*/*7*"
          ],
          "InstanceTypeFamilies": [
            "ecs.g6"
          ],
          "MinimumCpuCoreCount": 2,
          "MaximumCpuCoreCount": 4,
          "GpuSpecs": [
            "NVIDIA V100"
          ],
          "InstanceCategories": [
            "Compute-optimized with GPU"
          ],
          "CpuArchitectures": [
            "X86"
          ],
          "PhysicalProcessorModels": [
            "Intel Xeon(Ice Lake) Platinum 8369B"
          ],
          "MinimumEniQuantity": 2,
          "MinimumEniPrivateIpAddressQuantity": 2,
          "MinimumEniIpv6AddressQuantity": 1,
          "MinimumInitialCredit": 12,
          "MinimumBaselineCredit": 12,
          "MinimumMemorySize": 4,
          "MaximumMemorySize": 4,
          "MinimumGpuAmount": 2,
          "MaximumGpuAmount": 2
        }
      ],
      "SystemDiskCategories": [
        "cloud"
      ],
      "WeightedCapacities": [
        4
      ],
      "InstanceTypes": [
        "ecs.g6.large"
      ],
      "SecurityGroupIds": [
        "sg-bp18kz60mefs****"
      ],
      "SchedulerOptions": {
        "ManagedPrivateSpaceId": "testManagedPrivateSpaceId"
      },
      "SystemDiskEncrypted": false,
      "SystemDiskKMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****\t\n",
      "SystemDiskEncryptAlgorithm": "AES-256\t\n",
      "SystemDiskProvisionedIops": 100,
      "SystemDiskBurstingEnabled": false,
      "ImageOptionsLoginAsNonRoot": false,
      "DeletionProtection": false,
      "StorageSetId": "ss-bp67acfmxazb4p****",
      "StorageSetPartitionNumber": 2,
      "NetworkInterfaces": [
        {
          "InstanceType": "Primary",
          "NetworkInterfaceTrafficMode": "HighPerformance",
          "Ipv6AddressCount": 1,
          "SecurityGroupIds": [
            "sg-2vc3e1v7xxxxx"
          ],
          "SecondaryPrivateIpAddressCount": 2,
          "VSwitchIds": [
            "vsw-bp67acfmxazb4p****"
          ]
        }
      ],
      "DedicatedHostClusterId": "dc-zm04u8r3lohsq****",
      "PasswordSetted": false,
      "SecurityOptions": {
        "ConfidentialComputingMode": "TDX"
      },
      "HttpEndpoint": "enabled",
      "HttpTokens": "optional",
      "ResourcePoolOptions": {
        "Strategy": "PrivatePoolFirst",
        "PrivatePoolIds": [
          "eap-bp67acfmxazb4****"
        ],
        "PrivatePoolTags": [
          {
            "Key": "TestKey",
            "Value": "TestValue"
          }
        ]
      },
      "InstanceTypeCandidateOptions": {
        "Enabled": true,
        "MaxPrice": 2,
        "AllowDifferentGeneration": true,
        "AllowCrossAz": true,
        "AllowCidrBlocks": [
          "172.16.0.0/24\n"
        ]
      },
      "CpuOptions": {
        "NestedVirtualization": "enabled"
      },
      "SecondaryEniVSwitchConstraint": "Strict"
    }
  ]
}

エラーコード

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

変更履歴

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