スケーリンググループにECSインスタンスを手動で追加します。
操作説明
操作説明
-
この操作を呼び出す前に、以下の条件が満たされていることを確認してください。
スケーリンググループがアクティブ状態であること。
スケーリンググループ内でスケーリングアクティビティが進行中でないこと。
-
スケーリンググループに追加するECSインスタンスまたはElastic Container Instance(ECI)インスタンスには、以下の制限が適用されます。 - インスタンスはスケーリンググループと同じリージョンにある必要があります。 - インスタンスは実行中状態である必要があります。 - インスタンスは既に別のスケーリンググループに属していてはなりません。 - インスタンスの支払い方式は、サブスクリプション、従量課金、またはスポットインスタンスである必要があります。 - スケーリンググループにVswitchIDが指定されている場合、クラシックネットワークタイプのECSインスタンスまたはECIインスタンスはスケーリンググループに追加できません。別のVPC 内のECSインスタンスまたはECIインスタンスもスケーリンググループに追加できません。 - スケーリンググループにVswitchIDが指定されていない場合、VPCネットワークタイプのECSインスタンスまたはECIインスタンスはスケーリンググループに追加できません。
-
スケーリンググループに追加するマネージドインスタンスには、以下の制限が適用されます。
マネージドインスタンスはスケーリンググループと同じリージョンにある必要があります。
スケーリンググループに属していないマネージドインスタンスのみが、ECSタイプのスケーリンググループに追加できます。
マネージドインスタンスは、ライフサイクルフック、ロードバランシング関連付け、またはヘルスチェック機能をサポートしていません。
マネージドインスタンスがECSタイプのスケーリンググループに追加された後、スケーリンググループはマネージドインスタンスのライフサイクルを管理しません。
マネージドインスタンスは、スケーリンググループへの追加または削除を手動でのみ行うことができます。マネージドインスタンスは削除後もリリースされません。
-
この操作を呼び出す際には、以下の項目に注意してください。
スケーリンググループ内でスケーリングアクティビティが進行中でない場合、この操作はクールダウン時間(Cooldown)をバイパスし、即座に実行できます。
呼び出しが成功した場合、Auto Scalingがリクエストを受け付けたことのみを示します。スケーリングアクティビティは実行可能ですが、呼び出しの成功はスケーリングアクティビティの成功を保証するものではありません。返されたScalingActivityIdに基づいて、スケーリングアクティビティの実行ステータスを確認できます。
この操作で指定されたインスタンス数と、スケーリンググループの現在のインスタンス数(合計キャパシティ)の合計が最大サイズ(MaxSize)を超える場合、呼び出しは失敗します。
この操作を呼び出して手動で追加されたECSインスタンス、ECIインスタンス、またはマネージドインスタンスは、スケーリンググループのアクティブなスケーリング設定に関連付けられません。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ScalingGroupId |
string |
必須 |
スケーリンググループのID。 |
asg-bp18p2yfxow2dloq**** |
| Entrusted |
boolean |
任意 |
既存のインスタンスをスケーリンググループに手動で追加する際に、インスタンスのライフサイクルをスケーリンググループに委任するかどうかを指定します。有効な値:
説明
このパラメーターは、サブスクリプションインスタンス、マネージドインスタンス、またはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスではサポートされていません。 デフォルト値:false。 |
false |
| InstanceId |
array |
任意 |
追加するECSインスタンス、ECIインスタンス、マネージドインスタンス、またはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスのインスタンスID。Nの有効な値:1~20。 例:
説明
1 回のリクエストで処理できるインスタンスの種類は1つのみです。 |
i-28wt4**** |
|
string |
任意 |
追加するECSインスタンス、ECIインスタンス、マネージドインスタンス、またはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスのインスタンスID。Nの有効な値:1~20。 例:
説明
1 回のリクエストで処理できるインスタンスの種類は1つのみです。 |
i-28wt4**** |
|
| LoadBalancerWeight |
array |
任意 |
ロードバランシングインスタンスのバックエンドサーバーとしてのECSインスタンスまたはECIインスタンスの重み。 説明
このパラメーターは、マネージドインスタンスまたはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスではサポートされていません。 |
50 |
|
integer |
任意 |
ロードバランシングインスタンスのバックエンドサーバーとしての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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。