文档目录

添加云主机网卡到负载均衡器(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
  • 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

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