すべてのプロダクト
Search
ドキュメントセンター

Auto Scaling:DetachInstances

最終更新日:Sep 10, 2026

スケーリンググループから1つ以上のECSインスタンスを削除します。

操作説明

操作説明

  • この操作を呼び出す前に、以下の条件が満たされていることを確認してください:

    • スケーリンググループが有効状態であること。

    • スケーリンググループでスケーリングアクティビティが進行中でないこと。

      説明

      スケーリンググループでスケーリングアクティビティが進行中でない場合、この操作はクールダウン時間をバイパスして、直接スケーリングアクティビティをトリガーできます。

  • 以下の項目に注意してください:

    • ECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスがスケーリンググループから削除された後、そのインスタンスは独立して存在し続けます。 AttachInstances 操作を呼び出して、ECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスを別のスケーリンググループに追加できます。

    • この操作を呼び出してECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスを削除しても、インスタンスは停止またはリリースされません。

    • 操作が呼び出された後、Auto Scalingがリクエストを受け入れたことのみを示します。スケーリングアクティビティはトリガーされる可能性がありますが、スケーリングアクティビティの成功は保証されません。返されたScalingActivityIdに基づいて、スケーリングアクティビティのステータスを確認する必要があります。

    • スケーリンググループ内のECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスの数から削除されるインスタンスの数を引いた値が、スケーリンググループの最小インスタンス数(MinSize)を下回ることはできません。そうでない場合、エラーが返されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingGroupId

string

必須

スケーリンググループのID。

asg-bp1igpak5ft1flyp****

DecreaseDesiredCapacity

boolean

任意

インスタンスの期待数を変更するかどうかを指定します。有効な値:

  • true:ECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスがスケーリンググループから削除された後、インスタンスの期待数が対応する分だけ減少します。

  • false:ECSインスタンス、エラスティックコンテナインスタンス、またはマネージドインスタンスがスケーリンググループから削除された後、インスタンスの期待数は変更されません。

デフォルト値:true。

true

IgnoreInvalidInstance

boolean

任意

スケーリンググループからインスタンスを一括削除する際に、無効なインスタンスを無視するかどうかを指定します。有効な値:

  • true:スケーリンググループからインスタンスを一括削除する際に、無効なインスタンスが無視されます。

    一括削除対象のインスタンスに無効なインスタンス(例えば、インスタンスステータスがPendingのインスタンス)が含まれており、有効なインスタンスが正常に削除された場合、スケーリングアクティビティの実行ステータスはWarningと表示されます。無効なインスタンスはスケーリングアクティビティの詳細で確認できます。

  • false:スケーリンググループからインスタンスを一括削除する際に、無効なインスタンスは無視されません。

    一括削除対象のインスタンスに無効なインスタンス(例えば、インスタンスステータスがPendingのインスタンス)が含まれている場合、エラーが返されます。

デフォルト値: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。

例:

  • 削除するECSインスタンスのインスタンスIDはi-bp109k5j3dum1ce6****です。

  • 削除するエラスティックコンテナインスタンスのインスタンスIDはeci-bp17gw49eu09yiwm****です。

  • 削除するマネージドインスタンスのインスタンスIDはmi-d23fsd******です。

説明

1 回のリクエストで削除できるインスタンスタイプは1 種類のみです。

i-bp109k5j3dum1ce6****

LifecycleHook

boolean

任意

ECSインスタンスまたはエラスティックコンテナインスタンスをスケーリンググループから削除する際に、スケールインライフサイクルフックをトリガーするかどうかを指定します。有効な値:

  • true:ライフサイクルフックをトリガーします。

  • false:ライフサイクルフックをトリガーしません。

説明

マネージドインスタンスをスケーリンググループから削除する場合、このパラメーターはサポートされていません。

デフォルト値: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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。