スケーリンググループから1つ以上のECSインスタンスを削除します。
操作説明
操作説明
-
この操作を呼び出す前に、以下の条件を満たしていることを確認してください:
-
スケーリンググループがアクティブ状態であること。
-
スケーリンググループでスケーリングアクティビティが実行されていないこと。
-
スケーリンググループでスケーリングアクティビティが実行されていない場合、この操作はクールダウン期間(DefaultCooldown)をバイパスして即座に実行できます。
-
ECSインスタンスがAuto Scalingによって自動的に作成された場合、または手動で追加されたがスケーリンググループに委託されている場合、スケーリンググループから削除されるときにECSインスタンスはエコノミーモードに入るか、リリースされます。
-
ECSインスタンスが手動で追加され、スケーリンググループに委託されていない場合、スケーリンググループから削除されてもECSインスタンスは停止またはリリースされません。
-
スケーリンググループの現在のインスタンス数(TotalCapacity)からこの操作で指定されたインスタンス数を引いた値がスケーリンググループの最小インスタンス数(MinSize)未満になる場合、呼び出しは失敗します。
正常なレスポンスは、Auto Scalingがリクエストを受け付けたことのみを示します。スケーリングアクティビティは実行可能ですが、正常なレスポンスはスケーリングアクティビティの成功を保証するものではありません。返されたScalingActivityIdに基づいて、スケーリングアクティビティの実行状態を確認できます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:DetachInstances |
update |
*ScalingGroup
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ScalingGroupId |
string |
必須 |
スケーリンググループのID。 |
asg-bp18p2yfxow2dloq**** |
| RemovePolicy |
string |
任意 |
削除されるECSインスタンスに対して実行するアクション。有効な値:
デフォルト値:release。 |
release |
| DecreaseDesiredCapacity |
boolean |
任意 |
期待インスタンス数を変更するかどうかを指定します。有効な値:
デフォルト値:true。 |
true |
| IgnoreInvalidInstance |
boolean |
任意 |
スケーリンググループからインスタンスを一括削除する際に、無効なインスタンスを無視するかどうかを指定します。有効な値:
デフォルト値:false。 |
false |
| InstanceId |
array |
必須 |
削除するECSインスタンスのID。 |
i-28wt4**** |
|
string |
任意 |
削除するECSインスタンスのID。Nの有効な値:1~20。 |
i-28wt4**** |
|
| RegionId |
string |
任意 |
スケーリンググループのリージョンID。 |
cn-qingdao |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。トークンにはASCII 文字のみを含めることができ、64 文字を超えることはできません。詳細については、べき等性の確保方法を参照してください。 |
123e4567-e89b-12d3-a456-42665544**** |
| StopInstanceTimeout |
integer |
任意 |
スケールインプロセス中にECSインスタンスの停止を待機するタイムアウト期間。単位:秒。 有効な値:30~240。 説明
|
60 |
| LifecycleHookContext |
object |
任意 |
ライフサイクルフックのコンテキスト情報。 |
|
| DisableLifecycleHook |
boolean |
任意 |
スケーリングアクティビティのすべてのライフサイクルフックを無効にするかどうかを指定します。有効な値:
|
false |
| IgnoredLifecycleHookIds |
array |
任意 |
スケーリングアクティビティで無効にするライフサイクルフックIDのリスト。 |
|
|
string |
任意 |
スケーリングアクティビティで無効にするライフサイクルフックIDのリスト。 |
ash-bp14zolna43z266bq*** |
|
| LifecycleHookResult |
string |
任意 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| ScalingActivityId |
string |
スケーリングアクティビティのID。 |
asa-bp175o6f6ego3r2j**** |
| RequestId |
string |
リクエストID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| IgnoredInstances |
object |
||
| IgnoredInstance |
array<object> |
||
|
object |
|||
| InstanceId |
string |
||
| Code |
string |
||
| Message |
string |
例
成功レスポンス
JSONJSON
{
"ScalingActivityId": "asa-bp175o6f6ego3r2j****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"IgnoredInstances": {
"IgnoredInstance": [
{
"InstanceId": "",
"Code": "",
"Message": ""
}
]
}
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。