1 つまたは複数の Server Load Balancer インスタンスをアタッチします。
前提条件
使用制限により、スケーリンググループに Server Load Balancer インスタンスをアタッチする場合、次の条件を満たす必要があります。
- Server Load Balancer インスタンスとスケーリンググループは、同じアカウントに属している必要があります。
- Server Load Balancer インスタンスとスケーリンググループは、同じリージョンに設置されている必要があります。
- Server Load Balancer インスタンスは
実行中
である必要があります。 - Server Load Balancer インスタンスには少なくとも 1 つのリスナーが設定されており、ヘルスチェックが有効になっている必要があります。
- Server Load Balancer インスタンスとスケーリンググループのネットワークタイプが VPC である場合、それらは同じ VPC に存在する必要があります。
- スケーリンググループのネットワークタイプが VPC で、 Server Load Balancer インスタンスのネットワークタイプがクラシックネットワークである場合、Server Load Balancer インスタンスのバックエンドサーバーにVPC インスタンスが含まれている場合、そのインスタンスはスケーリンググループと同じ VPC に属している必要があります。
- アタッチされる Server Load Balancer インスタンスの数は、スケーリンググループのインスタンスクォータ以内である必要があります。
リクエストパラメータ
名前 | 型 | 必須 | 説明 |
---|---|---|---|
Action | String | はい | 操作インターフェイス名、システムスペックパラメータです。値:AttachLoadBalancers 。 |
ScalingGroupId | String | はい | スケールグループ ID です。 |
LoadBalancer.N | String | はい | Server Load Balancer インスタンス ID です。最大 5 つのServer Load Balancer インスタンスを一回の操作でアタッチできます。 |
ForceAttach | Boolean | いいえ | 現在のスケーリンググループ内のすべてのインスタンスを Server Load Balancer バックエンドサーバーにアタッチするかどうかを指定します。
false 。 |
リターンパラメータ
名前 | 型 | 説明 |
---|---|---|
RequestId | String | リクエスト ID。システムによって生成されます。 |
例
リクエストの例
http://ess.aliyuncs.com/?Action=AttachLoadBalancers
&ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ
&LoadBalancer.1=lb-2zeur05gfsge6n
&<パブリックリクエストパラメータ>
戻り値の例
XML 形式
<AttachLoadBalancersResponse>
<RequestId>DD0309B7-2613-4792-9B86-275906695253</RequestId>
</AttachLoadBalancersResponse>
JSON 形式
{
"RequestId": "DD0309B7-2613-4792-9B86-275906695253"
}
エラーコード
すべてのインターフェイスの汎用エラーについては、クライアントエラー一覧 または サーバーエラー一覧をご参照ください。
エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
---|---|---|---|
Forbidden.Unauthorized | A required authorization for the specified action is not supplied. | 403 | Auto Scaling に Open API 呼び出しのフルコントロール権限を付与していません。 |
InvalidScalingGroupId.NotFound | The specified scaling group does not exist. | 404 | 指定されたスケーリンググループがアカウントに存在しません。 |
QuotaExceeded.LoadBalancer | LoadBalancer quota exceeded in the scaling group “%s”. | 400 | スケーリンググループの Server Load Balancer インスタンス数がクォータ制限を超えています。 |
InvalidLoadBalancerId.NotFound | The load balancer “%s” does not exist. | 404 | 指定された Server Load Balancer インスタンスが存在しません。 |
InvalidLoadBalancerId.RegionMismatch | The load balancer “%s” and the specified scaling group are not in the same Region. | 400 | Server Load Balancer インスタンスは、スケーリンググループと同じリージョンにありません。 |
IncorrectLoadBalancerStatus | The current status of the load balancer “%s” does not support this action. | 400 | この操作は、現在の Server Load Balancer インスタンスの状態ではサポートされていません。 |
IncorrectLoadBalancerHealthCheck | The current health check type of the load balancer “%s” does not support this action. | 400 | 現在の Server Load Balancer インスタンスでは、ヘルスチェックが有効になっていません。 |
InvalidLoadBalancerId.VPCMismatch | The specified virtual switch and the instance in the load balancer “%s” are not in the same VPC. | 400 | Server Load Balancer インスタンスは、スケーリンググループと同じ VPC にありません。 |
QuotaExceeded.BackendServer | Backend server quota exceeded in the load balancer “%s”. | 400 | Server Load Balancer インスタンスのバックエンドサーバーの数が制限を超えています。 |
InvalidScalingConfigurationId.NotFound | The specified scaling configuration does not exist. | 404 | 現在のスケーリンググループに有効にしたスケーリング設定が見つかりませんでした。 |