调用DetachDBInstances移除一个或多个RDS实例_弹性伸缩(ESS)-阿里云帮助中心

如果您需要减少伸缩组内的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实例。