全部产品
Search

搜索本产品

    弹性伸缩：AttachDBInstances - 添加一个或多个RDS实例

    文档中心

    弹性伸缩：AttachDBInstances - 添加一个或多个RDS实例

    更新时间：Sep 10, 2026

    添加一个或多个RDS实例。

    接口说明

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

    • RDS 实例与伸缩组必须属于同一账号。

    • RDS 实例必须处于未锁定状态，关于锁定策略，请参见 RDS 使用须知。

    • RDS 实例必须处于运行中状态。

    • 如果将伸缩组中已存在的 RDS 实例再次添加到伸缩组，则伸缩组内的 RDS 实例数量不会改变，但系统会尝试把当前伸缩组内的 ECS 实例私网 IP 全部加入到 RDS 实例的 IP 白名单中。

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

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    授权信息

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

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用前面加 * 表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    ess:AttachDBInstancesupdate
    *ScalingGroup
    acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}
      无
    		无

    请求参数

    名称类型必填描述示例值
    ScalingGroupIdstring是

    伸缩组的 ID。

    		asg-bp1avr6ensitts3w****
    ForceAttachboolean否

    当 RDS 实例添加到伸缩组时，是否把当前伸缩组内实例的私网 IP 全部添加到 RDS 实例 IP 白名单中。取值范围：

    • true：添加。

    • false：不添加。

    默认值：false。

    		false
    ClientTokenstring否

    保证请求幂等性。

    从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持 ASCII 字符，且不能超过 64 个字符。更多详情，请参见如何保证幂等性。

    		123e4567-e89b-12d3-a456-42665544****
    DBInstancearray是

    RDS 实例的 ID，N 的取值范围：1~5。

    string是

    RDS 实例的 ID，N 的取值范围：1~5。

    		rm-bp12cy3****
    RegionIdstring否

    伸缩组所属的地域 ID。

    		cn-qingdao
    AttachModestring否

    伸缩组与数据库关联方式。取值范围：

    • SecurityIp：修改 IP 白名单模式，通过将扩容实例自动添加到数据库白名单（目前仅 RDS 数据库支持）进行关联。
    • SecurityGroup：安全组模式，通过将伸缩配置安全组添加至数据库安全组白名单进行关联，实现安全组下实例数据库访问。

    默认值：SecurityIp。

    		SecurityIp
    Typestring否

    数据库类型。取值范围：

    • RDS。
    • Redis。
    • MongoDB。

    默认值：RDS。

    		RDS

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

    		473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    示例

    正常返回示例

    JSON格式

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

    错误码

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

    变更历史

    变更时间变更内容概要操作
    2025-02-25OpenAPI 描述信息更新查看变更详情
    2024-04-23OpenAPI 入参发生变更查看变更详情
    HttpCode错误码错误信息描述
    404InvalidScalingGroupId.NotFoundThe specified scaling group does not exist.账号下不存在指定的伸缩组。
    400QuotaExceeded.RDS"RDS" quota exceeded.伸缩组中 RDS 实例超出配额限制。
    400InvalidDBInstanceId.NotFoundThe specified value of parameter "%s" is not valid.不存在指定的 RDS 实例。
    400IncorrectDBInstanceStatusThe current status of DB instance "%s" does not support this action.当前 RDS 实例状态不支持该操作。
    400QuotaExceeded.DBInstanceSecurityIPSecurity IP quota exceeded in DB instance "%s".RDS 实例后端 IP 白名单个数超出配额。
    400InvalidInstanceIds.PrivateIpNotFoundCan not find all private ips of instances in specific scaling group.无法获取组内实例的私网 IP。