功能介紹
為某個(gè)后端 云服務(wù)器 組添加后端云服務(wù)器。當(dāng)后端云服務(wù)器組被監(jiān)聽(tīng)器使用后，訪問(wèn) 負(fù)載均衡 器的流量可以通過(guò)負(fù)載均衡算法分發(fā)到不同的后端云服務(wù)器上，分擔(dān)流量。
接口約束
屬于一個(gè)后端云服務(wù)器組的兩個(gè)后端云服務(wù)器不能有相同的address和protocol_port。
創(chuàng)建后端云服務(wù)器時(shí)指定的子網(wǎng)必須和負(fù)載均衡器的子網(wǎng)處在同一個(gè)VPC下。
ELB創(chuàng)建后端云服務(wù)器全局的流控是一分鐘200次。
調(diào)試
您可以在API Explorer中直接運(yùn)行調(diào)試該接口。
URI
POST /v2/{project_id}/elb/pools/{pool_id}/members
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
操作用戶的項(xiàng)目ID。 獲取方法詳見(jiàn)獲取項(xiàng)目ID。 |
|
pool_id |
是 |
String |
后端云服務(wù)器組id。 |
請(qǐng)求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
tenant_id |
否 |
String |
后端云服務(wù)器所在的項(xiàng)目ID。 獲取方法詳見(jiàn)獲取項(xiàng)目ID。 需要和token中的project_id一致。 支持的最大字符長(zhǎng)度：255 |
|
name |
否 |
String |
后端云服務(wù)器的名稱。默認(rèn)為空字符串。 支持的最大字符長(zhǎng)度：255 |
|
address |
是 |
String |
后端云服務(wù)器對(duì)應(yīng)的IP地址，該IP必須在subnet_id字段指定子網(wǎng)的網(wǎng)段中。 只能對(duì)應(yīng)主網(wǎng)卡的IP。 例如：192.168.3.11。 支持的最大字符長(zhǎng)度：64 |
|
protocol_port |
是 |
Integer |
后端協(xié)議的端口號(hào)，取值范圍[1，65535]。 |
|
subnet_id |
是 |
String |
后端云服務(wù)器所在的子網(wǎng)ID。 后端云服務(wù)器的address在該子網(wǎng)的網(wǎng)段中。 只支持指定IPv4的子網(wǎng)ID。暫不支持IPv6。 |
|
admin_state_up |
否 |
Boolean |
后端云服務(wù)器的管理狀態(tài)。 該字段為預(yù)留字段，暫未啟用。默認(rèn)為true。 |
|
weight |
否 |
Integer |
后端云服務(wù)器的權(quán)重，取值范圍[0，100]。 權(quán)重為0的后端不再接受新的請(qǐng)求。默認(rèn)為1。 |
響應(yīng)消息
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
id |
String |
后端云服務(wù)器的 ID。 說(shuō)明：
此處并非服務(wù)器的ID，而是ELB添加后端服務(wù)器之后自動(dòng)生成的member ID。 |
|
tenant_id |
String |
后端云服務(wù)器所在的項(xiàng)目ID。 支持的最大字符長(zhǎng)度：255 |
|
project_id |
String |
此參數(shù)和tenant_id參數(shù)含義一樣，均指后端云服務(wù)器所在的項(xiàng)目ID。 |
|
name |
String |
后端云服務(wù)器的名稱。 支持的最大字符長(zhǎng)度：255 |
|
address |
String |
后端云服務(wù)器對(duì)應(yīng)的IP地址，該IP必須在subnet_id字段指定子網(wǎng)的網(wǎng)段中，例如192.168.3.11。 只能對(duì)應(yīng)主網(wǎng)卡的IP。 支持的最大字符長(zhǎng)度：64 |
|
protocol_port |
Integer |
后端端口的協(xié)議號(hào)，取值范圍[1，65535]。 |
|
subnet_id |
String |
后端云服務(wù)器所在的子網(wǎng)ID。后端云服務(wù)器的IP地址在該子網(wǎng)的網(wǎng)段中。 不支持開(kāi)啟了ipv6的子網(wǎng)。 |
|
admin_state_up |
Boolean |
后端云服務(wù)器的管理狀態(tài)。 該字段為預(yù)留字段，暫未啟用。取值范圍：true/false。
|
|
weight |
Integer |
后端云服務(wù)器的權(quán)重，取值范圍[0，100]。 權(quán)重為0的后端不再接受新的請(qǐng)求。默認(rèn)為1。 |
|
operating_status |
String |
后端云服務(wù)器的健康狀態(tài)，取值：
|
請(qǐng)求示例
- 添加云服務(wù)器請(qǐng)求樣例
可以查詢?cè)品?wù)器所屬負(fù)載均衡器的vip_subnet_id及彈性云服務(wù)器的 ip地址 ，得到subnet_id、ip_address；
或根據(jù)彈性云服務(wù)器id查詢對(duì)應(yīng)的subnet_id和address(GET https://{VPCEndpoint}/v2.0/ports?device_id={device_id})，其中device_id為彈性云服務(wù)器的id。取響應(yīng)體中主網(wǎng)卡（primary_interface為true的port）的subnet_id、ip_address。POST https://{Endpoint}/v2/145483a5107745e9b3d80f956713e6a3/elb/pools/5a9a3e9e-d1aa-448e-af37-a70171f2a332/members { "member": { "subnet_id": "33d8b01a-bbe6-41f4-bc45-78a1d284d503", "protocol_port": 88, "name": "member-jy-tt-1", "address": "192.168.44.11" } }
響應(yīng)示例
- 響應(yīng)樣例
{ "member": { "name": "member-jy-tt-1", "weight": 1, "admin_state_up": true, "subnet_id": "33d8b01a-bbe6-41f4-bc45-78a1d284d503", "tenant_id": "145483a5107745e9b3d80f956713e6a3", "project_id": "145483a5107745e9b3d80f956713e6a3", "address": "192.168.44.11", "protocol_port": 88, "operating_status": "ONLINE", "id": "c0042496-e220-44f6-914b-e6ca33bab503" } }
返回碼
請(qǐng)參見(jiàn)狀態(tài)碼。
