如果您需要减少伸缩组内的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。取值范围：
默认值：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 | 伸缩组是否移除关联数据库时添加的安全组白名单。仅针对
默认值：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实例。 |