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

:Attach RDS Instances

最終更新日:Mar 18, 2020

1 つまたは複数の RDS インスタンスをアタッチします。

前提条件

使用制限により、スケーリンググループに RDS インスタンスをアタッチするときは、次の条件を満たす必要があります。

  • RDS インスタンスとスケーリンググループは、同じアカウントに属している必要があります。
  • RDS インスタンスはアンロックでなければなりません。ロックポリシーについては、RDS の使用方法をご参照ください。
  • RDS インスタンスのステータスは実行中でなければなりません。
  • RDS インスタンスをアタッチした後、RDS IP ホワイトリストで default グループの IP アドレスの数は 1000 を超えることはできません。IP ホワイトリストについては、 ホワイトリストの設定をご参照ください。

注意:異なるバージョンの RDS の使用制限については、RDS for MySQL の使用制限、RDS for SQL Server の使用制限、RDS for PostgreSQL の使用制限および RDS for PPAS の使用制限をご参照ください。

リクエストパラメータ

名前 必須 説明
Action String はい 操作インタフェースの名前。システムパラメータの値はAttachDBInstancesです。
ScalingGroupId String はい スケールグループ ID。
DBInstance.N String はい RDS インスタンス ID、最大 5 つの RDS インスタンスを一回の操作でにアタッチできます。
ForceAttach Boolean いいえ 現在のスケーリンググループ内のインスタンスのすべてのプライベート IP アドレスを RDS インスタンスの IP ホワイトリストに追加するかどうかを指定します。
  • true:追加する
  • false:追加しない
デフォルト値:false

リターンパラメータ

名前 説明
RequestId String リクエストID。システムによって生成されます。

リクエストの例

  1. http://ess.aliyuncs.com/?Action=AttachDBInstances
  2. &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ
  3. &DBInstance.1=rm-bp12cy39261
  4. &<公共请求参数>

パブリックリクエストパラメータ

XML 形式

  1. <AttachDBInstancesResponse>
  2. <RequestId>DD0309B7-2613-4792-9B86-275906695253</RequestId>
  3. </AttachDBInstancesResponse>

JSON 形式

  1. {
  2. "RequestId": "DD0309B7-2613-4792-9B86-275906695253"
  3. }

エラーコード

すべてのインターフェイスの汎用エラーについては、クライアントエラー一覧またはサーバーエラー一覧をご参照ください。

エラーコード エラーメッセージ HTTPステータスコード 説明
InvalidScalingGroupId.NotFound The specified scaling group does not exist. 404 指定されたスケーリンググループがアカウントに存在しません。
QuotaExceeded.RDS “RDS” quota exceeded. 400 スケーリンググループの RDS インスタンスがクォータ制限を超えています。
InvalidDBInstanceId.NotFound The specified value of parameter “%s” is not valid. 400 指定された RDS インスタンスが存在しません。
IncorrectDBInstanceStatus The current status of DB instance “%s” does not support this action. 400 現在の RDS インスタンスのステータスはこの操作をサポートしていません。
QuotaExceeded.DBInstanceSecurityIP Security IP quota exceeded in DB instance “%s”. 400 RDS インスタンスバックエンド の IP ホワイトリストの数がクォータを超えています。
InvalidInstanceIds.PrivateIpNotFound Can not find all private ips of instances in specific scaling group. 400 グループ内の RDS インスタンスのプライベート IP を取得できません。