通過調用API AttachDBInstances為伸縮組添加一個或多個RDS實例,可實現根據您的需要隨時調整伸縮組內的RDS實例數量,增加您使用上的靈活性與實用性。
接口說明
向伸縮組添加RDS實例時需要滿足以下條件:
- RDS實例與伸縮組必須屬于同一賬號。
- RDS實例必須處于未鎖定狀態,關于鎖定策略,請參見RDS使用須知。
- RDS實例必須處于運行中狀態。
- 如果將伸縮組中已存在的RDS實例再次添加到伸縮組,則伸縮組內的RDS實例數量不會改變,但系統會嘗試把當前伸縮組內的ECS實例私網IP全部加入到RDS實例的IP白名單中。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | AttachDBInstances | 系統規定參數。取值:AttachDBInstances。 |
ScalingGroupId | String | 是 | asg-bp1avr6ensitts3w**** | 伸縮組的ID。 |
ForceAttach | Boolean | 否 | false | 當RDS實例添加到伸縮組時,是否把當前伸縮組內實例的私網IP全部添加到RDS實例IP白名單中。取值范圍:
默認值: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。 |
Type | String | 否 | RDS | 數據庫類型。取值范圍:
默認值: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。 |