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

Auto Scaling:AttachLoadBalancers

最終更新日:Sep 10, 2026

1 つ以上の負荷分散インスタンスを追加します。

操作説明

操作説明

負荷分散インスタンスをスケーリンググループに追加する場合、以下の条件を満たす必要があります:

  • 負荷分散インスタンスとスケーリンググループは、同じ Alibaba Cloud アカウントおよび同じリージョンに属している必要があります。

  • 負荷分散インスタンスは Running 状態である必要があります。

  • 負荷分散インスタンスには少なくとも 1 つのリスナーが構成されており、ヘルスチェックが有効になっている必要があります。

  • 負荷分散インスタンスとスケーリンググループの両方が VPC ネットワークタイプの場合、同じ VPC 内にある必要があります。

  • スケーリンググループが VPC ネットワークタイプで、負荷分散インスタンスがクラシックネットワークタイプであり、負荷分散インスタンスのバックエンドサーバーに VPC 接続インスタンスが含まれている場合、それらのインスタンスはスケーリンググループと同じ VPC 内にある必要があります。

  • スケーリンググループに関連付けられる負荷分散インスタンスの数はクォータ制限を超えることはできません。詳細については、使用制限 を参照してください。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingGroupId

string

必須

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

asg-bp1avr6ensitts3w****

ForceAttach

boolean

任意

スケーリンググループ内の既存のすべてのインスタンスを負荷分散 CLB(旧 SLB)インスタンスのバックエンドサーバーとして追加するかどうかを指定します。有効な値:

  • true: 負荷分散インスタンスがスケーリンググループに追加される際に、スケーリンググループ内の既存のすべてのインスタンスが負荷分散インスタンスのバックエンドサーバーとして追加されます。

    説明

    負荷分散インスタンスが既にスケーリンググループに追加されており、スケーリンググループ内のすべてのインスタンスをその負荷分散インスタンスのバックエンドサーバーとして追加したい場合は、ForceAttach パラメーターを true にセットして、負荷分散インスタンスを再度スケーリンググループに追加できます。

  • false: 負荷分散インスタンスがスケーリンググループに追加される際に、スケーリンググループ内の既存のインスタンスは負荷分散インスタンスのバックエンドサーバーとして追加されません。

デフォルト値: false。

false

ClientToken

string

任意

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

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

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

Async

boolean

任意

負荷分散 CLB(旧 SLB)インスタンスを追加する際に非同期呼び出しを使用するかどうかを指定します。非同期呼び出しは操作のトランザクション性を保証します。つまり、すべての操作が正常に実行されるか、1 つでも失敗した場合はすべての操作が効果を持ちません。非同期呼び出しを使用してください。

有効な値:

  • true: 非同期呼び出し。リクエストはスケーリングアクティビティの ID を返します。

  • false: 同期呼び出し。

デフォルト値: false。

false

LoadBalancer

array

任意

追加する負荷分散 CLB(旧 SLB)インスタンスの ID。N の有効な値: 1~5。

lb-2zeur05gfs****

string

任意

追加する負荷分散 CLB(旧 SLB)インスタンスの ID。N の有効な値: 1~5。

説明

一度にスケーリンググループに最大 5 つの負荷分散インスタンスを追加できます。

lb-2zeur05gfs****

LoadBalancerConfig

array<object>

任意

負荷分散 CLB(旧 SLB)構成リスト。

object

任意

負荷分散 CLB(旧 SLB)構成リスト。

LoadBalancerId

string

任意

負荷分散 CLB(旧 SLB)インスタンスの ID。

147b46d767c-cn-qingdao-cm5****

Weight

integer

任意

Auto Scaling がインスタンスを CLB サーバーグループに追加した後の、バックエンドサーバーとしての ECS インスタンスまたは Elastic コンテナインスタンスの重み。重みが大きいほど、インスタンスが受信するリクエストが多くなります。重みが 0 の場合、インスタンスはリクエストを受信しません。

有効な値: 0~100。

10

レスポンスフィールド

フィールド

説明

object

ScalingActivityId

string

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

この値は Async が true にセットされている場合にのみ返されます。 DescribeScalingActivities 操作を呼び出して、返されたスケーリングアクティビティ ID をクエリし、スケーリングアクティビティの実行ステータスを確認できます。

asa-bp140qd7mak8k63f****

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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