スケーリンググループに ECS インスタンスを追加します。
操作説明
操作の説明
-
この操作を呼び出す前に、以下の条件が満たされていることを確認してください。
スケーリンググループがアクティブな状態であること。
スケーリンググループで進行中のスケーリングアクティビティがないこと。
-
スケーリンググループに追加する ECS インスタンスまたは Elastic Container Instance (ECI) インスタンスの使用制限:
インスタンスはスケーリンググループと同じリージョンにある必要があります。
インスタンスは実行中状態である必要があります。
インスタンスは他のスケーリンググループに追加されていない必要があります。
インスタンスの課金方法は、サブスクリプション、従量課金、またはスポットインスタンスである必要があります。
スケーリンググループに VSwitchId が指定されている場合、クラシックネットワーク接続の ECS インスタンスまたは ECI インスタンス、および他の VPC 内の ECS インスタンスまたは ECI インスタンスをスケーリンググループに追加することはできません。
スケーリンググループに VSwitchId が指定されていない場合、VPC 接続の ECS インスタンスまたは ECI インスタンスをスケーリンググループに追加することはできません。
-
スケーリンググループに追加するホストインスタンスの使用制限:
ホストインスタンスはスケーリンググループと同じリージョンにある必要があります。
どのスケーリンググループにも追加されていないホストインスタンスのみを ECS スケーリンググループに追加できます。
ホストインスタンスは、ライフサイクルフック、負荷分散との関連付け、またはヘルスチェック機能をサポートしていません。
ホストインスタンスが ECS スケーリンググループに追加された後、スケーリンググループはホストインスタンスのライフサイクルを管理しません。
ホストインスタンスは、スケーリンググループに手動で追加またはスケーリンググループから手動で削除することのみが可能です。削除されたホストインスタンスはリリースされません。
-
この操作を使用する際の注意事項:
スケーリンググループで進行中のスケーリングアクティビティがない場合、この操作はクールダウン時間をバイパスして直接実行できます。
成功の応答は、Auto Scaling サービスが呼び出しリクエストを受け入れ、スケーリングアクティビティを実行できることのみを示します。スケーリングアクティビティが正常に実行されることを意味する (平均値) ものではありません。返された ScalingActivityId を使用して、スケーリングアクティビティの実行ステータスを確認する必要があります。
この操作で指定されたインスタンス数とスケーリンググループ内の現在のインスタンスの合計数の合計が、許可されているインスタンス数の最大値を超える場合、呼び出しは失敗します。
この操作を使用して手動で追加された ECS インスタンス、ECI インスタンス、またはホストインスタンスは、スケーリンググループのアクティブなスケーリング設定に関連付けられません。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:AttachInstances |
update |
*スケーリンググループ。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ScalingGroupId |
string |
必須 |
スケーリンググループの ID。 |
asg-bp18p2yfxow2dloq**** |
| Entrusted |
boolean |
任意 |
インスタンスがスケーリンググループに手動で追加されるときに、既存のインスタンスのライフサイクルをスケーリンググループに委任するかどうかを指定します。有効な値:
説明
このパラメーターの設定項目は、サブスクリプションインスタンス、ホストインスタンス、またはスケーリンググループ内の停止済みインスタンスではサポートされていません。 デフォルト値: false。 |
false |
| InstanceId |
array |
任意 |
InstanceId.N は、追加する ECS インスタンス、ECI インスタンス、ホストインスタンス、またはスケーリンググループ内の停止済みインスタンスのインスタンス ID を指定します。N の有効な値: 1~20。 例:
説明
1 回のリクエストで処理できるのは 1 種類のインスタンスのみです。 |
i-28wt4**** |
|
string |
任意 |
InstanceId.N は、追加する ECS インスタンス、ECI インスタンス、ホストインスタンス、またはスケーリンググループ内の停止済みインスタンスのインスタンス ID を指定します。N の有効な値: 1~20。 例:
説明
1 回のリクエストで処理できるのは 1 種類のインスタンスのみです。 |
i-28wt4**** |
|
| LoadBalancerWeight |
array |
任意 |
負荷分散バックエンドサーバーとしての ECS インスタンスまたは ECI インスタンスの重み。 説明
このパラメーターの設定項目は、ホストインスタンスまたはスケーリンググループ内の停止済みインスタンスではサポートされていません。 |
50 |
|
integer |
任意 |
LoadBalancerWeight.N は、負荷分散インスタンスのバックエンドサーバーとしての ECS インスタンスまたは ECI インスタンスの重みを指定します。N の有効な値: 1~20。このパラメーターの有効な値: 1~100。 説明
このパラメーターの設定項目は、ホストインスタンスまたはスケーリンググループ内の停止済みインスタンスではサポートされていません。 デフォルト値: 50。 |
50 |
|
| LifecycleHook |
boolean |
任意 |
インスタンスがスケーリンググループに追加されるときに、スケールアウトライフサイクルフックをトリガーするかどうかを指定します。有効な値:
説明
このパラメーターは、ホストインスタンスまたはスケーリンググループ内の停止済みインスタンスではサポートされていません。 デフォルト値: false。 |
false |
| RegionId |
string |
任意 |
スケーリンググループのリージョン ID。 |
cn-qingdao |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントから値を生成して、異なるリクエスト間で値が一意になるようにすることができます。トークンには ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」を参照してください。 |
123e4567-e89b-12d3-a456-42665544**** |
| IgnoreInvalidInstance |
boolean |
任意 |
インスタンスのバッチがスケーリンググループに追加されるときに、無効なインスタンスを無視するかどうかを指定します。有効な値:
デフォルト値: false。 |
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| ScalingActivityId |
string |
スケーリングアクティビティの ID。 |
asa-bp1crxor24s28xf1**** |
| RequestId |
string |
リクエスト ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
例
成功レスポンス
JSONJSON
{
"ScalingActivityId": "asa-bp1crxor24s28xf1****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。