スケーリング設定を作成します。 CreateScalingConfiguration 操作を呼び出すと、スケーリンググループ ID、インスタンスタイプ、およびイメージを指定して、Elastic Compute Service (ECS) タイプのスケーリング設定を作成できます。
使用上の注意
Auto Scaling は、スケーリング設定に基づいて ECS インスタンスを自動的にスケールアウトします。 ECS インスタンスは、次のモードで設定できます。
InstancePatternInfo.N: インテリジェント設定モード。 このモードでは、vCPU の数、メモリサイズ、インスタンスファミリー、および最大価格のみを指定する必要があります。 Auto Scaling は、設定に基づいて最も価格の低いインスタンスタイプを選択して、ECS インスタンスを作成します。 このモードは、仮想プライベートクラウド (VPC) に存在するスケーリンググループでのみ使用できます。 このモードは、インスタンスタイプの在庫不足によるスケールアウトの失敗のリスクも軽減します。
InstanceType: このモードでは、インスタンスタイプを指定する必要があります。
InstanceTypes.N: このモードでは、複数のインスタンスタイプを指定する必要があります。
InstanceTypeOverride.N: このモードでは、複数のインスタンスタイプを指定し、インスタンスタイプの重みを指定する必要があります。
Cpu and Memory: このモードでは、vCPU の数とメモリサイズを指定する必要があります。 Auto Scaling は、I/O 最適化要件やゾーンなどの要因に基づいて、使用可能なインスタンスタイプのセットを決定します。 次に、Auto Scaling は、最も価格の低いインスタンスタイプの ECS インスタンスを優先的に作成します。 このモードは、スケーリングポリシーをコスト最適化ポリシーに設定し、スケーリング設定でインスタンスタイプを指定しない場合にのみ使用できます。
CreateScalingConfiguration 操作を呼び出してスケーリング設定を作成する場合、各呼び出しでプライマリ Elastic Network Interface (ENI) を設定するには、次のいずれかの方法のみを使用できます。 1 回の呼び出しで両方の方法を使用すると、呼び出しは失敗し、エラーメッセージが返されます。
SecurityGroupId、SecurityGroupIds.N、およびIpv6AddressCountを指定して、プライマリ ENI 関連の情報を設定します。NetworkInterfaces.Nを指定して、プライマリ ENI とセカンダリ ENI を設定します。 この場合、少なくとも 1 つのプライマリ ENI を指定します。NetworkInterfaces.N.InstanceTypeをPrimaryに設定すると、プライマリ ENI が設定されます。NetworkInterfaces.N.InstanceTypeをSecondaryに設定するか、パラメーターを空のままにすると、セカンダリ ENI が設定されます。
InstanceType、InstanceTypes.N、InstanceTypeOverride.N、および Cpu and Memory を同時に指定することはできません。 InstanceType と InstancePatternInfo.N、または InstanceTypes.N と InstancePatternInfo.N を同時に指定できます。 InstanceType と InstancePatternInfo.N、または InstanceTypes.N と InstancePatternInfo.N を同時に指定した場合、Auto Scaling はスケールアウトイベント中に InstanceType または InstanceTypes.N で指定されたインスタンスタイプを優先的に使用します。 InstanceType または InstanceTypes.N で指定されたインスタンスタイプの在庫が不足している場合、Auto Scaling はスケールアウトイベント中に InstancePatternInfo.N で指定されたインスタンスタイプを使用します。
デバッグ
リクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
アクション | 文字列 | はい | CreateScalingConfiguration | 実行する操作。 値を CreateScalingConfiguration に設定します。 |
ScalingGroupId | String | はい | asg-bp14wlu85wrpchm0**** | スケーリング構成を作成する対象のスケーリンググループの ID です。 |
ImageId | String | いいえ | centos6u5_64_20G_aliaegis****.vhd | Auto Scaling が ECS インスタンスの作成に使用するイメージの ID です。 説明 このパラメーターは、 |
イメージ名 | 文字列 | いいえ | image**** | イメージの名前。名前はリージョン内で一意である必要があります。このパラメーターを使用して Alibaba Cloud Marketplace のイメージを指定することはできません。 説明 このパラメーターは、 |
InstanceType | String | いいえ | ecs.g6.large | ECS インスタンス タイプ。詳細については、「インスタンスファミリの概要」をご参照ください。 説明 InstanceType、InstanceTypes、InstanceTypeOverrides、および Cpu と Memory を同時に指定することはできません。 InstanceType と InstancePatternInfo を同時に指定できます。 InstanceType と InstancePatternInfo を同時に指定した場合、Auto Scaling はスケールアウト イベント時に InstanceType で指定されたインスタンス タイプを優先的に使用します。 指定されたインスタンス タイプの在庫が不足している場合、Auto Scaling はスケールアウト イベント時に InstancePatternInfo で指定されたインスタンス タイプを使用します。 |
CPU | 整数 | いいえ | 2 | vCPU の数。 vCPU の数とメモリサイズを指定して、インスタンスタイプの範囲を決定できます。たとえば、CPU を 2、メモリを 16 に設定して、2 vCPU と 16 GiB のメモリを搭載したインスタンスタイプを指定できます。 CPU とメモリを指定すると、Auto Scaling は、I/O 最適化要件やゾーンなどの要因に基づいて、使用可能なインスタンスタイプを決定します。その後、Auto Scaling は、価格が最も低いインスタンスタイプを使用してインスタンスを優先的に作成します。 説明 スケーリングポリシーをコスト最適化ポリシーに設定し、スケーリング構成でインスタンスタイプを指定しない場合にのみ、CPU とメモリを指定してインスタンスタイプの範囲を定義できます。 |
メモリ | 整数 | いいえ | 16 | メモリサイズ。単位:GiB。 vCPU の数とメモリサイズを指定して、インスタンスタイプの範囲を定義できます。たとえば、Cpu を 2 に、メモリを 16 に設定して、2 vCPU と 16 GiB のメモリを持つインスタンスタイプを指定できます。 Cpu とメモリを指定すると、Auto Scaling は、I/O 最適化要件やゾーンなどの要因に基づいて、使用可能なインスタンスタイプを決定します。次に、Auto Scaling は、最低価格で提供されるインスタンスタイプのインスタンスを優先的に作成します。 説明 スケーリングポリシーをコスト最適化ポリシーに設定し、スケーリング構成でインスタンスタイプを指定しない場合にのみ、Cpu とメモリを指定してインスタンスタイプの範囲を定義できます。 |
DeploymentSetId | String | いいえ | ds-bp1frxuzdg87zh4pz**** | スケーリング構成から作成する ECS インスタンスが属するデプロイメントセットの ID です。 |
SecurityGroupId | String | いいえ | sg-280ih**** | スケーリング構成から作成する ECS インスタンスが属するセキュリティグループの ID です。同じセキュリティグループに属する ECS インスタンスは相互に通信できます。 |
IoOptimized | String | いいえ | optimized | I/O 最適化インスタンスを作成するかどうかを指定します。有効な値:
廃止されたインスタンスタイプの場合、このパラメーターのデフォルト値は none です。その他のインスタンスタイプの場合、このパラメーターのデフォルト値は optimized です。 |
InternetChargeType | String | いいえ | PayByTraffic | ネットワーク使用量の課金方式。有効な値:
クラシックネットワークの場合、このパラメーターのデフォルト値は PayByBandwidth です。 VPC の場合、このパラメーターのデフォルト値は PayByTraffic です。 |
InternetMaxBandwidthIn | 整数 | いいえ | 10 | 最大上りパブリック帯域幅。単位:Mbit/s。有効な値:
|
InternetMaxBandwidthOut | 整数 | いいえ | 10 | 最大送信パブリック帯域幅。単位:Mbit/s。有効な値:0~100。 デフォルト値:0。 |
SystemDisk.Category | String | いいえ | cloud_ssd | システムディスクのカテゴリ。有効な値:
SystemDisk.Category を指定する場合、 |
SystemDisk.Size | 整数 | いいえ | 100 | システムディスクのサイズ。単位:GiB。有効な値:
このパラメーターの値は、1 以上で、イメージサイズ以上である必要があります。 デフォルト値:40 またはイメージサイズのいずれか大きい方。 |
SystemDisk.DiskName | String | いいえ | cloud_ssdSystem | システムディスクの名前です。名前は 2 ~ 128 文字で、英字、数字、コロン(:)、アンダースコア(_)、およびハイフン(-)を含めることができます。英字で始める必要がありますが、 |
システムディスクの説明 | 文字列 | いいえ | システムディスクをテストします。 | システムディスクの説明。説明は 2 ~ 256 文字でなければなりません。文字を含めることはできますが、 |
システムディスクの自動スナップショットポリシー ID | 文字列 | いいえ | sp-bp12m37ccmxvbmi5**** | システムディスクに適用する自動スナップショットポリシーの ID です。 |
SystemDisk.PerformanceLevel | 文字列 | いいえ | PL1 | ESSD システムディスクの PL。有効な値:
デフォルト値: PL1。 説明 ESSD PL の選択方法の詳細については、「ESSD」をご参照ください。 |
スケーリング構成名 | 文字列 | いいえ | scalingconfig**** | スケーリング構成の名前。名前は 2 ~ 64 文字で、英字、数字、アンダースコア (_)、ハイフン (-)、およびピリオド (.) を使用できます。名前は英字または数字で始める必要があります。 スケーリング構成の名前は、リージョン内のスケーリンググループ内で一意である必要があります。このパラメーターを空のままにすると、スケーリング構成の ID が使用されます。 |
LoadBalancerWeight | 整数 | いいえ | 50 | 各 ECS インスタンスの負荷分散の重み。有効な値:1 ~ 100。 デフォルト値:50。 |
タグ | 文字列 | いいえ | {"key1":"value1","key2":"value2", ... "key5":"value5"} | ECS インスタンスのタグ。キーと値のペアとしてタグを指定します。各 ECS インスタンスに最大 20 個のタグを指定できます。タグキーとタグ値を指定する場合は、次の点に注意してください。
|
ユーザーデータ | 文字列 | いいえ | ZWNobyBoZWxsbyBlY3Mh | ECS インスタンスのユーザーデータ。Base64 形式でユーザーデータをエンコードする必要があります。Base64 エンコード前の生データは 32 KB を超えることはできません。 |
KeyPairName | String | いいえ | KeyPairTest | ECS インスタンスにログインするために使用するキーペアの名前シリーズです。
|
RamRoleName | String | いいえ | ramrole**** | |
セキュリティ強化戦略 | 文字列 | いいえ | アクティブ | セキュリティ強化機能を有効にするかどうかを指定します。有効な値:
|
InstanceName | String | いいえ | instance**** | スケーリング構成から Auto Scaling によって作成された ECS インスタンスの名前シリーズ。 |
ホスト名 | 文字列 | いいえ | host**** | スケーリング構成から Auto Scaling によって作成された ECS インスタンスのホスト名シリーズ。ホスト名は、ピリオド (.) またはハイフン (-) で開始または終了することはできません。ホスト名には、連続したピリオド (.) またはハイフン (-) を含めることはできません。命名規則:
|
SpotStrategy | String | いいえ | NoSpot | 従量課金インスタンスまたはスポットインスタンスに適用するプリエンプションポリシー。有効な値:
デフォルト値: NoSpot。 |
PasswordInherit | ブール値 | いいえ | false | イメージに事前設定されているパスワードを使用するかどうかを指定します。 このパラメーターを使用するには、指定したイメージにパスワードが設定されていることを確認してください。 有効な値:
|
パスワード | 文字列 | いいえ | 123abc**** | ECS インスタンスのパスワードシリーズ。パスワードは 8 ~ 30 文字で、大文字、小文字、数字、および次の特殊文字のうち少なくとも 3 種類を含める必要があります: Windows インスタンスの場合、パスワードをスラッシュ (/) で始めることはできません。 説明 パスワードを指定する場合は、パスワードのセキュリティを確保するために HTTPS を使用してリクエストを送信することをお勧めします。 |
ResourceGroupId | String | いいえ | rg-resource**** | ECS インスタンスが属するリソースグループの ID です。 |
HpcClusterId | String | いいえ | hpc-clusterid | ECS インスタンスが属する Elastic High Performance Computing (E-HPC) クラスターの ID です。 |
インスタンスの説明 | 文字列 | いいえ | テストインスタンス。 | ECS インスタンスの説明。説明は 2 ~ 256 文字でなければなりません。文字を含めることができますが、 |
ClientToken | String | いいえ | 123e4567-e89b-12d3-a456-42665544**** | リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。 詳細については、「べき等性を確保する」をご参照ください。 |
Ipv6AddressCount | 整数 | いいえ | 1 | ENI に割り当てるランダムに生成された IPv6 アドレスの数。 |
CreditSpecification | String | いいえ | 標準 | バースト可能インスタンスのパフォーマンスモード。有効な値:
詳細については、概要 トピックの「パフォーマンスモード」セクションをご参照ください。 |
ImageFamily | String | いいえ | hangzhou-daily-update | イメージファミリーの名前です。 このパラメーターを指定すると、インスタンス作成のために現在のイメージファミリー内で利用可能な最新のイメージを取得できます。 |
ゾーン ID | 文字列 | いいえ | cn-hangzhou-g | ECS インスタンスのゾーン ID です。 |
DedicatedHostId | String | いいえ | dh-bp67acfmxazb4p**** | ECS インスタンスを作成できる専用ホストの ID です。スポットインスタンスは専用ホストに作成できません。 DedicatedHostId を指定すると、SpotStrategy と SpotPriceLimit は無視されます。 DescribeDedicatedHosts 操作を呼び出して、専用ホストの ID をクエリできます。 |
アフィニティ | 文字列 | いいえ | default | 専用ホスト上の ECS インスタンスを専用ホストに関連付けるかどうかを指定します。有効な値:
デフォルト値: default。 |
テナンシー | 文字列 | いいえ | デフォルト | 専用ホストに ECS インスタンスを作成するかどうかを指定します。有効な値:
デフォルト値:default。 |
スケジューラオプション | マップ | いいえ | ["testManagedPrivateSpaceId****"] | スケジューラオプションです。 |
PrivatePoolOptions.MatchCriteria | String | いいえ | Open | ECS インスタンスの起動に使用するプライベートプールの種類。プライベートプールは、エラスティック保証または容量予約が有効になると生成されます。 Auto Scaling が ECS インスタンスを起動するためにプライベートプールを選択できます。有効な値:
|
PrivatePoolOptions.Id | String | いいえ | eap-bp67acfmxazb4**** | プライベートプールの ID です。プライベートプールの ID は、プライベートプールが生成される弾性保証または容量予約の ID と同じです。 |
SpotDuration | Integer | いいえ | 1 | スポットインスタンスの保護期間。単位:時間。有効な値:
デフォルト値:1。 |
SpotInterruptionBehavior | String | いいえ | Terminate | スポットインスタンスの中断モード。 値を Terminate に設定します。 この値は、スポットインスタンスを解放できることを指定します。 |
InstanceTypes.N | String | いいえ | ecs.g6.large | インスタンスタイプ N。N の有効な値: 1 ~ 10。 InstanceTypes.N を使用して指定された最初のインスタンスタイプは、最も優先度が高くなります。優先度は、指定されたインスタンスタイプの順序に基づいて減少します。Auto Scaling は、インスタンスタイプの優先度に基づいてインスタンスを作成します。Auto Scaling が最も優先度の高いインスタンスタイプを使用してインスタンスを作成できない場合、次に優先度の高いインスタンスタイプを使用してインスタンスが作成されます。 説明 InstanceType、InstanceTypes、InstanceTypeOverrides、および CPU とメモリを同時に指定することはできません。InstanceTypes と InstancePatternInfo を同時に指定できます。InstanceTypes と InstancePatternInfo を同時に指定した場合、Auto Scaling はスケールアウト イベント中に InstanceTypes で指定されたインスタンスタイプを優先的に使用します。指定されたインスタンスタイプの在庫が不足している場合、Auto Scaling はスケールアウト イベント中に InstancePatternInfo で指定されたインスタンスタイプを使用します。 |
InstanceTypeOverride.N.InstanceType | String | いいえ | ecs.c5.xlarge | スケーリング構成でインスタンスタイプ N の重みを指定する場合、InstanceTypeOverride.N.InstanceType と InstanceTypeOverride.N.WeightedCapacity を指定します。 このパラメーターは、インスタンスタイプ N を指定します。InstanceTypeOverride.N.InstanceType を使用して複数のインスタンスタイプを指定し、InstanceTypeOverride.N.WeightedCapacity を使用してインスタンスタイプの重みを指定できます。N の有効値: 1 ~ 10。 説明 このパラメーターを指定する場合、InstanceTypes.N または InstanceType は指定できません。 InstanceTypeOverride.N.InstanceType の InstanceType の有効値については、「インスタンスファミリの概要」をご参照ください。 |
InstanceTypeOverride.N.WeightedCapacity | Integer | No | 4 | スケーリング構成でインスタンスタイプの重みを指定する場合、InstanceTypeOverride.N.InstanceType を指定した後に InstanceTypeOverride.N.WeightedCapacity を指定します。 2 つの パラメーター の N の値は同じである必要があります。 この パラメーター は、インスタンスタイプ N の重みを指定します。重みは、スケーリング グループ 内のインスタンスタイプ N のインスタンスのキャパシティを指定します。重みが大きいほど、必要なキャパシティを達成するために必要な指定されたインスタンスタイプのインスタンスの数が少なくなります。 各インスタンスタイプの vCPU 数や メモリ サイズなどのパフォーマンス メトリック は異なる場合があります。ビジネス要件に基づいて、異なるインスタンスタイプに異なる重みを指定できます。 例:
必要なキャパシティを達成するために、Auto Scaling は 2 つの ecs.c5.xlarge インスタンス をスケールアウトする必要があります。 説明 スケーリング グループ の合計キャパシティは、MaxSize で定義された最大 グループ サイズと、スケールアウト イベント 中にインスタンスタイプに割り当てられた最大の重みの合計を超えることはできません。 InstanceTypeOverride.N.WeightedCapacity の WeightedCapacity の有効な値:1 ~ 500 |
DataDisk.N.PerformanceLevel | 文字列 | いいえ | PL1 | ESSD データディスク N のパフォーマンスレベル (PL)。 DataDisk.N.Category を cloud_essd に設定する場合、このパラメーターの N の値は、DataDisk.N.Category の N の値と同じである必要があります。有効な値:
デフォルト値: PL1。 説明 ESSD PL の選択方法の詳細については、「ESSD」をご参照ください。 |
DataDisk.N.AutoSnapshotPolicyId | String | いいえ | sp-bp19nq9enxqkomib**** | データディスク N に適用する自動スナップショットポリシーの ID です。N の有効な値: 1 ~ 16 です。 |
DataDisk.N.Encrypted | String | いいえ | false | データディスク N を暗号化するかどうかを指定します。N の有効な値: 1 ~ 16。有効な値:
デフォルト値: false。 |
DataDisk.N.Description | 文字列 | いいえ | テストデータディスク。 | データディスク N の説明。N の有効な値: 1 ~ 16。説明は 2 ~ 256 文字である必要があります。 |
DataDisk.N.SnapshotId | String | いいえ | s-280s7**** | データディスク N の作成に使用するスナップショットの ID です。N の有効な値: 1 ~ 16。このパラメーターを指定した場合、DataDisk.N.Size は無視されます。データディスクのサイズは、指定されたスナップショットのサイズと同じです。 2013 年 7 月 15 日以前に作成されたスナップショットを指定すると、操作は失敗し、InvalidSnapshot.TooOld が返されます。 |
DataDisk.N.Categories.N | String | いいえ | cloud | データディスク N のカテゴリ N。DataDisk.N.Categories.N の最初の N は、データディスクのシリアル番号を表します。最初の N の有効な値:1 ~ 16。DataDisk.N.Categories.N の 2 番目の N は、データディスクカテゴリのシリアル番号を表します。2 番目の N の有効な値:1 ~ 4。N の値が小さいほど、優先順位が高くなります。Auto Scaling が優先順位が最も高いディスクカテゴリを使用してディスクを作成できない場合、2 番目に優先順位の高いディスクカテゴリを使用してディスクが作成されます。有効な値:
説明 このパラメーターを指定する場合、 |
DataDisk.N.Size | Integer | いいえ | 100 | データディスク N のサイズ。単位:GiB。N の有効な値:1 ~ 16。有効な値:
データディスクのサイズは、SnapshotId で指定されたスナップショットのサイズ以上である必要があります。 |
DataDisk.N.Device | String | いいえ | /dev/xvdb | データディスク N のマウントターゲット。N の有効値:1 ~ 16。このパラメーターを空のままにすると、Auto Scaling が ECS インスタンスを作成するときに、システムが自動的にマウントターゲットを割り当てます。マウントターゲットの名前は /dev/xvdb から /dev/xvdz の範囲です。 |
DataDisk.N.DiskName | String | いいえ | cloud_ssdData | データディスク N の名前。N の有効な値: 1 ~ 16。名前は 2 ~ 128 文字で、英字、数字、コロン(:)、アンダースコア(_)、およびハイフン(-)を含めることができます。英字で始める必要がありますが、 |
DataDisk.N.Category | String | いいえ | cloud_ssd | データディスク N のカテゴリ。N の有効な値: 1 ~ 16。有効な値:
DataDisk.N.Category を指定する場合、
|
DataDisk.N.DeleteWithInstance | ブール値 | いいえ | true | データディスク N がアタッチされている ECS インスタンスがリリースされるときに、データディスク N をリリースするかどうかを指定します。有効な N の値: 1 ~ 16。有効な値:
このパラメーターは、DataDisk.N.Category が cloud、cloud_efficiency、cloud_ssd、cloud_essd、または cloud_auto に設定されている独立ディスクに対してのみ使用できます。他のディスクにこのパラメーターを指定すると、エラーが報告されます。 デフォルト値: true。 |
DataDisk.N.KMSKeyId | 文字列 | いいえ | 0e478b7a-4262-4802-b8cb-00d3fb40**** | データディスク N の暗号化に使用する Key Management Service (KMS) キーの ID です。N の有効な値: 1 ~ 16。 |
DataDisk.N.ProvisionedIops | Long | いいえ | 100 | データディスク N のプロビジョンド IOPS。 説明 IOPS は、Elastic Block Storage (EBS) デバイスが 1 秒あたりに処理できる読み取りおよび書き込み操作の数を指します。 |
DataDisk.N.バースト有効化 | ブール値 | いいえ | false | データディスク N のバースト機能を有効にするかどうかを指定します。有効な値:
詳細については、「ESSD AutoPL ディスク」をご参照ください。 |
SpotPriceLimit.N.PriceLimit | Float | いいえ | 0.5 | スポットインスタンス N の値幅制限。N の有効値:1 ~ 10。このパラメーターは、SpotStrategy を SpotWithPriceLimit に設定した場合にのみ有効になります。 |
SpotPriceLimit.N.InstanceType | String | いいえ | ecs.g6.large | スポットインスタンス N のインスタンスタイプ。N の有効値: 1 ~ 10。このパラメーターは、SpotStrategy を SpotWithPriceLimit に設定した場合にのみ有効になります。 |
SecurityGroupIds.N | 文字列 | いいえ | sg-bp18kz60mefs**** | ECS インスタンスを追加する セキュリティ グループ N の ID です。N の有効値は、各 ECS インスタンスのセキュリティ グループ クォータによって異なります。詳細については、「制限」Topic の「セキュリティ グループの制限」セクションをご参照ください。 説明 SecurityGroupId を指定する場合、SecurityGroupIds.N は指定できません。 |
InstancePatternInfo.N.コア数 | 整数 | いいえ | 2 | インテリジェント構成モードでインスタンスタイプ N に割り当てる vCPU の数。このパラメーターを指定すると、指定された条件を満たすインスタンスタイプを取得できます。詳細については、「インスタンスファミリの概要」をご参照ください。N の有効値: 1 ~ 10。 このパラメーターを指定する場合は、次の点に注意してください。
|
InstancePatternInfo.N.InstanceFamilyLevel | 文字列 | いいえ | エンタープライズレベル | インテリジェント構成モードにおけるインスタンスタイプ N のレベル。このパラメーターを指定すると、指定された条件を満たすインスタンスタイプを取得できます。有効な値:
N の有効な値:1 ~ 10。 |
InstancePatternInfo.N.MaxPrice | Float | いいえ | 2 | インテリジェント構成モードでの従量課金インスタンス N またはスポットインスタンス N の 1 時間あたりの最大価格。このパラメーターを指定すると、指定された条件を満たすインスタンスタイプを取得できます。N の有効な値:1 ~ 10。 説明 SpotStrategy を SpotWithPriceLimit に設定した場合、このパラメーターを指定する必要があります。それ以外の場合は、このパラメーターはオプションです。 |
InstancePatternInfo.N.Memory | Float | いいえ | 4 | インテリジェント構成モードにおけるインスタンスタイプ N のメモリサイズです。単位:GiB。このパラメーターを指定すると、指定された条件を満たすインスタンスタイプを取得できます。詳細については、「インスタンスファミリの概要」をご参照ください。N の有効値:1 ~ 10 です。 |
InstancePatternInfo.N.ExcludedInstanceType.N | 文字列 | いいえ | ecs.n1.small/ecs.n1.*/*7* | 除外するインスタンスタイプ N。 アスタリスク (*) をワイルドカード文字として使用して、インスタンスタイプまたはインスタンスファミリーを除外できます。 例:
|
InstancePatternInfo.N.Architecture.N | 文字列 | いいえ | x86 | インスタンスタイプ N のアーキテクチャ N。有効な値:
デフォルトでは、すべての値が選択されています。 |
InstancePatternInfo.N.BurstablePerformance | 文字列 | いいえ | 含める | バースト可能インスタンスタイプを含めるかどうかを指定します。有効な値:
デフォルト値:Include。 |
InstancePatternInfo.N.InstanceTypeFamilies.N | 文字列 | いいえ | ecs.g6 | インスタンスファミリー N。N の有効な値: 1 ~ 10。 |
InstancePatternInfo.N.MinimumCpuCoreCount | 整数 | いいえ | 2 | インスタンスタイプごとの vCPU の最小数。 |
InstancePatternInfo.N.MaximumCpuCoreCount | 整数 | いいえ | 4 | インスタンスタイプごとの vCPU の最大数。 説明
|
InstancePatternInfo.N.GpuSpecs.N | 文字列 | いいえ | NVIDIA V100 | GPU モデル。 |
InstancePatternInfo.N.InstanceCategories.N | String | いいえ | GPU を搭載したコンピューティング最適化 | インスタンスタイプ N のカテゴリ N。有効な値: 説明 N の有効な値:1 ~ 10
|
InstancePatternInfo.N.CpuArchitectures.N | String | いいえ | X86 | ECS インスタンスの CPU アーキテクチャ N。有効な値: 説明 N の有効な値: 1 と 2。
|
InstancePatternInfo.N.PhysicalProcessorModels.N | String | いいえ | "Intel Xeon(Ice Lake) Platinum 8369B"、"Intel Xeon(Skylake) Platinum 8163"、… "Intel Xeon(Cascade Lake) Platinum 8269CY" | ECS インスタンスのプロセッサモデル N。N の有効値:1 ~ 10。 |
InstancePatternInfo.N.MinimumEniQuantity | 整数 | いいえ | 2 | インスタンスあたりの弾性ネットワークインターフェース(ENI)の最小数。 |
InstancePatternInfo.N.MinimumEniPrivateIpAddressQuantity | 整数 | いいえ | 2 | ENI ごとの IPv4 アドレスの最小数。 |
InstancePatternInfo.N.MinimumEniIpv6AddressQuantity | 整数 | いいえ | 1 | ENI ごとの IPv6 アドレスの最小数。 |
InstancePatternInfo.N.MinimumInitialCredit | 整数 | いいえ | 12 | t5 または t6 バースト可能インスタンスあたりの初期 vCPU クレジット。 |
InstancePatternInfo.N.MinimumBaselineCredit | 整数 | いいえ | 12 | t5 または t6 バースト可能インスタンスあたりの最小ベースライン vCPU 計算パフォーマンス(すべての vCPU の全体的なベースラインパフォーマンス)。 |
InstancePatternInfo.N.MinimumMemorySize | Float | いいえ | 4 | インスタンスあたりの最小メモリサイズです。単位:GiB。 |
InstancePatternInfo.N.MaximumMemorySize | Float | いいえ | 4 | インスタンスあたりの最大メモリサイズ。単位:GiB。 |
InstancePatternInfo.N.MinimumGpuAmount | 整数 | いいえ | 2 | インスタンスあたりの最小 GPU 数です。値は正の整数である必要があります。 |
InstancePatternInfo.N.MaximumGpuAmount | 整数 | いいえ | 2 | インスタンスあたりの GPU の最大数。値は正の整数である必要があります。 |
SystemDiskCategories.N | 文字列 | いいえ | クラウド | システムディスクのカテゴリ N。N の有効な値: 1 ~ 4。N の値が小さいほど、優先度が高くなります。Auto Scaling が優先度が最も高いディスクカテゴリを使用してディスクを作成できない場合、2 番目に優先度が高いディスクカテゴリを使用してディスクが作成されます。有効な値:
説明 このパラメーターを指定する場合、 |
システムディスクの暗号化 | ブール値 | いいえ | false | システムディスクを暗号化するかどうかを指定します。有効な値:
デフォルト値: false。 |
SystemDisk.KMSKeyId | String | いいえ | 0e478b7a-4262-4802-b8cb-00d3fb40**** | システムディスクの暗号化に使用する KMS キーの ID です。 |
SystemDisk.EncryptAlgorithm | String | いいえ | AES-256 | システムディスクの暗号化に使用するアルゴリズム。有効な値:
デフォルト値: AES-256。 |
SystemDisk.ProvisionedIops | Long | いいえ | 100 | システムディスクのプロビジョンド IOPS。 説明 IOPS は、EBS デバイスが 1 秒あたりに処理できる読み取りおよび書き込み操作の数を指します。 |
SystemDisk.BurstingEnabled | ブール値 | いいえ | false | システムディスクのバースト機能を有効にするかどうかを指定します。有効な値:
詳細については、「ESSD AutoPL ディスク」をご参照ください。 |
ImageOptions.LoginAsNonRoot | ブール値 | いいえ | false |
デフォルト値: false。 |
DeletionProtection | ブール値 | いいえ | false | ECS インスタンスに対してリリース保護機能を有効にするかどうかを指定します。このパラメーターは、従量課金インスタンスでのみ使用できます。このパラメーターを使用すると、ECS コンソールで、または DeleteInstance 操作を呼び出すことによって、ECS インスタンスを直接リリースできるかどうかを指定できます。有効な値:
デフォルト値: false。 説明 リリース保護は通常のスケールインには影響しません。ECS インスタンスに対してリリース保護を有効にし、ECS インスタンスがスケールインポリシーで定義されている要件を満たしている場合、スケールイン中に ECS インスタンスをリリースできます。 |
StorageSetId | String | いいえ | ss-bp67acfmxazb4p**** | ストレージセットの ID です。 |
StorageSetPartitionNumber | 整数 | いいえ | 2 | ストレージセットの最大パーティション数。 値は 2 以上の整数である必要があります。 |
CustomPriorities.N.InstanceType | String | いいえ | ecs.g6.large |
説明 このパラメーターは、スケーリンググループの Auto Scaling が優先順位が最も高い ECS インスタンスタイプ + vSwitch の組み合わせを使用して ECS インスタンスを作成できない場合、2 番目に優先順位の高い ECS インスタンスタイプ + vSwitch の組み合わせを使用して ECS インスタンスが自動的に作成されます。 説明 特定の ECS インスタンスタイプ + vSwitch の組み合わせのみに優先順位を指定した場合、Auto Scaling は優先順位が指定された組み合わせを優先的に使用します。指定された優先順位の組み合わせで十分なリソースが提供されない場合、Auto Scaling は、指定された vSwitch とインスタンスタイプの順序に基づいて、優先順位が指定されていない組み合わせを使用します。例:スケーリンググループの vSwitch の指定された順序は vsw1 と vsw2 で、スケーリング構成のインスタンスタイプの指定された順序は type1 と type2 です。さらに、CustomPriorities を使用して |
CustomPriorities.N.VswitchId | String | いいえ | vsw-bp14zolna43z266bq**** |
説明 このパラメーターは、 |
NetworkInterfaces.N.InstanceType | String | いいえ | プライマリ | ENI の種類。
デフォルト値: セカンダリ。 |
NetworkInterfaces.N.NetworkInterfaceTrafficMode | String | いいえ | HighPerformance | ENI の通信モード。有効な値:
デフォルト値:Standard。 説明 インスタンスあたりの ERI の数は、インスタンスファミリーでサポートされている ERI の最大数を超えることはできません。詳細については、「インスタンスファミリーの概要」をご参照ください。 |
NetworkInterfaces.N.Ipv6AddressCount | 整数 | いいえ | 1 | プライマリ ENI N に割り当てるランダムに生成された IPv6 アドレスの数です。このパラメーターを指定する場合は、次の項目に注意してください。
|
NetworkInterfaces.N.SecurityGroupIds.N | 文字列 | いいえ | sg-uf6ij8dwxh**** | ENI N が属するセキュリティグループ N の ID です。このパラメーターを指定する場合は、次の点に注意してください。
|
DedicatedHostClusterId | String | いいえ | dc-2zedxc67zqzt7lb4**** | 専用ホストクラスターの ID です。 |
SecurityOptions.ConfidentialComputingMode | 文字列 | いいえ | TDX | 機密コンピューティングモード。有効な値:
|
Httpエンドポイント | 文字列 | いいえ | 有効化済み | インスタンスメタデータへのアクセスチャネルを有効にするかどうかを指定します。有効な値:
デフォルト値: enabled です。 説明 インスタンスメタデータの詳細については、「ECS インスタンスメタデータの概要」をご参照ください。 |
HttpTokens | String | いいえ | オプション | インスタンスメタデータにアクセスするために、セキュリティ強化モード(IMDSv2)を強制的に使用するかどうかを指定します。有効な値:
デフォルト値:optional。 説明 詳細については、「インスタンスメタデータのアクセスモード」をご参照ください。 |
ResourcePoolOptions.Strategy | String | いいえ | PrivatePoolFirst | インスタンス作成に使用されるリソースプール。パブリックプール、またはアクティブな弾力性保証もしくは容量予約に関連付けられたプライベートプールを指定できます。有効な値:
デフォルト値:None。 |
ResourcePoolOptions.PrivatePoolIds.N | String | いいえ | eap-bp67acfmxazb4**** | 非公開プール N の ID です。非公開プールの ID は、非公開プールに関連付けられている弾力性保証または容量予約の ID と同じです。このパラメーターには、対象となる非公開プールの ID のみ指定できます。N の有効な値: 1 ~ 20 です。 |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
ScalingConfigurationId | String | asc-bp1ffogfdauy0nu5**** | スケーリング構成 ID です。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | リクエスト ID です。 |
例
リクエストの例
http(s)://ess.aliyuncs.com/?Action=CreateScalingConfiguration
&ScalingGroupId=asg-bp14wlu85wrpchm0****
&ImageId=centos6u5_64_20G_aliaegis****.vhd
&ImageName=image****
&InstanceType=ecs.g6.large
&Cpu=2
&Memory=16
&DeploymentSetId=ds-bp1frxuzdg87zh4pz****
&SecurityGroupId=sg-280ih****
&IoOptimized=optimized
&InternetChargeType=PayByTraffic
&InternetMaxBandwidthIn=10
&InternetMaxBandwidthOut=10
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=100
&SystemDisk.DiskName=cloud_ssdSystem
&SystemDisk.Description=Test system disk. // システムディスクのテスト
&SystemDisk.AutoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&SystemDisk.PerformanceLevel=PL1
&ScalingConfigurationName=scalingconfig****
&LoadBalancerWeight=50
&Tags={"key1":"value1","key2":"value2", ... "key5":"value5"}
&UserData=ZWNobyBoZWxsbyBlY3Mh
&KeyPairName=KeyPairTest
&RamRoleName=ramrole****
&SecurityEnhancementStrategy=Active
&InstanceName=instance****
&HostName=host****
&SpotStrategy=NoSpot
&PasswordInherit=false
&Password=123abc****
&ResourceGroupId=rg-resource****
&HpcClusterId=hpc-clusterid
&InstanceDescription=Test instance. // インスタンステスト
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Ipv6AddressCount=1
&CreditSpecification=Standard
&ImageFamily=hangzhou-daily-update
&ZoneId=cn-hangzhou-g
&DedicatedHostId=dh-bp67acfmxazb4p****
&Affinity=default
&Tenancy=default
&PrivatePoolOptions.MatchCriteria=Open
&PrivatePoolOptions.Id=eap-bp67acfmxazb4****
&SpotDuration=1
&SpotInterruptionBehavior=Terminate
&InstanceTypes=["ecs.g6.large"]
&InstanceTypeOverride=[{"InstanceType":"ecs.c5.xlarge","WeightedCapacity":4}]
&DataDisk=[{"PerformanceLevel":"PL1","AutoSnapshotPolicyId":"sp-bp19nq9enxqkomib****","Encrypted":"false","Description":"Test data disk.","SnapshotId":"s-280s7****","Categories":["cloud"],"Size":100,"Device":"/dev/xvdb","DiskName":"cloud_ssdData","Category":"cloud_ssd","DeleteWithInstance":true,"KMSKeyId":"0e478b7a-4262-4802-b8cb-00d3fb40****","ProvisionedIops":100,"BurstingEnabled":false}] // データディスクのテスト
&SpotPriceLimit=[{"PriceLimit":0.5,"InstanceType":"ecs.g6.large"}]
&SecurityGroupIds=["sg-bp18kz60mefs****"]
&InstancePatternInfo=[{"Cores":2,"InstanceFamilyLevel":"EnterpriseLevel","MaxPrice":2.0,"Memory":4.0,"ExcludedInstanceType":["ecs.n1.small/ecs.n1.*/*7*"],"Architecture":["X86"],"BurstablePerformance":"Include","InstanceTypeFamilies":["ecs.g6"],"MinimumCpuCoreCount":2,"MaximumCpuCoreCount":4,"GpuSpecs":["NVIDIA V100"],"InstanceCategories":["Compute-optimized with GPU"],"CpuArchitectures":["X86"],"PhysicalProcessorModels":["Intel Xeon(Ice Lake) Platinum 8369B\", \"Intel Xeon(Skylake) Platinum 8163\", … \"Intel Xeon(Cascade Lake) Platinum 8269CY"],"MinimumEniQuantity":2,"MinimumEniPrivateIpAddressQuantity":2,"MinimumEniIpv6AddressQuantity":1,"MinimumInitialCredit":12,"MinimumBaselineCredit":12,"MinimumMemorySize":4.0,"MaximumMemorySize":4.0,"MinimumGpuAmount":2,"MaximumGpuAmount":2}]
&SystemDiskCategories=["cloud"]
&SystemDisk.Encrypted=false
&SystemDisk.KMSKeyId=0e478b7a-4262-4802-b8cb-00d3fb40****
&SystemDisk.EncryptAlgorithm=AES-256
&SystemDisk.ProvisionedIops=100
&SystemDisk.BurstingEnabled=false
&ImageOptions.LoginAsNonRoot=false
&DeletionProtection=false
&StorageSetId=ss-bp67acfmxazb4p****
&StorageSetPartitionNumber=2
&CustomPriorities=[{"InstanceType":"ecs.g6.large","VswitchId":"vsw-bp14zolna43z266bq****"}]
&NetworkInterfaces=[{"InstanceType":"Primary","NetworkInterfaceTrafficMode":"HighPerformance","Ipv6AddressCount":1,"SecurityGroupIds":["sg-uf6ij8dwxh****"]}]
&DedicatedHostClusterId=dc-2zedxc67zqzt7lb4****
&SecurityOptions={"ConfidentialComputingMode":"TDX"}
&HttpEndpoint=enabled
&HttpTokens=optional
&ResourcePoolOptions={"Strategy":"PrivatePoolFirst","PrivatePoolIds":["eap-bp67acfmxazb4****"]}
&<Common request parameters> // 共通リクエストパラメーター正常なレスポンスの例
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateScalingConfigurationResponse>
<ScalingConfigurationId>asc-bp1ffogfdauy0nu5****</ScalingConfigurationId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateScalingConfigurationResponse>JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"ScalingConfigurationId" : "asc-bp1ffogfdauy0nu5****",
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}エラーコード
詳細については、「サービス エラーコード」をご参照ください。
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
400 | InstanceType.Mismatch | 指定されたスケーリング構成と既存のアクティブなスケーリング構成のインスタンスタイプが異なります。 | 指定されたスケーリング構成のインスタンスタイプが、現在のスケーリング構成のインスタンスタイプと一致しません。 |
404 | InvalidDataDiskSnapshotId.NotFound | スナップショット「XXX」は存在しません。 | スナップショットは存在しません。 |
400 | InvalidDataDiskSnapshotId.SizeNotSupported | スナップショット「XXX」の容量が、指定されたディスクカテゴリのサイズ制限を超えています。 | スナップショットのサイズが、ディスクに許可されている最大サイズを超えています。 |
403 | InvalidDevice.InUse | デバイス「XXX」は使用中です。 | データディスクのマウントターゲットは使用中です。 |
400 | InvalidImageId.InstanceTypeMismatch | 指定されたイメージは、指定されたインスタンスタイプをサポートしていません。 | 指定されたイメージは、指定されたインスタンスタイプをサポートしていません。 |
404 | InvalidImageId.NotFound | 指定されたイメージは存在しません。 | 指定されたイメージは Alibaba Cloud アカウントに存在しません。 |
400 | InvalidKeyPairName.NotFound | 指定された KeyPairName はレコードに存在しません。 | 指定されたキーペアは存在しません。 |
400 | InvalidNetworkType.ForRAMRole | RAM ロールはクラシックインスタンスでは使用できません。 | インスタンスのネットワークタイプはクラシックネットワークです。クラシックネットワークは RamRoleName をサポートしていません。 |
400 | InvalidParameter | パラメーター KeyPairName の指定された値が無効です。 | 指定されたインスタンスの OS は Windows です。 Windows インスタンスは KeyPairName をサポートしていません。 |
400 | InvalidParameter.Conflict | パラメーター SystemDisk.Category とパラメーター DataDisk.N.Category の値が競合しています。 | 指定されたシステムディスクカテゴリがデータディスクカテゴリと競合しています。 |
400 | InvalidRamRole.NotFound | 指定された RamRoleName は存在しません。 | RamRoleName の値が無効です。 |
400 | InvalidScalingConfigurationName.Duplicate | パラメーター ScalingConfigurationName の指定された値が重複しています。 | 同じ名前のスケーリング構成が既に存在します。 |
404 | InvalidScalingGroupId.NotFound | 指定されたスケーリンググループは存在しません。 | 指定されたスケーリンググループは Alibaba Cloud アカウントに存在しません。 |
400 | InvalidSecurityGroupId.IncorrectNetworkType | 指定されたセキュリティグループのネットワークタイプはこの操作をサポートしていません。 | 指定されたセキュリティグループのネットワークタイプが、スケーリンググループのネットワークタイプと異なります。 |
404 | InvalidSecurityGroupId.NotFound | 指定されたセキュリティグループは存在しません。 | 指定されたセキュリティグループは Alibaba Cloud アカウントに存在しません。 |
400 | InvalidSecurityGroupId.VPCMismatch | 指定されたセキュリティグループと指定された仮想スイッチは同じ VPC にありません。 | 指定されたセキュリティグループと vSwitch は同じ VPC にありません。 |
403 | InvalidSnapshot.TooOld | 指定されたスナップショットが 2013 年 7 月 15 日より前に作成されているため、この操作は拒否されます。 | 指定されたスナップショットは 2013 年 7 月 15 日以前に作成されたため、リクエストは拒否されます。 |
403 | InvalidSystemDiskCategory.ValueUnauthorized | システムディスクカテゴリは承認されていません。 | 一時的なシステムディスクを作成する権限がありません。 |
400 | InvalidUserData.Base64FormatInvalid | 指定されたパラメーター UserData は Base64 でエンコードされている必要があります。 | ユーザーデータは Base64 形式でエンコードされていません。 |
400 | InvalidUserData.SizeExceeded | 指定されたパラメーター UserData がサイズを超えています。 | ユーザーデータのサイズが上限を超えています。 |
403 | QuotaExceeded.EphemeralDiskSize | 一時ディスクサイズクォータを超えました。 | マウントされている一時ディスクの合計容量が 2 TiB(2,048 GiB)を超えています。 |
400 | QuotaExceeded.ScalingConfiguration | 指定されたスケーリンググループでスケーリング構成クォータを超えました。 | スケーリング構成の最大数に達しました。 |
400 | QuotaExceeded.SecurityGroupInstance | 指定されたセキュリティグループでインスタンスクォータを超えました。 | 指定されたセキュリティグループに関連付けることができる ECS インスタンスの最大数に達しました。 |
400 | InvalidSecurityGroupId.IncorrectType | マネージドセキュリティグループ「XXX」はサポートされていません。 | マネージドセキュリティグループ「XXX」はサポートされていません。 |