查询负载均衡器状态树
功能介绍
查询负载均衡器状态树,包括负载均衡器及其关联的子资源的状态信息。 注意:该接口中的operating_status不一定与对应资源的operating_status相同。 如:当Member的admin_state_up=false且operating_status=OFFLINE时, 该接口返回member的operating_status=DISABLE。
调用方法
请参见如何调用API。
URI
GET /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/statuses
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
loadbalancer_id |
是 |
String |
负载均衡器ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
IAM鉴权Token。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
statuses |
LoadBalancerStatusResult object |
负载均衡器状态树信息。 |
request_id |
String |
请求ID。 注:自动生成 。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
负载均衡器名称。 最小长度:1 最大长度:255 |
provisioning_status |
String |
负载均衡器的配置状态。 取值:
|
listeners |
Array of LoadBalancerStatusListener objects |
负载均衡器关联的监听器列表。 |
pools |
Array of LoadBalancerStatusPool objects |
负载均衡器关联的后端云服务器组列表。 |
id |
String |
负载均衡器ID。 |
operating_status |
String |
负载均衡器的操作状态。 取值:
说明:DEGRADED和DISABLED状态仅在当前接口中返回,LB详情等其他接口不返回这两个状态值。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
监听器的名称。 最小长度:1 最大长度:255 |
provisioning_status |
String |
监听器的配置状态。 取值:
|
pools |
Array of LoadBalancerStatusPool objects |
监听器下的后端主机组操作状态。 |
l7policies |
Array of LoadBalancerStatusPolicy objects |
监听器下的7层转发策略操作状态。 |
id |
String |
监听器ID。 |
operating_status |
String |
监听器的操作状态。 取值:
说明: DEGRADED和DISABLED状态仅在当前接口返回,查询监听器详情等其他接口返回字段operating_status不存在这两个状态值。 |
参数 |
参数类型 |
描述 |
---|---|---|
action |
String |
匹配后动作。 取值:
|
id |
String |
转发策略ID。 |
provisioning_status |
String |
转发策略的配置状态。 取值范围:
|
name |
String |
转发策略名称。 最小长度:1 最大长度:255 |
rules |
Array of LoadBalancerStatusL7Rule objects |
转发规则状态信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
L7转发规则ID。 |
type |
String |
匹配内容类型。 取值:
使用说明: 同一个l7policy下创建的所有的l7rule的HOST_NAME不能重复。 |
provisioning_status |
String |
转发规则的配置状态。 取值:
|
参数 |
参数类型 |
描述 |
---|---|---|
provisioning_status |
String |
后端服务器组的配置状态。 取值:
|
name |
String |
后端服务器组名。 最小长度:1 最大长度:255 |
healthmonitor |
LB状态树的后端服务器组健康检查器状态信息。 |
|
members |
Array of LoadBalancerStatusMember objects |
后端服务器状态信息。 |
id |
String |
后端服务器组ID。 |
operating_status |
String |
后端服务器组的操作状态。 取值:
说明: DEGRADED和DISABLED仅在当前接口返回, 查询后端服务器组详情等其他接口返回的operating_status字段不存在这两个状态值。 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
协议类型。取值:TCP、UDP_CONNECT或HTTP。 |
id |
String |
健康检查器ID。 |
name |
String |
健康检查器名称。 最小长度:1 最大长度:255 |
provisioning_status |
String |
健康检查器的配置状态。取值:ACTIVE表示使用中。 |
参数 |
参数类型 |
描述 |
---|---|---|
provisioning_status |
String |
后端服务器配置状态。取值:ACTIVE表示使用中。 |
address |
String |
后端服务器的IP地址。 |
protocol_port |
Integer |
后端服务器的端口号。取值范围[1, 65535]。 |
id |
String |
后端服务器ID。 |
operating_status |
String |
后端服务器的操作状态。 取值:
|
请求示例
查询负载均衡器的状态树
GET https://{ELB_Endpoint}/v3/{project_id}/elb/loadbalancers/38278031-cfca-44be-81be-a412f618773b/statuses
响应示例
状态码: 200
操作成功正常返回。
{ "statuses" : { "loadbalancer" : { "name" : "lb-jy", "provisioning_status" : "ACTIVE", "listeners" : [ { "name" : "listener-jy-1", "provisioning_status" : "ACTIVE", "pools" : [ { "name" : "pool-jy-1", "provisioning_status" : "ACTIVE", "healthmonitor" : { "type" : "TCP", "id" : "7422b51a-0ed2-4702-9429-4f88349276c6", "name" : "", "provisioning_status" : "ACTIVE" }, "members" : [ { "protocol_port" : 80, "address" : "192.168.44.11", "id" : "7bbf7151-0dce-4087-b316-06c7fa17b894", "operating_status" : "ONLINE", "provisioning_status" : "ACTIVE" } ], "id" : "c54b3286-2349-4c5c-ade1-e6bb0b26ad18", "operating_status" : "ONLINE" } ], "l7policies" : [ ], "id" : "eb84c5b4-9bc5-4bee-939d-3900fb05dc7b", "operating_status" : "ONLINE" } ], "pools" : [ { "name" : "pool-jy-1", "provisioning_status" : "ACTIVE", "healthmonitor" : { "type" : "TCP", "id" : "7422b51a-0ed2-4702-9429-4f88349276c6", "name" : "", "provisioning_status" : "ACTIVE" }, "members" : [ { "protocol_port" : 80, "address" : "192.168.44.11", "id" : "7bbf7151-0dce-4087-b316-06c7fa17b894", "operating_status" : "ONLINE", "provisioning_status" : "ACTIVE" } ], "id" : "c54b3286-2349-4c5c-ade1-e6bb0b26ad18", "operating_status" : "ONLINE" } ], "id" : "38278031-cfca-44be-81be-a412f618773b", "operating_status" : "ONLINE" } } }
状态码
状态码 |
描述 |
---|---|
200 |
操作成功正常返回。 |
错误码
请参见错误码。