スケーリンググループから1つ以上のECSインスタンスを削除します。
操作説明
操作説明
-
この操作を呼び出す前に、以下の条件が満たされていることを確認してください:
-
スケーリンググループが有効状態であること。
-
スケーリンググループでスケーリングアクティビティが進行中でないこと。
説明スケーリンググループでスケーリングアクティビティが進行中でない場合、この操作はクールダウン時間をバイパスして、直接スケーリングアクティビティをトリガーできます。
-
-
以下の項目に注意してください:
ECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスがスケーリンググループから削除された後、そのインスタンスは独立して存在し続けます。 AttachInstances 操作を呼び出して、ECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスを別のスケーリンググループに追加できます。
この操作を呼び出してECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスを削除しても、インスタンスは停止またはリリースされません。
操作が呼び出された後、Auto Scalingがリクエストを受け入れたことのみを示します。スケーリングアクティビティはトリガーされる可能性がありますが、スケーリングアクティビティの成功は保証されません。返されたScalingActivityIdに基づいて、スケーリングアクティビティのステータスを確認する必要があります。
スケーリンググループ内のECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスの数から削除されるインスタンスの数を引いた値が、スケーリンググループの最小インスタンス数(MinSize)を下回ることはできません。そうでない場合、エラーが返されます。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ScalingGroupId |
string |
必須 |
スケーリンググループのID。 |
asg-bp1igpak5ft1flyp**** |
| DecreaseDesiredCapacity |
boolean |
任意 |
インスタンスの期待数を変更するかどうかを指定します。有効な値:
デフォルト値:true。 |
true |
| IgnoreInvalidInstance |
boolean |
任意 |
スケーリンググループからインスタンスを一括削除する際に、無効なインスタンスを無視するかどうかを指定します。有効な値:
デフォルト値:false。 |
false |
| DetachOption |
string |
任意 |
関連付けられたロードバランシングインスタンスのバックエンドサーバーとしてECSインスタンスまたはエラスティックコンテナインスタンスの使用を停止するかどうか(つまり、ロードバランシングインスタンスのデフォルトサーバーグループおよび仮想サーバーグループからECSインスタンスまたはエラスティックコンテナインスタンスを削除するかどうか)、および関連付けられたApsaraDB RDSインスタンスのアクセスホワイトリストからECSインスタンスまたはエラスティックコンテナインスタンスを削除するかどうかを指定します。 both:ロードバランシングインスタンスのデフォルトサーバーグループおよび仮想サーバーグループからECSインスタンスまたはエラスティックコンテナインスタンスを削除し、ApsaraDB RDSインスタンスのアクセスホワイトリストからECSインスタンスまたはエラスティックコンテナインスタンスを削除します。 説明
マネージドインスタンスをスケーリンググループから削除する場合、このパラメーターの設定はサポートされていません。 |
both |
| InstanceId |
array |
必須 |
削除するECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスのID。 |
i-bp109k5j3dum1ce6**** |
|
string |
任意 |
削除するECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスのインスタンスID。Nの有効な値:1~20。 例:
説明
1 回のリクエストで削除できるインスタンスタイプは1 種類のみです。 |
i-bp109k5j3dum1ce6**** |
|
| LifecycleHook |
boolean |
任意 |
ECSインスタンスまたはエラスティックコンテナインスタンスをスケーリンググループから削除する際に、スケールインライフサイクルフックをトリガーするかどうかを指定します。有効な値:
説明
マネージドインスタンスをスケーリンググループから削除する場合、このパラメーターはサポートされていません。 デフォルト値:false。 |
false |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。トークンにはASCII 文字のみを含めることができ、長さは64 文字を超えることはできません。詳細については、「べき等性の確保方法」をご参照ください。 |
123e4567-e89b-12d3-a456-42665544**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| ScalingActivityId |
string |
スケーリングアクティビティのID。 |
asa-bp1gbswjhjrw8tko**** |
| RequestId |
string |
リクエストID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
例
成功レスポンス
JSONJSON
{
"ScalingActivityId": "asa-bp1gbswjhjrw8tko****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。