调用DetachDBInstances移除一个或多个RDS实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DetachDBInstances |
系统规定参数。取值:DetachDBInstances。 |
ScalingGroupId | String | 是 | asg-bp1igpak5ft1flyp**** |
伸缩组的ID。 |
ForceDetach | Boolean | 否 | false |
是否移除RDS实例IP白名单中属于伸缩组内实例的私网IP。取值范围:
默认值:false。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。 只支持ASCII字符,且不能超过64个字符。更多详情,请参见如何保证幂等性。 |
RegionId | String | 否 | cn-qingdao |
伸缩组所属的地域ID。 |
DBInstance.N | String | 是 | rm-bp12cy3**** |
RDS实例的ID,单次最多支持移除5个RDS实例。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求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
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetachDBInstancesResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachDBInstancesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
错误码
访问错误中心查看更多错误码。
HttpCode |
错误码 |
错误信息 |
描述 |
---|---|---|---|
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
账号下不存在指定的伸缩组。 |
400 |
InvalidDBInstanceId.NotFound |
DB instance "%s" does not exist. |
不存在指定的RDS实例。 |