ECS インスタンスのアタッチ
説明
指定したスケーリンググループに ECS インスタンスをアタッチします。アタッチする ECS インスタンスに関する制限は以下のとおりです。
- アタッチする ECS インスタンスとスケーリンググループが同じリージョンに存在する必要がある。
- アタッチする ECS インスタンスが Running ステータスでなければならない。
- アタッチする ECS インスタンスが他のスケーリンググループにアタッチされていない。
- アタッチする ECS インスタンスがサブスクリプションと従量課金の両方の課金方法に対応している。
- スケーリンググループで VswitchID が指定されている場合は、他の VPC のクラシック ECS インスタンスや ECS インスタンスをスケーリンググループにアタッチできない。
- スケーリンググループで VswitchID が指定されてない場合は、VPC タイプの ECS インスタンスをスケーリンググループにアタッチできない。
インターフェイスを呼び出すことができるのは、スケーリンググループがアクティブのときに限られます。
インターフェイスを呼び出すことができるのは、スケーリンググループに進行中のスケーリングアクティビティがないときに限られます。
スケーリンググループに進行中のスケーリングアクティビティがないときは、インターフェイスをクールダウンなしで直接実行できます。
このインターフェイスが正常に呼び出されても、呼び出しリクエストが受け入れられ、スケーリングアクティビティの実行が可能になるだけです。スケーリングアクティビティの実行が正常に終了するとは限りません。返された ScalingActivityId を使用して、スケーリングアクティビティのステータスを確認できます。
このインターフェイスで指定したインスタンスとスケーリンググループのインスタンスの合計容量が MaxSize を超えると、呼び出しの試みが失敗する場合があります。
手動でアタッチした ECS インスタンスは、スケーリンググループのアクティブなスケーリング設定に関連付けられません。
リクエストパラメーター
| 名前 | 型 | 必須かどうか | 説明 |
|---|---|---|---|
| Action | String | はい | 操作インターフェイス名、必須パラメーター。値: AttachInstances。 |
| ScalingGroupId | String | はい | スケーリンググループ ID。 |
| InstanceId.N | String | はい | ECS インスタンス ID。最大 20 個の ID を入力できます。 |
リターンパラメーター
| 名前 | 型 | 説明 |
|---|---|---|
| ScalingActivityId | String | スケーリングアクティビティ ID |
エラーコード
すべてのインターフェイスに共通のエラーについては、「クライアントエラー表」または「サーバーエラー表」を参照してください。
| エラー | エラーコード | 説明 | HTTP ステータスコード |
|---|---|---|---|
| 指定したスケーリンググループがこのアカウントに存在しません。 | InvalidScalingGroupId.NotFound | 指定したスケーリンググループが存在しません。 | 404 |
| Auto Scaling サービスに対して、OpenAPI は完全には許可されていません。 | Forbidden.Unauthorized | 指定したアクションに必要な許可が付与されていません。 | 403 |
| 指定したスケーリンググループがアクティブではありません。 | IncorrectScalingGroupStatus | 指定したスケーリンググループの現在のステータスでは、このアクションを実行できません。 | 400 |
| 指定した ECS インスタンスがこのアカウントに存在しません。 | InvalidInstanceId.NotFound | インスタンス “XXX” が存在しません。 | 404 |
| 指定した ECS インスタンスとスケーリンググループが同じリージョンにありません。 | InvalidInstanceId. RegionMismatch | インスタンス “XXX” と指定したスケーリンググループが同じリージョンにありません。 | 400 |
| 指定した ECS インスタンスと、スケーリング設定が有効なインスタンスが一致しません。 | InvalidInstanceId.InstanceTypeMismatch | インスタンス “XXX” と既存のアクティブなスケーリング設定のインスタンスタイプが異なります。 | 400 |
| 指定した ECS インスタンスが Running ステータスではありません。 | IncorrectInstanceStatus | インスタンス “XXX” の現在のステータスでは、このアクションを実行できません。 | 400 |
| 指定した ECS インスタンスとスケーリンググループが同じリージョンにありません。 | InvalidInstanceId. NetworkTypeMismatch | インスタンス “XXX” のネットワークタイプでは、このアクションを実行できません。 | 400 |
| 指定したスケーリンググループとアタッチした ECS インスタンスが同じ VPC にありません。 | InvalidInstanceId.VPCMismatch | インスタンス “XXX” と指定したスケーリンググループが同じ VPC にありません。 | 400 |
| 指定した ECS インスタンスは別のスケーリンググループにアタッチされています。 | InvalidInstanceId.InUse | インスタンス “XXX” は既に別のスケーリンググループにアタッチされています。 | 400 |
| 指定したスケーリンググループには、進行中のスケーリングアクティビティがあります。 | ScalingActivityInProgress | 指定したスケーリンググループに進行中のスケーリングアクティビティが存在している間は、スケーリンググループを削除することも、新しいスケーリングアクティビティを開始することもできません。 | 400 |
| 指定したスケーリンググループの Server Load Balancer インスタンスが active ステータスではありません。 | IncorrectLoadBalancerStatus | 指定した Load Balancer の現在のステータスでは、このアクションを実行できません。 | 400 |
| 指定したスケーリンググループの Server Load Balancer のヘルスチェックが有効になっていません。 | IncorrectLoadBalancerHealthCheck | 指定した Load Balancer の現在のヘルスチェックタイプでは、このアクションを実行できません。 | 400 |
| 指定した Server Load Balancer に含まれる ECS インスタンスのネットワークタイプが、スケーリンググループのネットワークタイプと異なります。 | InvalidLoadBalancerId.IncorrectInstanceNetworkType | 指定したロードバランサーのインスタンスのネットワークタイプでは、このアクションを実行できません。 | 400 |
| 指定した Server Load Balancer に含まれる ECS インスタンスと VSwitchId が同じ VPC にありません。 | InvalidLoadBalancerId.VPCMismatch | 指定した仮想スイッチと指定したロードバランサーのインスタンスが同じ VPC にありません。 | 400 |
| 指定したスケーリンググループの RDS インスタンスが Running ステータスではありません。 | IncorrectDBInstanceStatus | DB インスタンス “XXX” の現在のステータスでは、このアクションを実行できません。 | 400 |
| スケーリンググループの RDS インスタンスにアクセスできるホワイトリストの IP アドレスの数が上限を超えました。 | QuotaExceeded.DBInstanceSecurityIP | DB インスタンス “XXX” でセキュリティ IP のクォータを超過しました。 | 400 |
| 指定したセキュリティグループにアタッチされた ECS インスタンスの数が上限を超えました。 | QuotaExceeded.SecurityGroupInstance | 指定したセキュリティグループでインスタンスのクォータを超過しました。 | 400 |
| ECS インスタンスをアタッチした後の合計容量が MaxSize を超えています。 | IncorrectCapacity.MaxSize | インスタンスをアタッチすると、合計容量が MaxSize を超えます。 | 400 |
例
リクエストの例
http://ess.aliyuncs.com/?Action=AttachInstances&ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ&InstanceId.1=i-28wt48iaa&<Public Request Parameters>
戻り値の例
XML 形式:
<AttachInstancesResponse><ScalingActivityId>bybj9OcaOT4ucPMbFhcqHfA3</ScalingActivityId><RequestId>DD0309B7-2613-4792-9B86-275906695253</RequestId></AttachInstancesResponse>
JSON 形式:
"RequestId": "6469DCD0-13AC-487E-85A0-CE4922908FDE","ScalingActivityId": "ebta5WbUzC8gcwUWvfchyT4U"