调用DetachDBInstances移除一个或多个RDS实例。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DetachDBInstances

系统规定参数。取值：DetachDBInstances
DBInstance.N RepeatList 是 rm-bp12cy3****

RDS实例的ID，单次最多支持移除5个RDS实例。
ScalingGroupId String 是 asg-bp1igpak5ft1flyp****

伸缩组的ID。
ForceDetach Boolean 否 false

是否移除RDS实例IP白名单中属于伸缩组内实例的私网IP，取值范围：

  • true：移除实例的私网IP。
  • false：不移除实例的私网IP。

默认值：false
ClientToken String 否 123e4567-e89b-12d3-a456-42665544****

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

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ess.aliyuncs.com/?Action=DetachDBInstances
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&DBInstance.1=rm-bp12cy3****
&<公共请求参数>

正常返回示例

XML 格式 

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

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实例。