如果當前彈性伸縮組關聯的負載均衡實例不能滿足您的需求或者您需要取消關聯,調用DetachLoadBalancers,通過指定伸縮組的ID、負載均衡實例的ID、ForceDetach等配置參數,移除一個或多個負載均衡 CLB(原 SLB)實例,同時可以選擇異步調用以及是否移除負載均衡實例后端服務器中屬于當前伸縮組的ECS實例。該接口僅支持移除負載均衡 CLB(原 SLB)實例。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DetachLoadBalancers | 系統規定參數。取值:DetachLoadBalancers。 |
ScalingGroupId | String | 是 | asg-bp1ffogfdauy0jw0**** | 伸縮組的ID。 |
ForceDetach | Boolean | 否 | false | 是否移除負載均衡實例后端服務器中屬于當前伸縮組的ECS實例。取值范圍:
默認值:false。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保證請求冪等性。從您的客戶端生成一個參數值,確保不同請求間該參數值唯一。 只支持ASCII字符,且不能超過64個字符。更多信息,請參見如何保證冪等性。 |
Async | Boolean | 否 | false | 移除負載均衡實例時,是否采用異步調用的方式。異步調用能保證操作的事務性,即所有操作都執行成功或者某個操作失敗時所有操作的執行結果都不生效,建議您采用異步調用。 取值范圍:
默認值:false。 |
LoadBalancer.N | String | 否 | lb-2zeur05gfs**** | 負載均衡實例的ID,單次最多支持移除5臺負載均衡實例。 |
RegionId | String | 否 | cn-qingdao | 伸縮組所屬的地域ID。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
ScalingActivityId | String | asa-bp140qd7mak8k63f**** | 伸縮活動的ID。 僅當 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 請求ID。 |
示例
請求示例
http(s)://ess.aliyuncs.com/?Action=DetachLoadBalancers
&ScalingGroupId=asg-bp1ffogfdauy0jw0****
&ForceDetach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Async=false
&LoadBalancer=["lb-2zeur05gfs****"]
&RegionId=cn-qingdao
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetachLoadBalancersResponse>
<ScalingActivityId>asa-bp140qd7mak8k63f****</ScalingActivityId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachLoadBalancersResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"ScalingActivityId" : "asa-bp140qd7mak8k63f****",
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
403 |
Forbidden.Unauthorized |
A required authorization for the specified action is not supplied. |
您并未授予彈性伸縮完整的OpenAPI調用權限。 |
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
賬號下不存在指定的伸縮組。 |
404 |
InvalidLoadBalancerId.NotFound |
The Load Balancer "%s" does not exist. |
伸縮組中不存在指定的負載均衡實例。 |