查询指定监听器和后端服务器组中的后端服务器状态(GetLoadBalancerListenerBackendServers)

API请求

URLs

GET zstack/v1/load-balancers/listeners/{listenerUuid}/servergroups/{serverGroupUuid}/backendservers

Headers

Authorization: OAuth the-session-uuid

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X GET \
http://localhost:8080/zstack/v1/load-balancers/listeners/eff3eff582263d3c86a13819cd2b5d18/servergroups/9aaca80649283a739a83d41ecc8a38fb/backendservers

参数列表

名字	类型	位置	描述	起始版本
listenerUuid	String	url	负载均衡监听器UUID	5.5.38
serverGroupUuid	String	url	后端服务器组UUID	5.5.38
systemTags (可选)	List	query	系统标签	5.5.38
userTags (可选)	List	query	用户标签	5.5.38

API返回

返回示例

{
  "inventories": [
    {
      "listenerUuid": "40e47fa21a763ced90e7926e2a67ec9f",
      "serverGroupUuid": "a20be0947e533b638549364fdd67c2af",
      "backendType": "VmNic",
      "vmNicUuid": "00278a9dd20139e798165db238bcaa82",
      "ipAddress": "192.168.0.10",
      "weight": 100,
      "state": "Enabled",
      "runtimeStatus": "Active",
      "healthStatus": "Unknown",
      "instancePort": 8080
    }
  ]
}

名字	类型	描述	起始版本
success	boolean	操作是否成功	5.5.38
error	ErrorCode	错误码，若不为null，则表示操作失败，操作成功时该字段为null。详情参考error	5.5.38
inventories	List	详情参考inventories	5.5.38

#inventories

名字	类型	描述	起始版本
listenerUuid	String	负载均衡监听器UUID	5.5.38
serverGroupUuid	String	后端服务器组UUID	5.5.38
backendType	String	后端服务器类型，取值为VmNic或ServerIp	5.5.38
vmNicUuid	String	云主机网卡UUID	5.5.38
serverIp	String	IP类型后端服务器的配置地址	5.5.38
ipAddress	String	后端服务器的实际IP地址	5.5.38
weight	Long	后端服务器权重	5.5.38
state	String	后端服务器管理态	5.5.38
runtimeStatus	String	后端服务器运行态	5.5.38
healthStatus	String	后端服务器健康状态	5.5.38
instancePort	Integer	后端服务器端口	5.5.38

#error

名字	类型	描述	起始版本
code	String	错误码号，错误的全局唯一标识，例如 SYS.1000、HOST.1001	5.3.20
description	String	错误的概要描述	5.3.20
details	String	错误的详细信息	5.3.20
elaboration	String	保留字段，默认为null	5.3.20
opaque	LinkedHashMap	保留字段，默认为null	5.3.20
cause	ErrorCode	根错误，引发当前错误的源错误，若无原错误，该字段为null	5.3.20

SDK示例

Java SDK

GetLoadBalancerListenerBackendServersAction action = new GetLoadBalancerListenerBackendServersAction();
action.listenerUuid = "eff3eff582263d3c86a13819cd2b5d18";
action.serverGroupUuid = "9aaca80649283a739a83d41ecc8a38fb";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
GetLoadBalancerListenerBackendServersAction.Result res = action.call();

Python SDK

action = GetLoadBalancerListenerBackendServersAction()
action.listenerUuid = "eff3eff582263d3c86a13819cd2b5d18"
action.serverGroupUuid = "9aaca80649283a739a83d41ecc8a38fb"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
res = action.call()

上一篇修改负载均衡监听器下后端服务器的启用状态。仅支持由 openEuler VPC 路由器提供的负载均衡和 openEuler 性能独享型负载均衡（独立 SLB），不支持 VyOS。(ChangeLoadBalancerListenerBackendServerState)下一篇查询负载均衡服务器组的后端服务器列表，支持按服务器名称模糊搜索、启用状态过滤以及按服务器名称等字段排序，名称与 IP 由后端关联云主机信息后返回(GetLoadBalancerServerGroupBackendServer)