スケーリンググループ ID、インスタンスタイプ、インスタンスイメージなどの情報を指定して CreateScalingConfiguration 操作の呼び出しにより、スケーリンググループ用の ECS タイプのスケーリング設定を作成します。
操作説明
操作の説明
スケーリング設定は、エラスティックスケールアウトに使用される ECS インスタンステンプレートを指定します。以下のインスタンス設定メソッドがサポートされています。
-
InstancePatternInfo.N: インテリジェント設定モード。特定のインスタンスタイプを指定する必要はありません。ビジネス要件に基づいて、vCPU 数、メモリサイズ、インスタンスファミリーレベル、最大値を指定するだけです。システムは要件を満たすインスタンスタイプを自動的にフィルターし、最も価格の低いインスタンスタイプを優先的に選択して ECS インスタンスを作成します。このモードは、ネットワークタイプが VPC のスケーリンググループにのみ適用され、スケールアウト時のインスタンスタイプの在庫不足のリスクを効果的に低減できます。
-
InstanceType: 単一のインスタンスタイプを指定します。
-
InstanceTypes.N: 複数のインスタンスタイプを指定します。
-
InstanceTypeOverride.N: 複数のインスタンスタイプを指定し、異なるインスタンスタイプに重みを設定します。
-
Cpu および Memory: vCPU とメモリの有効値を指定してインスタンスタイプを定義します。Auto Scaling は、I/O 最適化やゾーンなどの要因に基づいて利用可能なインスタンスタイプを決定し、価格が最も低いインスタンスを価格順に作成します。このメソッドは、スケーリンググループのスケーリングポリシーがコスト最適化であり、スケーリング設定でインスタンスタイプが指定されていない場合にのみ適用されます。
-
以下のいずれかのメソッドを使用してプライマリネットワークインターフェイスを構成できます。ただし、API 呼び出しごとに使用できるメソッドは 1 つだけです。両方のメソッドを同じ時間に使用すると、呼び出しは失敗し、エラーメッセージが返されます。
SecurityGroupId、SecurityGroupIds.N、Ipv6AddressCount などのパラメーターを使用して、プライマリネットワークインターフェイスを直接構成します。
NetworkInterfaces.N を使用して、プライマリおよびセカンダリネットワークインターフェイスを構成します。このパラメーターを使用する場合は、プライマリネットワークインターフェイスを構成する必要があります。NetworkInterfaces.N.InstanceType が Primary に設定されている場合、プライマリネットワークインターフェイスが構成されます。NetworkInterfaces.N.InstanceType が Secondary に設定されているか、空の場合、セカンダリネットワークインターフェイスが構成されます。
InstanceType、InstanceTypes.N、InstanceTypeOverride.N、および Cpu と Memory の 4 つのメソッドを同じ時間に指定することはできません。ただし、InstanceType または InstanceTypes.N を InstancePatternInfo.N と一緒に指定することはできます。InstancePatternInfo.N と一緒に指定した場合、Auto Scaling はスケールアウトに指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプが在庫切れの場合、InstancePatternInfo.N 設定に一致するインスタンスタイプが使用されます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:CreateScalingConfiguration |
create |
*すべてのリソース。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ScalingGroupId |
string |
必須 |
スケーリング設定が属するスケーリンググループの ID。 |
asg-bp14wlu85wrpchm0**** |
| ImageId |
string |
任意 |
イメージファイルの ID。イメージは ECS インスタンスの自動作成に使用されます。 説明
このパラメーターは ImageName パラメーターと同じ効果を持ちます。いずれか一方のみをセットできます。ImageName パラメーターをセットした場合、ImageId パラメーターは無視されます (オプション)。 |
centos6u5_64_20G_aliaegis****.vhd |
| ImageName |
string |
任意 |
イメージファイルの名前。イメージ名はリージョン内で一意です。このパラメーターを使用して Alibaba Cloud Marketplace のイメージを指定することはできません。 説明
このパラメーターは ImageId パラメーターと同じ効果を持ちます。いずれか一方のみをセットできます。ImageId パラメーターをセットした場合、ImageName パラメーターは無視されます (オプション)。 |
イメージ**** |
| InstanceType |
string |
任意 |
ECS インスタンスのインスタンスタイプ。詳細については、「Instance families」を参照してください。 説明
InstanceType、InstanceTypes、InstanceTypeOverrides、および Cpu と Memory の 4 つのメソッドを同じ時間に指定することはできません。ただし、API 呼び出し時に InstanceType を InstancePatternInfo と一緒に指定することはできます。この場合、Auto Scaling はスケールアウトに指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプが在庫切れの場合、InstancePatternInfo 設定に一致するインスタンスタイプが使用されます。 |
ecs.g6.large |
| Cpu |
integer |
任意 |
vCPU の数。単位: コア。 Cpu と Memory の両方を指定して、インスタンスタイプの有効値を定義できます。たとえば、Cpu を 2、Memory を 16 にセットすると、2 vCPU と 16 GiB のメモリを持つすべてのインスタンスタイプを定義できます。Auto Scaling は、I/O 最適化やゾーンなどの要因に基づいて利用可能なインスタンスタイプを決定し、価格が最も低いインスタンスを価格順に作成します。 説明
この設定は、コスト最適化モードが有効になっており、スケーリング設定でインスタンスタイプが指定されていない場合にのみ効果があります。 |
2 |
| Memory |
integer |
任意 |
メモリサイズ。単位: GiB。 Cpu と Memory の両方を指定して、インスタンスタイプの有効値を定義できます。たとえば、Cpu を 2、Memory を 16 にセットすると、2 vCPU と 16 GiB のメモリを持つすべてのインスタンスタイプを定義できます。Auto Scaling は、I/O 最適化やゾーンなどの要因に基づいて利用可能なインスタンスタイプを決定し、価格が最も低いインスタンスを価格順に作成します。 説明
この設定は、コスト最適化モードが有効になっており、スケーリング設定でインスタンスタイプが指定されていない場合にのみ効果があります。 |
16 |
| DeploymentSetId |
string |
任意 |
ECS インスタンスが属するデプロイメントセットの ID。 |
ds-bp1frxuzdg87zh4pz**** |
| SecurityGroupId |
string |
任意 |
ECS インスタンスが属するセキュリティグループの ID。同じセキュリティグループ内の ECS インスタンスは相互にアクセスできます。 |
sg-280ih**** |
| IoOptimized |
string |
任意 |
インスタンスが I/O 最適化インスタンスであるかどうかを指定します。有効な値:
retired instance types のインスタンスの場合、デフォルト値は none です。その他のインスタンスタイプのインスタンスの場合、デフォルト値は optimized です。 |
optimized |
| InternetChargeType |
string |
任意 |
ネットワーク使用量の課金方法。有効な値:
このパラメーターが指定されていない場合、クラシックネットワークのデフォルト値は PayByBandwidth、VPC のデフォルト値は PayByTraffic です。 |
PayByTraffic |
| InternetMaxBandwidthIn |
integer |
任意 |
最大インバウンドパブリック帯域幅。単位: Mbit/s。有効な値:
|
10 |
| InternetMaxBandwidthOut |
integer |
任意 |
最大アウトバウンドパブリック帯域幅。単位: Mbit/s。有効な値: 0~100。 デフォルト値: 0。 |
10 |
| SystemDisk.Category |
string |
任意 |
システムクラウドディスクのカテゴリ。有効な値:
このパラメーターは SystemDiskCategories.N と一緒に指定できません。このパラメーターも SystemDiskCategories.N も指定されていない場合、デフォルト値が使用されます。インスタンスタイプがシリーズ I のインスタンスタイプであり、インスタンスが I/O 最適化インスタンスではない場合、デフォルト値は cloud です。それ以外の場合、デフォルト値は cloud_efficiency です。 |
cloud_ssd |
| SystemDisk.Size |
integer |
任意 |
システムクラウドディスクのサイズ。単位: GiB。有効な値:
このパラメーターの値は max{1, ImageSize} 以上である必要があります。 デフォルト値: max{40, ImageSize}。 |
100 |
| SystemDisk.DiskName |
string |
任意 |
システムクラウドディスクの名前。名前は 2~128 文字で、英字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。名前は英字または漢字で始める必要があり、http:// または https:// で始めることはできません。 |
cloud_ssdSystem |
| SystemDisk.Description |
string |
任意 |
システムクラウドディスクの説明。説明は 2~256 文字で、http:// または https:// で始めることはできません。 |
テストシステムディスク |
| SystemDisk.AutoSnapshotPolicyId |
string |
任意 |
システムクラウドディスクに適用される自動スナップショットポリシーの ID。 |
sp-bp12m37ccmxvbmi5**** |
| SystemDisk.PerformanceLevel |
string |
任意 |
ディスクが標準 SSD の場合のシステムクラウドディスクのパフォーマンスレベル (PL) の設定項目。有効な値:
デフォルト値: PL1。 説明
ESSD のパフォーマンスレベルの選択方法の詳細については、「 ESSDs 」を参照してください。 |
PL1 |
| ScalingConfigurationName |
string |
任意 |
スケーリング設定の名前。名前は 2~64 文字で、英字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を含めることができます。名前は英字、数字、または漢字で始める必要があります。 名前は、同じリージョン内の同じスケーリンググループにあるスケーリング設定間で一意である必要があります。このパラメーターを指定しない場合、デフォルトでスケーリング設定 ID が使用されます。 |
スケーリングconfig**** |
| LoadBalancerWeight |
integer |
任意 |
関連付けられたロードバランサーインスタンスのバックエンドサーバーとしての ECS インスタンスの重み。有効な値: 1~100。 デフォルト値: 50。 |
50 |
| Tags |
string |
任意 |
ECS インスタンスのタグ。タグはキーと値のペアとして指定されます。最大 20 個のタグを指定できます。タグキーと値には以下の制限が適用されます。
|
{"キー1":"値1","キー2":"値2", ... "キー5":"値5"} |
| UserData |
string |
任意 |
ECS インスタンスのユーザーデータ。データは Base64 でエンコーディングされている必要があります。エンコーディング前の生データの最大値は 32 KB です。 |
ZWNobyBoZWxsbyBlY3Mh |
| KeyPairName |
string |
任意 |
ECS インスタンスへのログインに使用されるキーペアの名前。
|
KeyPairTest |
| RamRoleName |
string |
任意 |
ECS インスタンスに関連付けられた RAM ロールの名前。名前は RAM によって提供および管理されます。 ListRoles を呼び出して、利用可能な RAM ロールをクエリできます。RAM ロールの作成方法の詳細については、「 CreateRole 」を参照してください。 |
ramロール**** |
| SecurityEnhancementStrategy |
string |
任意 |
セキュリティ強化を有効にするかどうかを指定します。有効な値:
|
Active |
| InstanceName |
string |
任意 |
スケーリング設定を使用した自動作成によって作成される ECS インスタンスの名前。 |
インスタンス**** |
| HostName |
string |
任意 |
ECS インスタンスのホスト名。ピリオド (.) またはハイフン (-) を最初または最後の文字として使用したり、連続して使用したりすることはできません。命名規則はインスタンスタイプによって異なります。
|
ホスト**** |
| SpotStrategy |
string |
任意 |
従量課金インスタンスのプリエンプションポリシー。有効な値:
デフォルト値: NoSpot。 |
NoSpot |
| PasswordInherit |
boolean |
任意 |
イメージにプリセットされたパスワードを使用するかどうかを指定します。このパラメーターを使用するには、イメージにパスワードが設定されていることを確認してください。有効な値:
|
false |
| Password |
string |
任意 |
ECS インスタンスのパスワード。パスワードは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。以下の特殊文字がサポートされています。
Windows インスタンスの場合、パスワードをスラッシュ (/) で始めることはできません。 説明
Password パラメーターを指定する場合は、パスワードの漏洩を防ぐために HTTPS を使用してリクエストを送信してください。 |
123abc**** |
| ResourceGroupId |
string |
任意 |
ECS インスタンスが属するリソースグループの ID。 |
rg-リソース**** |
| HpcClusterId |
string |
任意 |
ECS インスタンスが属する HPC クラスターの ID。 |
hpc-クラスターid |
| InstanceDescription |
string |
任意 |
ECS インスタンスの説明。説明は 2~256 文字で、http:// または https:// で始めることはできません。 |
テストインスタンス |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認してください。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「How to ensure idempotence」を参照してください。 |
123e4567-e89b-12d3-a456-42665544**** |
| Ipv6AddressCount |
integer |
任意 |
ネットワークインターフェイスに割り当てられるランダムに生成された IPv6 アドレスの数。 |
1 |
| CreditSpecification |
string |
任意 |
バースト可能インスタンスの実行パターン。有効な値:
詳細については、「バースト可能インスタンスの概要」のパフォーマンススキーマセクションを参照してください。 |
標準 |
| ImageFamily |
string |
任意 |
イメージ ファミリーの名前。このパラメーターをセットして、指定されたイメージ ファミリーからインスタンス作成用の最新の利用可能なイメージを読み取り、インスタンスを作成できます。ImageId パラメーターがすでに指定されている場合、このパラメーターはセットできません。 |
hangzhou-daily-update |
| ZoneId |
string |
任意 |
ECS インスタンスのゾーン ID。 |
cn-hangzhou-g |
| DedicatedHostId |
string |
任意 |
ECS インスタンスを専用ホスト上に作成するかどうかを指定します。専用ホストはスポットインスタンスの作成をサポートしていないため、DedicatedHostId パラメーターを指定すると、リクエスト内の SpotStrategy および SpotPriceLimit のセットは自動的に無視されます。 DescribeDedicatedHosts を呼び出して、専用ホスト ID のリストをクエリできます。 |
dh-bp67acfmxazb4p**** |
| Affinity |
string |
任意 |
専用ホスト上のインスタンスが専用ホストに関連付けられているかどうかを指定します。有効な値:
デフォルト値: default。 |
デフォルト |
| Tenancy |
string |
任意 |
インスタンスを専用ホスト上に作成するかどうかを指定します。有効な値:
デフォルト値: default。 |
デフォルト |
| SchedulerOptions |
object |
任意 |
スケジューラオプション。 |
["testManagedPrivateSpaceId****"] |
| PrivatePoolOptions.MatchCriteria |
string |
任意 |
インスタンス起動用の非公開プールオプション。エラスティシティ保証またはキャパシティ予約が効果を持つと、起動時にインスタンスが使用するための非公開プールが生成されます。有効な値:
|
Open |
| PrivatePoolOptions.Id |
string |
任意 |
非公開プール ID。エラスティシティ保証またはキャパシティ予約の ID です。 |
eap-bp67acfmxazb4**** |
| SpotDuration |
integer |
任意 |
スポットインスタンスの保持期間。単位: 時間。有効な値:
説明
Alibaba Cloud は、インスタンスが取り消される 5 分前に ECS システムイベント通知を送信します。スポットインスタンスは秒単位で課金されます。API 呼び出し時に、予想されるタスク実行時間に基づいて、適切な保持期間を選択してください。 デフォルト値: 1。 |
1 |
| SpotInterruptionBehavior |
string |
任意 |
スポットインスタンスの中断パターン。Terminate (デフォルト) のみがサポートされており、インスタンスを直接リリースします。 |
Terminate |
| InstanceTypes |
array |
任意 |
インスタンスタイプ。 |
ecs.g6.large |
|
string |
任意 |
インスタンスタイプ。N の有効な値: 1~20。スケーリング設定で最大 20 個のインスタンスタイプを指定できます。 N の値はインスタンスタイプの優先度を示します。N の値が小さいほど優先度が高くなります。最も優先度の高いインスタンスタイプを使用してインスタンスを作成できない場合、Auto Scaling は自動的に次に優先度の高いインスタンスタイプを使用します。 説明
InstanceType、InstanceTypes、InstanceTypeOverrides、および Cpu と Memory の 4 つの方法を同時に指定することはできません。ただし、API 呼び出し時に InstanceTypes を InstancePatternInfo と一緒に指定することはできます。この場合、Auto Scaling はスケールアウトに指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプの在庫がない場合、InstancePatternInfo 設定に一致するインスタンスタイプが使用されます。 |
ecs.g6.large |
|
| InstanceTypeOverride |
array<object> |
任意 |
インスタンスタイプ情報。 |
|
|
object |
任意 |
インスタンスタイプ情報。 |
||
| InstanceType |
string |
任意 |
スケーリング設定内のインスタンスタイプの容量を指定するには、このパラメーターと InstanceTypeOverride.N.WeightedCapacity の両方を指定します。 このパラメーターはインスタンスタイプを指定します。このパラメーターには N 個の値を指定できます。InstanceTypeOverride.N.WeightedCapacity パラメーターと組み合わせることで、カスタム重みを持つマルチインスタンスタイプサポートの拡張を提供します。N の有効な値: 1~20。 説明
このパラメーターは、InstanceTypes.N または InstanceType と一緒に指定できません。 InstanceType の有効な値: 購入可能な ECS インスタンスタイプ。詳細については、「インスタンスファミリー」を参照してください。 |
ecs.c5.xlarge |
| WeightedCapacity |
integer |
任意 |
スケーリング設定内のインスタンスタイプの容量を指定するには、まず InstanceTypeOverride.N.InstanceType を指定し、次にこのパラメーターを指定します。2 つのパラメーターは 1 対 1 で対応していることが必須であり、N の値は一致している必要があります。 このパラメーターはインスタンスタイプの重みを指定します。これは、スケーリンググループ内のこのタイプの単一インスタンスの容量を表します。重みが大きいほど、予想される容量を満たすために必要なこのタイプのインスタンス数が少なくなります。 インスタンスタイプは vCPU 数、メモリサイズ、その他のパフォーマンスメトリクスが異なる場合があるため、要件に基づいて異なるインスタンスタイプに異なる重みを設定できます。 例:
予想される容量を満たすために、スケーリンググループは 2 個の ecs.c5.xlarge インスタンスをスケールアウトします。 説明
スケールアウト中、スケーリンググループの容量は、最大容量 (MaxSize) とインスタンスタイプの最大重みの合計を超えることはできません。 WeightedCapacity の有効な値: 1~500。 |
4 |
| DataDisk |
array<object> |
任意 |
データクラウドディスク情報。 |
|
|
object |
任意 |
データクラウドディスク情報。 |
||
| PerformanceLevel |
string |
任意 |
ディスクが標準 SSD の場合のデータクラウドディスクのパフォーマンスレベル (PL) の設定項目。N の値は DataDisk.N.Category=cloud_essd の N と一致している必要があります。有効な値:
デフォルト値: PL1。 説明
ESSD のパフォーマンスレベルの選択方法の詳細については、「 ESSD 」を参照してください。 |
PL1 |
| AutoSnapshotPolicyId |
string |
任意 |
データクラウドディスク N に適用される自動スナップショットポリシーの ID。N の有効な値: 1~16。 |
sp-bp19nq9enxqkomib**** |
| Encrypted |
string |
任意 |
データクラウドディスク N を暗号化するかどうかを指定します。N の有効な値: 1~16。有効な値:
デフォルト値: false。 |
false |
| Description |
string |
任意 |
データクラウドディスク N の説明。N の有効な値: 1~16。説明は 2~256 文字で、 |
テストデータディスク |
| SnapshotId |
string |
任意 |
データクラウドディスク N の作成に使用されるスナップショットの ID。N の有効な値: 1~16。このパラメーターが指定されると、DataDisk.N.Size は無視され、作成されるディスクのサイズは指定されたスナップショットのサイズになります。 スナップショットが 2013 年 7 月 15 日以前に作成された場合、呼び出しは拒否され、エラーメッセージ InvalidSnapshot.TooOld が返されます。 |
s-280s7**** |
| Categories |
array |
任意 |
データクラウドディスク N のディスクタイプ。最初の N は N 番目のデータクラウドディスクを示します。有効な値: 1~16。2 番目の N はデータクラウドディスクの N 番目のディスクタイプを示します。有効な値: 1~4。API 呼び出し時に、スケーリング設定内のデータクラウドディスクに対して最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は自動的に次のディスクタイプを試してデータクラウドディスクを作成します。有効な値:
説明
このパラメーターは |
cloud |
|
string |
任意 |
データクラウドディスク N のディスクタイプ。最初の N は N 番目のデータクラウドディスクを示します。有効な値: 1~16。2 番目の N はデータクラウドディスクの N 番目のディスクタイプを示します。有効な値: 1~4。API 呼び出し時に、スケーリング設定内のデータクラウドディスクに対して最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプが利用できない場合、Auto Scaling は自動的に次のディスクタイプを試してデータクラウドディスクを作成します。有効な値:
説明
このパラメーターは |
cloud |
|
| Size |
integer |
任意 |
データクラウドディスク N のサイズ。N の有効な値: 1~16。単位: GiB。有効な値:
このパラメーターが指定された後、ディスクサイズはスナップショットのサイズ (スナップショットは SnapshotId で指定) 以上である必要があります。 |
100 |
| Device |
string |
任意 |
データクラウドディスク N のマウントポイント。N の有効な値: 1~16。このパラメーターを指定しない場合、ECS インスタンスの自動作成時のデフォルトの動作では、システムがマウントポイントを割り当てます。マウントポイントの有効値は /dev/xvdb から /dev/xvdz です。 |
/dev/xvdb |
| DiskName |
string |
任意 |
データクラウドディスク N の名前。N の有効な値: 1~16。名前は 2~128 文字で、英字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。名前は英字または漢字で始める必要があり、 |
cloud_ssdData |
| Category |
string |
任意 |
データクラウドディスク N のカテゴリ。N の有効な値: 1~16。有効な値:
このパラメーターは
|
cloud_ssd |
| DeleteWithInstance |
boolean |
任意 |
インスタンスがリリースされるときにデータクラウドディスク N をリリースするかどうかを指定します。N の有効な値: 1~16。有効な値:
このパラメーターは、独立したクラウドディスク (DataDisk.N.Category が cloud、cloud_efficiency、cloud_ssd、cloud_essd、または cloud_auto に設定されている) に対してのみ設定できます。それ以外の場合はエラーが返されます。 デフォルト値: true。 |
true |
| KMSKeyId |
string |
任意 |
データクラウドディスク N の KMS キーの ID。N の有効な値: 1~16。 |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| ProvisionedIops |
integer |
任意 |
データクラウドディスクのプロビジョニングされた IOPS (Input/Output Operations Per Second) パフォーマンスメトリクス。 説明
IOPS (Input/Output Operations Per Second) は、ブロックストレージデバイスが 1 秒間にプロセスできる読み取りおよび書き込み (出力/入力) 操作の数を測定します。単位: 操作/秒。 |
100 |
| BurstingEnabled |
boolean |
任意 |
データクラウドディスクのバースト機能を有効にするかどうかを指定します。有効な値:
説明
このパラメーターは、 詳細については、「ESSD AutoPL クラウドディスク」を参照してください。 |
false |
| SpotPriceLimit |
array<object> |
任意 |
スポットインスタンス情報。 |
|
|
object |
任意 |
スポットインスタンス情報。 |
||
| PriceLimit |
number |
任意 |
スポットインスタンスの入札価格。N の有効な値: 1~20。このパラメーターは、SpotStrategy が SpotWithPriceLimit にセットされている場合にのみ効果があります。 |
0.5 |
| InstanceType |
string |
任意 |
スポットインスタンスのインスタンスタイプ。N の有効な値: 1~20。このパラメーターは、SpotStrategy が SpotWithPriceLimit にセットされている場合にのみ効果があります。 |
ecs.g6.large |
| SecurityGroupIds |
array |
任意 |
ECS インスタンスが追加されるセキュリティグループの ID。N の有効な値は、インスタンスが属することができるセキュリティグループの最大値によって異なります。詳細については、「使用制限」のセキュリティグループセクションを参照してください。 説明
SecurityGroupId と SecurityGroupIds.N の両方を指定することはできません。 |
sg-bp18kz60mefs**** |
|
string |
任意 |
ECS インスタンスが追加されるセキュリティグループの ID。N の有効な値は、インスタンスが属することができるセキュリティグループの最大値によって異なります。詳細については、「使用制限」のセキュリティグループセクションを参照してください。 説明
SecurityGroupId と SecurityGroupIds.N の両方を指定することはできません。 |
sg-bp18kz60mefs**** |
|
| InstancePatternInfo |
array<object> |
任意 |
インテリジェントモードでのインスタンスタイプ関連情報。 |
|
|
object |
任意 |
インテリジェントモードでのインスタンスタイプ関連情報。 |
||
| Cores |
integer |
任意 |
インテリジェント構成モードでのインスタンスタイプの vCPU コア数。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。詳細については、「Instance families」を参照してください。N の有効値: 1~10。 次の項目に注意してください。
|
2 |
| InstanceFamilyLevel |
string |
任意 |
インテリジェント構成モードでのインスタンスファミリーレベル。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。有効な値:
N の有効値: 1~10。 |
EnterpriseLevel |
| MaxPrice |
number |
任意 |
インテリジェント構成モードでの従量課金インスタンスまたはスポットインスタンスの 1 時間あたりの最大価格。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。N の有効値: 1~10。 説明
SpotStrategy が SpotWithPriceLimit にセットされている場合、このパラメーターは必須です。それ以外の場合、このパラメーターはオプションです。 |
2 |
| Memory |
number |
任意 |
インテリジェント構成モードでのインスタンスタイプのメモリサイズ。単位: GiB。このパラメーターは、要件を満たすインスタンスタイプをフィルター処理するために使用されます。詳細については、「Instance families」を参照してください。N の有効値: 1~10。 |
4 |
| ExcludedInstanceType |
array |
任意 |
除外するインスタンスタイプ。ワイルドカード文字 (*) を使用して、単一のインスタンスタイプまたはインスタンスファミリー全体を除外できます。例:
|
|
|
string |
任意 |
除外するインスタンスタイプ。ワイルドカード文字 (*) を使用して、単一のインスタンスタイプまたはインスタンスファミリー全体を除外できます。例:
|
ecs.n1.small/ecs.n1.*/*7* |
|
| Architecture |
array |
任意 |
インスタンスタイプのアーキテクチャタイプ。有効な値:
デフォルト値: すべてのアーキテクチャタイプが含まれます。 |
|
|
string |
任意 |
インスタンスタイプのアーキテクチャタイプ。有効な値:
デフォルト値: すべてのアーキテクチャタイプが含まれます。 |
X86 |
|
| BurstablePerformance |
string |
任意 |
バースト可能インスタンスタイプを含めるかどうかを指定します。有効な値:
デフォルト値: Include。 |
Include |
| InstanceTypeFamilies |
array |
任意 |
照会するインスタンスファミリー。N は複数のインスタンスファミリーを指定できることを示します。N の有効値: 1~10。 |
|
|
string |
任意 |
指定されたインスタンスファミリー。N は複数のインスタンスファミリーを指定できることを示します。N の有効値: 1~10。 |
ecs.g6 |
|
| MinimumCpuCoreCount |
integer |
任意 |
インスタンスタイプの vCPU コアの最小数。 |
2 |
| MaximumCpuCoreCount |
integer |
任意 |
インスタンスタイプの vCPU コアの最大数。 説明
MaximumCpuCoreCount の値は、MinimumCpuCoreCount の値の 4 倍を超えることはできません。 |
4 |
| GpuSpecs |
array |
任意 |
GPU タイプ。 |
|
|
string |
任意 |
GPU タイプ。 |
NVIDIA V100 |
|
| InstanceCategories |
array |
任意 |
インスタンスのカテゴリ。有効な値: 説明
N は複数のインスタンスカテゴリを指定できることを示します。N の有効値: 1~10。
|
|
|
string |
任意 |
インスタンスのカテゴリ。有効な値: 説明
N は複数のインスタンスカテゴリを指定できることを示します。N の有効値: 1~10。
|
Compute-optimized with GPU |
|
| CpuArchitectures |
array |
任意 |
インスタンスの CPU アーキテクチャ。有効な値: 説明
N は複数の CPU アーキテクチャを指定できることを示します。N の有効値: 1~2。
|
|
|
string |
任意 |
インスタンスの CPU アーキテクチャ。有効な値: 説明
N は複数の CPU アーキテクチャを指定できることを示します。N の有効値: 1~2。
|
X86 |
|
| PhysicalProcessorModels |
array |
任意 |
インスタンスのプロセッサモデル。N は複数のプロセッサモデルを指定できることを示します。N の有効値: 1~10。 |
|
|
string |
任意 |
インスタンスのプロセッサモデル。N は複数のプロセッサモデルを指定できることを示します。N の有効値: 1~10。 |
Intel Xeon(Ice Lake) Platinum 8369B、Intel Xeon(Skylake) Platinum 8163、...、Intel Xeon(Cascade Lake) Platinum 8269CY |
|
| MinimumEniQuantity |
integer |
任意 |
インスタンスがサポートするネットワークインターフェイス (ENI) の最小数。 |
2 |
| MinimumEniPrivateIpAddressQuantity |
integer |
任意 |
インスタンスのネットワークインターフェイス (ENI) あたりの IPv4 アドレスの最小数。 |
2 |
| MinimumEniIpv6AddressQuantity |
integer |
任意 |
インスタンスのネットワークインターフェイス (ENI) あたりの IPv6 アドレスの最小数。 |
1 |
| MinimumInitialCredit |
integer |
任意 |
バースト可能インスタンス (t5 および t6) の初期 vCPU クレジットの最小数。 |
12 |
| MinimumBaselineCredit |
integer |
任意 |
バースト可能インスタンス (t5 および t6) のベースライン vCPU コンピューティングパフォーマンス (すべての vCPU の合計) の最小値。 |
12 |
| MinimumMemorySize |
number |
任意 |
インスタンスのメモリサイズの最小値。単位: GiB。 |
4 |
| MaximumMemorySize |
number |
任意 |
インスタンスのメモリサイズの最大値。単位: GiB。 |
4 |
| MinimumGpuAmount |
integer |
任意 |
インスタンスの GPU の最小数。有効な値: 正の整数。 |
2 |
| MaximumGpuAmount |
integer |
任意 |
インスタンスの GPU の最大数。有効な値: 正の整数。 |
2 |
| SystemDiskCategories |
array |
任意 |
システムクラウドディスクのディスクタイプ。N の有効値: 1~4。スケーリング設定でシステムクラウドディスクに最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプを使用できない場合、Auto Scaling は次の優先度のディスクタイプを自動的に試してシステムクラウドディスクを作成します。有効な値:
説明
このパラメーターと SystemDisk.Category を同時に指定することはできません。 |
cloud |
|
string |
任意 |
システムクラウドディスクのディスクタイプ。N の有効値: 1~4。スケーリング設定でシステムクラウドディスクに最大 4 つのディスクタイプを指定できます。N の値が小さいほど優先度が高くなります。優先度の高いディスクタイプを使用できない場合、Auto Scaling は次の優先度のディスクタイプを自動的に試してシステムクラウドディスクを作成します。有効な値:
説明
このパラメーターと SystemDisk.Category を同時に指定することはできません。 |
cloud |
|
| SystemDisk.Encrypted |
boolean |
任意 |
システムクラウドディスクを暗号化するかどうかを指定します。有効な値:
デフォルト値: false。 |
false |
| SystemDisk.KMSKeyId |
string |
任意 |
システムクラウドディスクに使用される Key Management サービス (KMS) キーの ID。 |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| SystemDisk.EncryptAlgorithm |
string |
任意 |
システムクラウドディスクに使用される暗号化アルゴリズム。有効な値:
デフォルト値: AES-256。 |
AES-256 |
| SystemDisk.ProvisionedIops |
integer |
任意 |
システムクラウドディスクのプロビジョニングされた IOPS (Input/Output Operations Per Second) のパフォーマンスメトリクス。 説明
IOPS (Input/Output Operations Per Second) は、ブロックストレージデバイスが 1 秒間に処理できる読み取りおよび書き込み (出力/入力) 操作の数を測定します。単位: 操作/秒。 |
100 |
| SystemDisk.BurstingEnabled |
boolean |
任意 |
システムクラウドディスクのバースト機能を有効にするかどうかを指定します。有効な値:
説明
このパラメーターは、SystemDisk.Category が cloud_auto にセットされている場合にのみサポートされます。 詳細については、「ESSD AutoPL cloud disks」を参照してください。 |
false |
| ImageOptions.LoginAsNonRoot |
boolean |
任意 |
ECS インスタンスがログインに ecs-user ユーザーを使用するかどうかを指定します。詳細については、「Manage the logon name of an ECS instance」を参照してください。有効な値:
デフォルト値: false。 |
false |
| DeletionProtection |
boolean |
任意 |
ECS インスタンスのリリース保護プロパティ。このプロパティは従量課金インスタンスにのみ適用され、ECS コンソールから、または DeleteInstance 操作を呼び出してインスタンスを直接リリースできるかどうかを指定します。有効な値:
デフォルト値: false。 説明
このプロパティは、Auto Scaling の通常のスケールインアクティビティには影響しません。リリース保護が有効になっている従量課金インスタンスも、スケールインアクティビティ中にリリースされる可能性があります。 |
false |
| StorageSetId |
string |
任意 |
ストレージセットの ID。 |
ss-bp67acfmxazb4p**** |
| StorageSetPartitionNumber |
integer |
任意 |
ストレージセットのパーティションの最大数。有効な値: 2 以上の整数。 |
2 |
| CustomPriorities |
array<object> |
任意 |
ECS インスタンスタイプ + vSwitch 組み合わせのカスタム優先度。 説明
このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。 優先度の高い ECS インスタンスタイプ + vSwitch の組み合わせに基づいて ECS インスタンスを作成できない場合、Auto Scaling は次の優先度の ECS インスタンスタイプ + vSwitch の組み合わせを自動的に選択して ECS インスタンスを作成します。 説明
一部の ECS インスタンスタイプ + vSwitch 組み合わせに対してのみカスタム優先度を指定した場合、指定されていない組み合わせの優先度は指定されたものよりも低くなります。指定されていない組み合わせは、スケーリンググループの vSwitch の順序とスケーリング設定のインスタンスタイプの順序に基づいて引き続き優先順位が付けられます。たとえば、スケーリンググループの vSwitch の順序が vsw1 と vsw2、スケーリング設定のインスタンスタイプの順序が type1 と type2、カスタム優先度の順序が ["vsw2+type2", "vsw1+type2"] である場合、最終的な優先度は vsw2+type2 > vsw1+type2 > vsw1+type1 > vsw2+type1 となります。 |
|
|
object |
任意 |
ECS インスタンスタイプ + vSwitch 組み合わせのカスタム優先度。 重要 このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。 |
||
| InstanceType |
string |
任意 |
CustomPriorities フィールドは、ECS インスタンスタイプ + vSwitch 組み合わせのカスタム優先度を指定します。CustomPriorities.N.InstanceType パラメーターは、カスタム優先度における ECS インスタンスのインスタンスタイプを指定します。 説明
このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。インスタンスタイプ (InstanceType) は、スケーリング設定のインスタンスタイプリストに含まれている必要があります。 優先度の高い ECS インスタンスタイプ + vSwitch の組み合わせに基づいて ECS インスタンスを作成できない場合、Auto Scaling は次の優先度の ECS インスタンスタイプ + vSwitch の組み合わせを自動的に選択して ECS インスタンスを作成します。 説明
一部の ECS インスタンスタイプ + vSwitch 組み合わせに対してのみカスタム優先度を指定した場合、指定されていない組み合わせの優先度は指定されたものよりも低くなります。指定されていない組み合わせは、スケーリンググループの vSwitch の順序とスケーリング設定のインスタンスタイプの順序に基づいて引き続き優先順位が付けられます。たとえば、スケーリンググループの vSwitch の順序が vsw1 と vsw2、スケーリング設定のインスタンスタイプの順序が type1 と type2、カスタム優先度の順序が ["vsw2+type2", "vsw1+type2"] である場合、最終的な優先度は vsw2+type2 > vsw1+type2 > vsw1+type1 > vsw2+type1 となります。 |
ecs.g6.large |
| VswitchId |
string |
任意 |
CustomPriorities.N.VswitchId パラメーターは、カスタム優先度における vSwitch の ID を指定します。 説明
このパラメーターは、スケーリンググループのスケーリングポリシーが Priority にセットされている場合にのみ効果があります。vSwitch は、スケーリンググループの vSwitch リストに含まれている必要があります。 |
vsw-bp14zolna43z266bq**** |
| NetworkInterfaces |
array<object> |
任意 |
ネットワークインターフェイス (ENI) のリスト。 |
|
|
object |
任意 |
ネットワークインターフェイス (ENI) のリスト。 |
||
| InstanceType |
string |
任意 |
ネットワークインターフェイス (ENI) のタイプ。NetworkInterfaces.N を使用する場合、プライマリネットワークインターフェイス (ENI) を設定する必要がありますが、SecurityGroupId または SecurityGroupIds.N パラメーターを同時に設定することはできません。有効な値:
デフォルト値: Secondary。 |
Primary |
| NetworkInterfaceTrafficMode |
string |
任意 |
ネットワークインターフェイスコントローラー (NIC) の通信パターン。有効な値:
デフォルト値: 標準。 説明
RDMA モードのネットワークインターフェイス (ENI) の数は、インスタンスファミリーの制限を超えることはできません。詳細については、「Instance families」を参照してください。 |
HighPerformance |
| Ipv6AddressCount |
integer |
任意 |
プライマリ ENI 用にランダムに生成される IPv6 アドレスの数。次の項目に注意してください。
|
1 |
| SecurityGroupIds |
array |
任意 |
ネットワークインターフェイス (ENI) が属する 1 つ以上のセキュリティグループの ID。 |
|
|
string |
任意 |
ネットワークインターフェイス (ENI) が属する 1 つ以上のセキュリティグループの ID。次の項目に注意してください。
|
sg-uf6ij8dwxh**** |
|
| SecondaryPrivateIpAddressCount |
integer |
任意 |
ENI に割り当てるセカンダリ非公開 IPv4 アドレスの数。有効な値: 1~49。
|
2 |
| VSwitchIds |
array |
任意 |
ネットワークインターフェイス (ENI) が属する vSwitch の ID。N は複数の vSwitch を設定できることを示します。N の有効値: 1~10。 次の項目に注意してください。
|
|
|
string |
任意 |
ネットワークインターフェイス (ENI) が属する vSwitch の ID。N は複数の vSwitch を設定できることを示します。N の有効値: 1~10。 次の項目に注意してください。
|
vsw-bp67acfmxazb4p**** |
|
| DedicatedHostClusterId |
string |
任意 |
専用ホストクラスターの ID。 |
dc-2zedxc67zqzt7lb4**** |
| SecurityOptions |
object |
任意 |
セキュリティオプション。 |
|
| ConfidentialComputingMode |
string |
任意 |
機密コンピューティングモード。有効な値:
|
TDX |
| HttpEndpoint |
string |
任意 |
インスタンスメタデータへのアクセスチャンネルを有効にするかどうかを指定します。有効な値:
デフォルト値: enabled。 説明
インスタンスメタデータの詳細については、「インスタンスメタデータの概要」を参照してください。 |
有効 |
| HttpTokens |
string |
任意 |
インスタンスメタデータへのアクセスにセキュリティ拡張モード (IMDSv2) を強制的に使用するかどうかを指定します。有効な値:
デフォルト値: optional。 説明
インスタンスメタデータアクセスモードの詳細については、「インスタンスメタデータアクセスモード」を参照してください。 |
オプション |
| ResourcePoolOptions |
object |
任意 |
インスタンス作成時に使用されるリソースプールポリシー。このパラメーターを設定した後、次の項目に注意してください。
|
|
| Strategy |
string |
任意 |
リソースプールには、Elasticity Assurance または Capacity Reservation の効果後に生成される非公開プールと、パブリックプールが含まれます。これらのプールはインスタンスの起動に使用できます。有効な値:
デフォルト値: 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。 注意:
|
|
|
object |
任意 |
利用可能な Target 非公開プールをタグでフィルターします。N の有効値: 1~20。 注意:
|
||
| Key |
string |
任意 |
非公開プールのタグキー。 利用可能な Target 非公開プールをタグでフィルターします。N の有効値: 1~20。注意: このパラメーターが設定されている場合、システムはアカウントに関連付けられ、指定されたタグに一致し、スケーリンググループの制約 (ゾーンやインスタンスタイプなど) を満たす Target 非公開プールのみをフィルターします。 タグマッチングルールのルール: 非公開プールは指定されたすべてのタグに一致する必要があります。 このパラメーターは、PrivatePoolIds パラメーターと一緒に指定することはできません。 |
TestKey |
| Value |
string |
任意 |
非公開プールのタグ値。 |
TestValue |
| SecondaryEniVSwitchConstraint |
string |
任意 |
セカンダリネットワークインターフェイス (ENI) に対して VSwitchIds パラメーターが設定されている場合、セカンダリネットワークインターフェイス (ENI) 用に VSwitchIds リストから vSwitch を選択する必要があるかどうかを指定します。
デフォルト値: Strict。 |
Strict |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| ScalingConfigurationId |
string |
スケーリング設定の ID。 |
asc-bp1ffogfdauy0nu5**** |
| RequestId |
string |
リクエスト ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
例
成功レスポンス
JSONJSON
{
"ScalingConfigurationId": "asc-bp1ffogfdauy0nu5****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。