AttachVServerGroups
伸縮組關(guān)聯(lián)負(fù)載均衡實(shí)例(CLB)后,加入伸縮組的實(shí)例會自動添加為CLB實(shí)例的后端服務(wù)器,處理來自CLB實(shí)例轉(zhuǎn)發(fā)的訪問請求。當(dāng)需要將不同的請求轉(zhuǎn)發(fā)到不同的后端服務(wù)器上時(shí),或需要通過域名和URL進(jìn)行請求轉(zhuǎn)發(fā)時(shí),您可以調(diào)用API AttachVServerGroups來添加負(fù)載均衡實(shí)例下的一個(gè)或者多個(gè)虛擬服務(wù)器組,通過虛擬服務(wù)器組管理不同的后端服務(wù)器。
接口說明
- 向伸縮組添加虛擬服務(wù)器組時(shí)需要滿足以下條件:
- 負(fù)載均衡實(shí)例與伸縮組必須屬于同一賬號。
- 負(fù)載均衡實(shí)例與伸縮組必須處于同一地域。
- 負(fù)載均衡實(shí)例必須處于運(yùn)行中狀態(tài)。
- 負(fù)載均衡實(shí)例至少配置有一個(gè)監(jiān)聽且必須開啟健康檢查。
- 如果負(fù)載均衡實(shí)例與伸縮組的網(wǎng)絡(luò)類型均為VPC,必須處于同一VPC。
- 當(dāng)伸縮組的網(wǎng)絡(luò)類型為VPC,負(fù)載均衡實(shí)例的網(wǎng)絡(luò)類型為經(jīng)典網(wǎng)絡(luò)時(shí),如果虛擬服務(wù)器組包含VPC實(shí)例,該實(shí)例必須與伸縮組處于同一VPC。
- 待添加虛擬服務(wù)器組必須屬于對應(yīng)的負(fù)載均衡實(shí)例。
- 不超過伸縮組內(nèi)虛擬服務(wù)器組的限額,具體限額,請參見使用限制。
- 添加伸縮組內(nèi)虛擬服務(wù)器組時(shí),需要同時(shí)指定以下屬性:
- 負(fù)載均衡實(shí)例ID(LoadBalancerId)
- 虛擬服務(wù)器組ID(VServerGroupId)
-
虛擬服務(wù)器組端口號(Port)
說明 如果通過不同的端口號將同一虛擬服務(wù)器組添加至伸縮組,視為伸縮組內(nèi)添加了多個(gè)虛擬服務(wù)器組。如果請求參數(shù)中的虛擬服務(wù)器組ID和端口號同時(shí)重復(fù),默認(rèn)使用最先配置的一組,忽略其余虛擬服務(wù)器組。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | AttachVServerGroups | 系統(tǒng)規(guī)定參數(shù)。取值:AttachVServerGroups。 |
RegionId | String | 是 | cn-hangzhou | 伸縮組所屬地域的ID,如cn-hangzhou、cn-shanghai,更多信息,請參見地域和可用區(qū)。 |
ScalingGroupId | String | 是 | asg-bp18p2yfxow2dloq**** | 伸縮組的ID。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保證請求冪等性。 從您的客戶端生成一個(gè)參數(shù)值,確保不同請求間該參數(shù)值唯一。只支持ASCII字符,且不能超過64個(gè)字符。更多信息,請參見如何保證冪等性。 |
ForceAttach | Boolean | 否 | false | 是否將當(dāng)前伸縮組內(nèi)的ECS實(shí)例或ECI實(shí)例添加到新增的虛擬服務(wù)器組。
默認(rèn)值:false。 |
VServerGroup.N.VServerGroupAttribute.N.VServerGroupId | String | 否 | rsp-bp1jp1rge**** | 虛擬服務(wù)器組的ID。其中:
|
VServerGroup.N.VServerGroupAttribute.N.Weight | Integer | 否 | 100 | 彈性伸縮將ECS實(shí)例或ECI實(shí)例添加到虛擬服務(wù)器組時(shí)設(shè)置的權(quán)重,取值范圍:0~100。其中:
默認(rèn)值:50。 |
VServerGroup.N.VServerGroupAttribute.N.Port | Integer | 否 | 22 | 彈性伸縮將ECS實(shí)例或ECI實(shí)例添加到虛擬服務(wù)器組時(shí)使用的端口號,取值范圍:1~65535。其中:
|
VServerGroup.N.LoadBalancerId | String | 否 | lb-bp1u7etiogg38yvwz**** | 虛擬服務(wù)器組所屬負(fù)載均衡實(shí)例的ID。N為負(fù)載均衡實(shí)例編號,取值范圍:1~5。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 請求ID。 |
示例
請求示例
http(s)://ess.aliyuncs.com/?Action=AttachVServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceAttach=false
&VServerGroup=[{"VServerGroupAttribute":[{"VServerGroupId":"rsp-bp1jp1rge****","Weight":100,"Port":22}],"LoadBalancerId":"lb-bp1u7etiogg38yvwz****"}]
&公共請求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<AttachVServerGroupsResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachVServerGroupsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
403 |
Forbidden.Unauthorized |
A required authorization for the specified action is not supplied. |
您未授予彈性伸縮完整的OpenAPI調(diào)用權(quán)限。 |
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
賬號下不存在指定的伸縮組。 |
404 |
InvalidLoadBalancerId.NotFound |
The load balancer "%s" does not exist. |
賬號下不存在指定的負(fù)載均衡實(shí)例。 |
400 |
InvalidLoadBalancerId.RegionMismatch |
The load balancer "%s" and the specified scaling group are not in the same Region. |
負(fù)載均衡實(shí)例與伸縮組不在同一地域。 |
400 |
IncorrectLoadBalancerStatus |
The current status of the load balancer "%s" does not support this action. |
當(dāng)前負(fù)載均衡實(shí)例狀態(tài)不支持此操作。 |
400 |
IncorrectLoadBalancerHealthCheck |
The current health check type of the load balancer "%s" does not support this action. |
當(dāng)前負(fù)載均衡實(shí)例未開啟健康檢查。 |
400 |
InvalidLoadBalancerId.VPCMismatch |
The specified virtual switch and the instance in the load balancer "%s" are not in the same VPC. |
負(fù)載均衡實(shí)例與伸縮組不在同一VPC下。 |
400 |
InvalidVServerGroupId.ForLoadBalancer |
Invalid VServerGroupId For LoadBalancer "%s". |
VServerGroupId對應(yīng)的虛擬服務(wù)器組不屬于指定的負(fù)載均衡實(shí)例。 |
400 |
QuotaExceeded.VServerGroup |
VServerGroup quota exceeded in the specified scaling group. |
當(dāng)前伸縮組內(nèi)可配置的虛擬服務(wù)器組個(gè)數(shù)達(dá)到上限。 |