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

Auto Scaling:RemoveInstances

最終更新日:Oct 27, 2026

スケーリンググループから不要な 1 つ以上のインスタンスを削除します。スケーリンググループは有効状態であり、進行中のスケーリングアクティビティがない必要があります。

操作説明

操作の説明

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

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

    • スケーリンググループ内で実行する状態のスケーリングアクティビティがないこと。

スケーリンググループ内で実行する状態のスケーリングアクティビティがない場合、この操作はクールダウン時間 (DefaultCooldown) をバイパスし、直接実行する。

  • ECS インスタンスが Auto Scaling による自動作成で作成された場合、または手動で追加されスケーリンググループによって管理されている場合、スケーリンググループから ECS インスタンスを削除すると、その ECS インスタンスは節約モードをトリガーするか、リリースされます。

  • 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

*スケーリンググループ。

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: スケーリンググループからバッチでインスタンスを削除するときに、無効なインスタンスが無視されます。

    バッチに無効なインスタンスが存在し (たとえば、インスタンスステータスが Adding である場合)、有効なインスタンスの削除に成功した場合、スケーリングアクティビティの実行するステータスは 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 がリリースにセットされている場合のスケールインプロセスでのみ効果があります。

  • このパラメーターがセットされている場合、システムはインスタンスが停止するまで 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.

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

変更履歴

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