AttachDBInstances - Auto Scaling

通過調用API AttachDBInstances為伸縮組添加一個或多個RDS執行個體，可實現根據您的需要隨時調整伸縮組內的RDS執行個體數量，增加您使用上的靈活性與實用性。

介面說明

向伸縮組添加RDS執行個體時需要滿足以下條件：

RDS執行個體與伸縮組必須屬於同一帳號。
RDS執行個體必須處於未鎖定狀態，關於鎖定策略，請參見RDS使用須知。
RDS執行個體必須處於運行中狀態。
如果將伸縮組中已存在的RDS執行個體再次添加到伸縮組，則伸縮組內的RDS執行個體數量不會改變，但系統會嘗試把當前伸縮組內的ECS執行個體私網IP全部加入到RDS執行個體的IP白名單中。

說明添加RDS執行個體後，RDS IP白名單的default分組中包含的IP不能超過1000條。關於IP白名單，請參見設定白名單。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	AttachDBInstances	系統規定參數。取值：AttachDBInstances。
ScalingGroupId	String	是	asg-bp1avr6ensitts3w****	伸縮組的ID。
ForceAttach	Boolean	否	false	當RDS執行個體添加到伸縮組時，是否把當前伸縮組內執行個體的私網IP全部添加到RDS執行個體IP白名單中。取值範圍： true：添加。 false：不添加。預設值：false。
ClientToken	String	否	123e4567-e89b-12d3-a456-42665544****	保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援ASCII字元，且不能超過64個字元。更多詳情，請參見如何保證等冪性。
DBInstance.N	String	否	rm-bp12cy3****	RDS執行個體的ID，N的取值範圍：1~5。
RegionId	String	否	cn-qingdao	伸縮組所屬的地區ID。
AttachMode	String	否	SecurityIp	伸縮組與資料庫關聯方式。取值範圍： SecurityIp：修改IP白名單模式，通過將擴容執行個體自動添加到資料庫白名單（目前僅RDS資料庫支援）進行關聯。 SecurityGroup：安全性群組模式，通過將伸縮配置安全性群組添加至資料庫安全性群組白名單進行關聯，實現安全性群組下執行個體資料庫訪問。預設值：SecurityIp。
Type	String	否	RDS	資料庫類型。取值範圍： RDS。 Redis。 MongoDB。預設值：RDS。

返回資料

名稱	類型	樣本值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	請求ID。

樣本

請求樣本

http(s)://ess.aliyuncs.com/?Action=AttachDBInstances
&ScalingGroupId=asg-bp1avr6ensitts3w****
&ForceAttach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&DBInstance=["rm-bp12cy3****"]
&RegionId=cn-qingdao
&AttachMode=SecurityIp
&Type=RDS
&公用請求參數

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AttachDBInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachDBInstancesResponse>

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	QuotaExceeded.RDS	"RDS" quota exceeded.	伸縮組中RDS執行個體超出配額限制。
400	InvalidDBInstanceId.NotFound	The specified value of parameter "%s" is not valid.	不存在指定的RDS執行個體。
400	IncorrectDBInstanceStatus	The current status of DB instance "%s" does not support this action.	當前RDS執行個體狀態不支援該操作。
400	QuotaExceeded.DBInstanceSecurityIP	Security IP quota exceeded in DB instance "%s".	RDS執行個體後端IP白名單個數超出配額。
400	InvalidInstanceIds.PrivateIpNotFound	Can not find all private ips of instances in specific scaling group.	無法擷取組內執行個體的私網IP。