AttachDBInstances - 添加一个或多个RDS实例-弹性伸缩(ESS)-阿里云帮助中心

接口说明

向伸缩组添加 RDS 实例时需要满足以下条件：

RDS 实例与伸缩组必须属于同一账号。
RDS 实例必须处于未锁定状态，关于锁定策略，请参见 RDS 使用须知。
RDS 实例必须处于运行中状态。
如果将伸缩组中已存在的 RDS 实例再次添加到伸缩组，则伸缩组内的 RDS 实例数量不会改变，但系统会尝试把当前伸缩组内的 ECS 实例私网 IP 全部加入到 RDS 实例的 IP 白名单中。

说明

添加 RDS 实例后，RDS IP 白名单的 default 分组中包含的 IP 不能超过 1000 条。关于 IP 白名单，请参见设置白名单。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

ess:AttachDBInstances

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

无

名称	类型	必填	描述	示例值
ScalingGroupId	string	是	伸缩组的 ID。	asg-bp1avr6ensitts3w****
ForceAttach	boolean	否	当 RDS 实例添加到伸缩组时，是否把当前伸缩组内实例的私网 IP 全部添加到 RDS 实例 IP 白名单中。取值范围： true：添加。 false：不添加。默认值：false。	false
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持 ASCII 字符，且不能超过 64 个字符。更多详情，请参见如何保证幂等性。	123e4567-e89b-12d3-a456-42665544****
DBInstance	array	是	RDS 实例的 ID，N 的取值范围：1~5。	rm-bp12cy3****
	string	否	RDS 实例的 ID，N 的取值范围：1~5。	rm-bp12cy3****
RegionId	string	否	伸缩组所属的地域 ID。	cn-qingdao
AttachMode	string	否	伸缩组与数据库关联方式。取值范围： SecurityIp：修改 IP 白名单模式，通过将扩容实例自动添加到数据库白名单（目前仅 RDS 数据库支持）进行关联。 SecurityGroup：安全组模式，通过将伸缩配置安全组添加至数据库安全组白名单进行关联，实现安全组下实例数据库访问。默认值：SecurityIp。	SecurityIp
Type	string	否	数据库类型。取值范围： RDS。 Redis。 MongoDB。默认值：RDS。	RDS

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

访问错误中心查看更多错误码。

更多信息，参考变更详情。