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

Auto Scaling:AttachInstances

最終更新日:Sep 10, 2026

スケーリンググループにECSインスタンスを手動で追加します。

操作説明

操作説明

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

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

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

  • スケーリンググループに追加するECSインスタンスまたはElastic Container Instance(ECI)インスタンスには、以下の制限が適用されます。 - インスタンスはスケーリンググループと同じリージョンにある必要があります。 - インスタンスは実行中状態である必要があります。 - インスタンスは既に別のスケーリンググループに属していてはなりません。 - インスタンスの支払い方式は、サブスクリプション、従量課金、またはスポットインスタンスである必要があります。 - スケーリンググループにVswitchIDが指定されている場合、クラシックネットワークタイプのECSインスタンスまたはECIインスタンスはスケーリンググループに追加できません。別のVPC 内のECSインスタンスまたはECIインスタンスもスケーリンググループに追加できません。 - スケーリンググループにVswitchIDが指定されていない場合、VPCネットワークタイプのECSインスタンスまたはECIインスタンスはスケーリンググループに追加できません。

  • スケーリンググループに追加するマネージドインスタンスには、以下の制限が適用されます。

    • マネージドインスタンスはスケーリンググループと同じリージョンにある必要があります。

    • スケーリンググループに属していないマネージドインスタンスのみが、ECSタイプのスケーリンググループに追加できます。

    • マネージドインスタンスは、ライフサイクルフック、ロードバランシング関連付け、またはヘルスチェック機能をサポートしていません。

    • マネージドインスタンスがECSタイプのスケーリンググループに追加された後、スケーリンググループはマネージドインスタンスのライフサイクルを管理しません。

    • マネージドインスタンスは、スケーリンググループへの追加または削除を手動でのみ行うことができます。マネージドインスタンスは削除後もリリースされません。

  • この操作を呼び出す際には、以下の項目に注意してください。

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

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

    • この操作で指定されたインスタンス数と、スケーリンググループの現在のインスタンス数(合計キャパシティ)の合計が最大サイズ(MaxSize)を超える場合、呼び出しは失敗します。

    • この操作を呼び出して手動で追加されたECSインスタンス、ECIインスタンス、またはマネージドインスタンスは、スケーリンググループのアクティブなスケーリング設定に関連付けられません。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingGroupId

string

必須

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

asg-bp18p2yfxow2dloq****

Entrusted

boolean

任意

既存のインスタンスをスケーリンググループに手動で追加する際に、インスタンスのライフサイクルをスケーリンググループに委任するかどうかを指定します。有効な値:

  • true:インスタンスのライフサイクルはAuto Scalingによって管理され、スケーリンググループによって自動作成されたインスタンスと同様です。DetachInstances操作の呼び出しによって削除された場合を除き、スケーリンググループから削除されると自動的にリリースされます。

  • false:インスタンスのライフサイクルはスケーリンググループによって管理されません。スケーリンググループから削除されてもリリースされません。

説明

このパラメーターは、サブスクリプションインスタンス、マネージドインスタンス、またはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスではサポートされていません。

デフォルト値:false。

false

InstanceId

array

任意

追加するECSインスタンス、ECIインスタンス、マネージドインスタンス、またはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスのインスタンスID。Nの有効な値:1~20。

例:

  • 追加するECSインスタンスのインスタンスID:i-28wt4****

  • 追加するECIインスタンスのインスタンスID:eci-bp17gw49eu09yiwm****

  • 追加するマネージドインスタンスのインスタンスID:mi-2cx*****

  • スケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスを再起動するためのインスタンスID:i-2cd2f****

説明

1 回のリクエストで処理できるインスタンスの種類は1つのみです。

i-28wt4****

string

任意

追加するECSインスタンス、ECIインスタンス、マネージドインスタンス、またはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスのインスタンスID。Nの有効な値:1~20。

例:

  • 追加するECSインスタンスのインスタンスID:i-28wt4****

  • 追加するECIインスタンスのインスタンスID:eci-bp17gw49eu09yiwm****

  • 追加するマネージドインスタンスのインスタンスID:mi-2cx*****

  • スケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスを再起動するためのインスタンスID:i-2cd2f****

説明

1 回のリクエストで処理できるインスタンスの種類は1つのみです。

i-28wt4****

LoadBalancerWeight

array

任意

ロードバランシングインスタンスのバックエンドサーバーとしてのECSインスタンスまたはECIインスタンスの重み。

説明

このパラメーターは、マネージドインスタンスまたはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスではサポートされていません。

50

integer

任意

ロードバランシングインスタンスのバックエンドサーバーとしてのECSインスタンスまたはECIインスタンスの重み。Nの有効な値:1~20。このパラメーターの有効な値:1~100。

説明

マネージドインスタンスまたはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスについては、このパラメーターの設定はサポートされていません。

デフォルト値:50。

50

LifecycleHook

boolean

任意

インスタンスをスケーリンググループに追加する際に、スケールアウトライフサイクルフックをトリガーするかどうかを指定します。有効な値:

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

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

説明

このパラメーターは、マネージドインスタンスまたはスケーリンググループ内のエコノミーモード(停止済み)状態のインスタンスではサポートされていません。

デフォルト値:false。

false

RegionId

string

任意

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

cn-qingdao

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。

クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。トークンにはASCII 文字のみを含めることができ、64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。

123e4567-e89b-12d3-a456-42665544****

IgnoreInvalidInstance

boolean

任意

インスタンスのバッチをスケーリンググループに追加する際に、無効なインスタンスを無視するかどうかを指定します。有効な値:

  • true:インスタンスのバッチをスケーリンググループに追加する際に、無効なインスタンスは無視されます。無効なインスタンスが存在し、有効なインスタンスが正常に追加された場合、スケーリングアクティビティのステータスは「Warning」と表示されます。無効なインスタンスはスケーリングアクティビティの詳細で確認できます。

  • false:インスタンスのバッチをスケーリンググループに追加する際に、無効なインスタンスは無視されません。バッチ内に無効なインスタンスが存在する場合、リクエストはエラーを返します。

デフォルト値:false。

false

レスポンスフィールド

フィールド

説明

object

ScalingActivityId

string

スケーリングアクティビティのID。

asa-bp1crxor24s28xf1****

RequestId

string

リクエストID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

成功レスポンス

JSONJSON

{
  "ScalingActivityId": "asa-bp1crxor24s28xf1****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

500 InternalError The request processing has failed due to some unknown error, exception or failure.

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

変更履歴

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