全部产品
Search
文档中心

弹性伸缩:DetachDBInstances

更新时间:Apr 25, 2024

如果您需要减少伸缩组内的RDS实例,可以通过调用API DetachDBInstance移除一个或多个RDS实例,来改变伸缩组与RDS实例的强行绑定关系,增加您使用上的灵活性与实用性。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DetachDBInstances

系统规定参数。取值:DetachDBInstances

ScalingGroupId String asg-bp1igpak5ft1flyp****

伸缩组的ID。

ForceDetach Boolean false

当RDS实例从伸缩组移除时,是否移除RDS实例IP白名单中属于伸缩组内实例的私网IP。取值范围:

  • true:移除。
  • false:不移除。

默认值:false。

ClientToken String 123e4567-e89b-12d3-a456-42665544****

保证请求幂等性。

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

DBInstance.N String rm-bp12cy3****

RDS实例的ID,单次最多支持移除5个RDS实例。

RegionId String cn-qingdao

伸缩组所属的地域ID。

RemoveSecurityGroup Boolean false

伸缩组是否移除关联数据库时添加的安全组白名单。仅针对AttachMode参数取值为SecurityGroup的数据库有效,取值范围:

  • true:会移除伸缩组关联数据库时添加的安全组ID。
  • false:不会移除伸缩组关联数据库时添加的安全组ID。

默认值:false。

返回数据

名称

类型

示例值

描述

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

请求ID。

示例

请求示例

http(s)://ess.aliyuncs.com/?Action=DetachDBInstances
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&ForceDetach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&DBInstance=["rm-bp12cy3****"]
&RegionId=cn-qingdao
&RemoveSecurityGroup=false
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DetachDBInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</DetachDBInstancesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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

HttpCode

错误码

错误信息

描述

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

账号下不存在指定的伸缩组。

400

InvalidDBInstanceId.NotFound

DB instance "%s" does not exist.

不存在指定的RDS实例。