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

Attach an ECS instance

最終更新日: Mar 18, 2020

説明

  • 指定したスケーリンググループに 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

リクエストの例
  1. http://ess.aliyuncs.com/?Action=AttachInstances
  2. &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ
  3. &InstanceId.1=i-28wt48iaa
  4. &<Public Request Parameters>
戻り値の例

XML 形式:

  1. <AttachInstancesResponse>
  2. <ScalingActivityId>bybj9OcaOT4ucPMbFhcqHfA3</ScalingActivityId>
  3. <RequestId>DD0309B7-2613-4792-9B86-275906695253</RequestId>
  4. </AttachInstancesResponse>

JSON 形式:

  1. "RequestId": "6469DCD0-13AC-487E-85A0-CE4922908FDE",
  2. "ScalingActivityId": "ebta5WbUzC8gcwUWvfchyT4U"