DetachDBInstances - Auto Scaling

如果您需要減少伸縮組內的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執行個體。