伸缩组：添加 RDS 实例

添加一个或多个 RDS 实例。

前提条件


由于存在使用限制，向伸缩组添加 RDS 实例时需要满足以下条件：

• RDS 实例与伸缩组必须属于同一账号。
• RDS 实例必须处于未锁定状态，关于锁定策略，请参考 RDS使用须知。
• RDS 实例必须处于运行中状态。
• 添加 RDS 实例后，RDS IP 白名单的 default 分组中包含的 IP 不能超过 1000 条，关于 IP 白名单，请参考 设置白名单。

说明：关于不同版本 RDS 的使用限制，请参考 RDS MySQL 版 使用限制、RDS SQL Server 版 使用限制、RDS PostgreSQL 版 使用限制和 RDS 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	账号下不存在指定的伸缩组。

[tr=rgb(239, 251, 255)][td]QuotaExceeded.RDS “RDS” quota exceeded.400伸缩组中 RDS 实例超出配额限制。 InvalidDBInstanceId.NotFoundThe specified value of parameter “%s” is not valid.400不存在指定的 RDS 实例。 IncorrectDBInstanceStatusThe current status of DB instance “%s” does not support this action.400当前 RDS 实例状态不支持该操作。 QuotaExceeded.DBInstanceSecurityIPSecurity IP quota exceeded in DB instance “%s”.400RDS 实例后端 IP 白名单个数超出配额。 InvalidInstanceIds.PrivateIpNotFoundCan not find all private ips of instances in specific scaling group.400无法获取组内 RDS 实例的私网 IP。