调用AttachDBInstances添加一个或多个RDS实例。
接口说明
向伸缩组添加RDS实例时需要满足以下条件：
- RDS实例与伸缩组必须属于同一账号。
- RDS实例必须处于未锁定状态，关于锁定策略，请参见RDS使用须知。
- RDS实例必须处于运行中状态。
添加RDS实例后，RDS IP白名单的default分组中包含的IP不能超过1000条。关于IP白名单，请参见设置白名单。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | AttachDBInstances | 系统规定参数。取值：AttachDBInstances |
| DBInstance.N | RepeatList | 是 | rm-bp12cy3**** | RDS实例的ID，N的取值范围：1~5。 |
| ScalingGroupId | String | 是 | asg-bp1avr6ensitts3w**** | 伸缩组的ID。 |
| ForceAttach | Boolean | 否 | false | 是否把当前伸缩组内实例的私网IP全部添加到RDS实例IP白名单中：
默认值：false |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持ASCII字符，且不能超过64个字符。更多详情，请参见如何保证幂等性。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | 请求ID。 |
示例
请求示例
https://ess.aliyuncs.com/?Action=AttachDBInstances &ScalingGroupId=asg-bp1avr6ensitts3w**** &DBInstance.1=rm-bp12cy3**** &<公共请求参数>
正常返回示例
XML 格式
<AttachDBInstancesResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</AttachDBInstancesResponse>
JSON 格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
错误码
访问错误中心查看更多错误码。
| HttpCode |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
账号下不存在指定的伸缩组。 |
| 400 |
QuotaExceeded.RDS |
"RDS" quota exceeded. |
伸缩组中RDS实例超出配额限制。 |
| 400 |
InvalidDBInstanceId.NotFound |
The specified value of parameter "%s" is not valid. |
不存在指定的RDS实例。 |
| 400 |
IncorrectDBInstanceStatus |
The current status of DB instance "%s" does not support this action. |
当前RDS实例状态不支持该操作。 |
| 400 |
QuotaExceeded.DBInstanceSecurityIP |
Security IP quota exceeded in DB instance "%s". |
RDS实例后端IP白名单个数超出配额。 |
| 400 |
InvalidInstanceIds.PrivateIpNotFound |
Can not find all private ips of instances in specific scaling group. |
无法获取组内RDS实例的私网IP。 |