添加云主机网卡到负载均衡器(AddVmNicToLoadBalancer)

API请求

URLs

POST zstack/v1/load-balancers/listeners/{listenerUuid}/vm-instances/nics

Headers

Authorization: OAuth the-session-uuid

Body

{
"params": {
"vmNicUuids": [
"aadbfdd8413545d9a1d53d8a0cfa58a8"
    ]
  },
"systemTags": [],
"userTags": []
}

上述示例中systemTags、userTags字段可以省略。列出是为了表示body中可以包含这两个字段。

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth 47ac995879a9490f83b6b6ef79bca99f" \
-X POST -d '{"params":{"vmNicUuids":["f141d926d13b34cc905507ce7aa9a479"]}}' \
http://localhost:8080/zstack/v1/load-balancers/listeners/21e488793c5831a0842d72a63bcdaf04/vm-instances/nics

参数列表

名字	类型	位置	描述	起始版本
vmNicUuids	List	body(包含在params结构中)	云主机网卡UUID	0.6
listenerUuid	String	url	负载均衡监听器UUID	0.6
systemTags (可选)	List	body	系统标签	0.6
userTags (可选)	List	body	用户标签	0.6

Note:

ZStack Cloud添加云主机网卡到负载均衡器时支持设置后端server的权重，SystemTags增加balancerWeight选项。
- 选项格式为：balancerWeight::{nicUuid}::{weight}，其中weight为对应后端server的权重.范围:0~100的整数，默认为100。
- 例如：balancerWeight::{"c44007641c9040c6b2587e19b1b3e2b0"}::{100}

API返回

该API成功时返回一个空的JSON结构{}，出错时返回的JSON结构包含一个error字段，例如：

{
"error": {
"code": "SYS.1001",
"description": "A message or a operation timeout",
"details": "Create VM on KVM timeout after 300s"
    }
}

SDK示例

Java SDK

AddVmNicToLoadBalancerAction action = new AddVmNicToLoadBalancerAction();
action.vmNicUuids = asList("01741d3cc9d0422197b2176f3c977d52");
action.listenerUuid = "fd774b08700545ddaa5938fb2ccf4320";
action.sessionId = "ed5ea413b2354a94ac7b427528f88d26";
AddVmNicToLoadBalancerAction.Result res = action.call()

Python SDK

AddVmNicToLoadBalancerAction action = AddVmNicToLoadBalancerAction()
action.vmNicUuids = [9b08b7603be945d2928a08a0e8d1fc00]
action.listenerUuid = "874bcad239a645af8cd69ed267a48809"
action.sessionId = "a70b5f9862424ceb8ea8e2c7d679e0df"
AddVmNicToLoadBalancerAction.Result res = action.call()

上一篇获取云主机网卡(GetCandidateVmNicsForLoadBalancer)下一篇从负载均衡器移除云主机网卡(RemoveVmNicFromLoadBalancer)