DetachVServerGroups - Auto Scaling

伸縮組支援關聯Server Load Balancer執行個體，可以有效增強伸縮組的服務能力。如果您的業務暫不需要通過Server Load Balancer執行個體將訪問流量分發到伸縮組內的多個執行個體中去，您可以調用API DetachVServerGroups移除一個或者多個虛擬伺服器組。

介面說明

確定待移除的虛擬伺服器組時，需要同時指定以下參數：
- Server Load Balancer執行個體ID（LoadBalancerId）
- 虛擬伺服器組ID（VServerGroupId）
- 虛擬伺服器組連接埠號碼（Port）
如果請求參數中的虛擬伺服器組與伸縮組中的虛擬伺服器組相匹配，則移除該虛擬伺服器組。如果未能匹配，則忽略移除請求，且介面不報錯。
如果移除伸縮組的Server Load Balancer執行個體時，您需要確認該Server Load Balancer執行個體不再向伸縮組內執行個體分發請求，避免造成服務要求丟失的情況。

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	DetachVServerGroups	系統規定參數。取值：DetachVServerGroups。
RegionId	String	是	cn-hangzhou	伸縮組所屬地區的ID，例如`cn-hangzhou`、`cn-shanghai`。更多資訊，請參見地區和可用性區域。
ScalingGroupId	String	是	asg-bp1fo0dbtsbmqa9h****	伸縮組的ID。
ClientToken	String	否	123e4567-e89b-12d3-a456-42665544****	保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援ASCII字元，且不能超過64個字元。更多資訊，請參見如何保證等冪性。
ForceDetach	Boolean	否	false	是否從待移除虛擬伺服器組中移除當前伸縮組內的執行個體。 true：移除。如果該參數取值為`true`，則從伸縮組中移除Server Load Balancer執行個體時，系統會將Server Load Balancer執行個體後端伺服器上與伸縮組關聯的執行個體移除。 false：不移除。如果該參數取值為`false`，則從伸縮組中移除Server Load Balancer執行個體時，系統不會從Server Load Balancer執行個體後端伺服器上移除與伸縮組關聯的執行個體。預設值：false。
VServerGroup.N.VServerGroupAttribute.N.VServerGroupId	String	否	rsp-bp1jp1rge****	虛擬伺服器組ID。其中：第一個N為Server Load Balancer執行個體編號，取值範圍：1~5。第二個N為Server Load Balancer執行個體下虛擬伺服器組的編號，取值範圍：1~5。
VServerGroup.N.VServerGroupAttribute.N.Port	Integer	否	22	Auto Scaling將ECS執行個體或ECI執行個體添加到虛擬伺服器組時使用的連接埠號碼，取值範圍：1~65535。其中：第一個N為Server Load Balancer執行個體編號，取值範圍：1~5。第二個N為Server Load Balancer執行個體下虛擬伺服器組的編號，取值範圍：1~5。
VServerGroup.N.LoadBalancerId	String	否	lb-bp1p90y3ya9h8s62d****	虛擬伺服器組所屬Server Load Balancer執行個體的ID。 N為Server Load Balancer執行個體編號，取值範圍：1~5。說明支援最多一次從伸縮組移除5個Server Load Balancer執行個體。

返回資料

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

樣本

請求樣本

http(s)://ess.aliyuncs.com/?Action=DetachVServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp1fo0dbtsbmqa9h****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceDetach=false
&VServerGroup=[{"VServerGroupAttribute":[{"VServerGroupId":"rsp-bp1jp1rge****","Port":22}],"LoadBalancerId":"lb-bp1p90y3ya9h8s62d****"}]
&公用請求參數

正常返回樣本

XML格式

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

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

JSON格式

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

HttpCode	錯誤碼	錯誤資訊	描述
403	Forbidden.Unauthorized	A required authorization for the specified action is not supplied.	您未授予Auto Scaling完整的OpenAPI調用許可權。
404	InvalidScalingGroupId.NotFound	The specified scaling group does not exist.	帳號下不存在指定的伸縮組。
400	InvalidParameter	The specified value of parameter "%s" is not valid.	參數值不合法。
400	MissingParameter	The input parameter "%s" that is mandatory for processing this request is not supplied.	缺少必要的參數。