开发者社区 问答 正文

伸缩组:添加 RDS 实例



添加一个或多个 RDS 实例。

前提条件


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

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

说明:关于不同版本 RDS 的使用限制,请参考 RDS MySQL 版 使用限制、RDS SQL Server 版 使用限制、RDS PostgreSQL 版 使用限制和 RDS PPAS 版 使用限制


请求参数

名称类型是否必需描述
ActionString操作接口名,系统规定参数,取值:AttachDBInstances。
ScalingGroupIdString伸缩组 Id。
DBInstance.NStringRDS 实例 Id,单次最多支持添加 5 个 RDS 实例。
ForceAttachBoolean是否把当前伸缩组内实例的私网 IP 全部添加到 RDS 实例 IP 白名单中:
  • true:添加
  • false:不添加
默认值:false。


返回参数

名称类型描述
RequestIdString请求 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.NotFoundThe 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。

展开
收起
青蛙跳 2018-08-17 13:39:21 1083 分享 版权
阿里云 AI 助理回答

在阿里云环境中,向伸缩组添加一个或多个RDS实例的操作需遵循以下步骤和注意事项:

操作步骤

  1. 确认前提条件

    • 确保RDS实例与目标伸缩组属于同一阿里云账号。
    • 确认RDS实例状态为运行中且未被锁定。
    • 了解并确保RDS IP白名单的default分组中的IP数量在操作后不会超过1000条限制。
    • 查阅相关RDS版本的具体使用限制,如RDS MySQL版、SQL Server版、PostgreSQL版或PPAS版的特定要求。
  2. 准备API请求参数

    • Action: 必填,设置为AttachDBInstances
    • ScalingGroupId: 必填,指定伸缩组的ID。
    • DBInstance.N: 必填,RDS实例ID数组,单次请求最多可添加5个实例,用序号N标记,如DBInstance.1, DBInstance.2等。
    • ForceAttach: 可选,是否自动将当前伸缩组内所有ECS实例的私网IP加入到RDS实例的IP白名单中。取值为true表示添加,false表示不添加,默认为false
  3. 构造并发送API请求

    • 根据阿里云OpenAPI规范,构建HTTP请求,例如:http://ess.aliyuncs.com/?Action=AttachDBInstances&ScalingGroupId=YOUR_SCALING_GROUP_ID&DBInstance.1=YOUR_RDS_INSTANCE_ID1&ForceAttach=true
    • 可以通过阿里云提供的OpenAPI Explorer工具简化此过程,该工具能自动生成签名并执行API调用,无需手动计算签名。
  4. 处理返回结果

    • 成功响应将包含一个RequestId字段,用于标识本次请求。

注意事项

  • 在执行此操作前,请确保已阅读并理解RDS实例与伸缩组关联的条件限制,避免操作失败。
  • 考虑到IP白名单的限制,如果伸缩组规模较大,需要预先规划好RDS实例的访问控制策略。
  • 对于不同数据库引擎的RDS实例,务必查阅其特定版本的使用限制文档,以免配置不当影响服务。

通过上述步骤,您可以有效地将RDS实例添加至指定的伸缩组中,实现资源的动态扩展与管理。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答