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

Auto Scaling:RemoveInstances

最終更新日:Sep 10, 2026

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

操作説明

操作説明

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

    • スケーリンググループがアクティブ状態であること。

    • スケーリンググループでスケーリングアクティビティが実行されていないこと。

スケーリンググループでスケーリングアクティビティが実行されていない場合、この操作はクールダウン期間(DefaultCooldown)をバイパスして即座に実行できます。

  • ECSインスタンスがAuto Scalingによって自動的に作成された場合、または手動で追加されたがスケーリンググループに委託されている場合、スケーリンググループから削除されるときにECSインスタンスはエコノミーモードに入るか、リリースされます。

  • ECSインスタンスが手動で追加され、スケーリンググループに委託されていない場合、スケーリンググループから削除されてもECSインスタンスは停止またはリリースされません。

  • スケーリンググループの現在のインスタンス数(TotalCapacity)からこの操作で指定されたインスタンス数を引いた値がスケーリンググループの最小インスタンス数(MinSize)未満になる場合、呼び出しは失敗します。

正常なレスポンスは、Auto Scalingがリクエストを受け付けたことのみを示します。スケーリングアクティビティは実行可能ですが、正常なレスポンスはスケーリングアクティビティの成功を保証するものではありません。返されたScalingActivityIdに基づいて、スケーリングアクティビティの実行状態を確認できます。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ess:DetachInstances

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingGroupId

string

必須

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

asg-bp18p2yfxow2dloq****

RemovePolicy

string

任意

削除されるECSインスタンスに対して実行するアクション。有効な値:

  • recycle:ECSインスタンスがエコノミーモードに入ります。

    説明

    この値は、ScalingPolicyがrecycleに設定されている場合にのみ有効です。

  • release:ECSインスタンスがリリースされます。

    CreateScalingGroupのScalingPolicyパラメータはスケーリンググループの回収モードを指定しますが、インスタンス削除時の具体的なアクションはRemoveInstancesのRemovePolicyパラメータによって決定されます。例:

    • ScalingPolicyがrecycleに設定され、RemovePolicyがrecycleに設定されている場合、ECSインスタンスはエコノミーモードに入ります。

    • ScalingPolicyがrecycleに設定され、RemovePolicyがreleaseに設定されている場合、ECSインスタンスはリリースされます。

    • ScalingPolicyがreleaseに設定され、RemovePolicyがrecycleに設定されている場合、ECSインスタンスはリリースされます。

    • ScalingPolicyがreleaseに設定され、RemovePolicyがreleaseに設定されている場合、ECSインスタンスはリリースされます。

デフォルト値:release。

release

DecreaseDesiredCapacity

boolean

任意

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

  • true:ECSインスタンスがスケーリンググループから削除された後、期待インスタンス数が対応する数だけ減少します。

  • false:ECSインスタンスがスケーリンググループから削除された後、期待インスタンス数は変更されません。

デフォルト値:true。

true

IgnoreInvalidInstance

boolean

任意

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

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

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

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

    一括削除するインスタンスに無効なインスタンスが含まれている場合、エラーが返されます。

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

説明
  • デフォルトでは、このパラメータ値はスケーリンググループから継承されます。RemoveInstancesを呼び出す際にこの値をリセットすることもできます。

  • このパラメータは、RemovePolicyがreleaseに設定されているスケールインプロセスでのみ有効です。

  • このパラメータが指定されている場合、システムはインスタンスが停止するまでStopInstanceTimeout 期間待機します。タイムアウト期間が経過すると、インスタンスが停止しているかどうかに関係なく、スケールインプロセスが続行されます。

  • このパラメータが指定されていない場合、システムはインスタンスが停止するまで待機してからスケールインプロセスを続行します。インスタンスの停止に失敗した場合、スケールインプロセスはロールバックされ、スケールインは失敗します。

60

LifecycleHookContext

object

任意

ライフサイクルフックのコンテキスト情報。

DisableLifecycleHook

boolean

任意

スケーリングアクティビティのすべてのライフサイクルフックを無効にするかどうかを指定します。有効な値:

  • true:無効にする。

  • false:無効にしない。

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.

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

変更履歴

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