# 查询负载均衡状态树 - ShowLoadBalancerStatus #### 功能介绍 查询负载均衡器状态树。可通过该接口查询负载均衡器关联的监听器、后端云服务器组、后端云服务器、健康检查、转发策略、转发规则的主要信息，了解负载均衡器下资源的拓扑情况。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ELB&api=ShowLoadbalancersStatus&version=v2)中直接运行调试该接口。 #### URI GET /v2/{project_id}/elb/loadbalancers/{loadbalancer_id}/statuses 表1参数说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 操作用户的项目ID。 获取方法详见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 | | loadbalancer_id | 是 | String | 负载均衡器id。 | #### 请求消息 无 #### 响应消息 表2响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | statuses | [Statuses] object | 负载均衡器状态树。详见[表3]。 | 表3statuses字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | loadbalancer | [Loadbalancer] object | 负载均衡器对象。详见[表4]。 | 表4loadbalancer字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 负载均衡器ID。 | | name | String | 负载均衡器名称。 支持的最大字符长度：255 | | listeners | Array of [Listeners] objects | 负载均衡器关联的监听器列表。listeners对象参考[表5]。 | | pools | Array of [Pools] objects | 负载均衡器关联的后端服务器组列表。pools对象参考[表6]。 | | operating_status | String | 该字段为预留字段，目前暂未使用。 负载均衡器的操作状态。取值范围： - ONLINE：创建时的默认状态，表示负载均衡器正常。 - DEGRADED：该负载均衡器下存在l7policy或l7rule的Provisioning_status为ERROR时返回此状态。注意该状态仅在当前接口中返回。 - DISABLED：负载均衡器的admin_state_up属性值为false时会返回该状态。注意该状态仅在当前接口中返回。 - FROZEN：负载均衡器被冻结。 | | provisioning_status | String | 该字段为预留字段，暂未启用。 负载均衡器的配置状态。取值范围：可以为ACTIVE。 | 表5listeners字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 监听器ID。 | | name | String | 监听器名称。 | | l7policies | Array of [l7policies] objects | 监听器关联的转发策略列表，l7policy对象参考[表9]。 | | pools | Array of [Pools] objects | 监听器关联的后端云服务器组列表，pools对象参考[表6]。 | | operating_status | String | 监听器的操作状态。 取值范围：ONLINE 表示监听器正常。 | | provisioning_status | String | 该字段为预留字段，暂未启用。 监听器的配置状态。取值范围：可以为ACTIVE。 | 表6pools字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 后端服务器组ID。 | | name | String | 后端服务器组名称。 | | healthmonitor | [Healthmonitor] object | 后端服务器组的健康检查详情，健康检查对象参考[表7]。 | | members | Array of [Members] objects | 后端服务器组中包含的后端服务器列表，后端服务器对象参考[表8]。 | | operating_status | String | 后端服务器组的操作状态。取值范围：ONLINE 表示后端服务器组正常。 | | provisioning_status | String | 该字段为预留字段，暂未启用。 后端服务器组的配置状态。取值范围：可以为ACTIVE。 | 表7healthmonitor字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 健康检查ID。 | | name | String | 健康检查名称。 | | type | String | - 健康检查协议类型。 - 取值范围：UDP_CONNECT、TCP、HTTP。 | | provisioning_status | String | 该字段为预留字段，暂未启用。 健康检查的配置状态。取值范围：可以为ACTIVE。 | 表8members字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 后端云服务器ID。 | | address | String | 后端云服务器的IP地址。 例如："192.168.3.11"。 | | protocol_port | Integer | - 后端服务器的端口号。 - 取值范围：\[0,65535\]。 | | operating_status | String | 后端云服务器的操作状态。取值范围： - ONLINE：后端服务器正常运行。 - NO_MONITOR：后端服务器无健康检查。 - DISABLED：后端服务器不可用。所属负载均衡器、后端服务器组或该后端服务器的admin_state_up=false时，会显示该状态。注意该状态仅在当前接口中返回。 - OFFLINE：关联的ECS已下线。 说明： 该接口中的operating_status不一定与对应资源的operating_status相同。如：当Member的admin_state_up=false且operating_status=OFFLINE时，该接口返回member的operating_status=DISABLE。 | | provisioning_status | String | 该字段为预留字段，暂未启用。 后端服务器的配置状态。取值范围：可以为ACTIVE。 | 表9l7policies字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 转发策略ID。 | | name | String | 转发策略名称。 | | rules | Array of [Rules] objects | 转发策略关联的转发规则列表，转发规则字段参考[表10]。 | | action | String | - 转发策略的转发动作； - 取值范围：REDIRECT_TO_POOL：转发到后端服务器组，REDIRECT_TO_LISTENER：重定向到监听器。 | | provisioning_status | String | 该字段为预留字段，暂未启用。 转发策略的配置状态。取值范围： - ACTIVE：默认值，表示正常。 - ERROR：表示当前策略与同一监听器下的其他策略存在相同的规则配置。 | 表10rules字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 转发规则ID。 | | type | String | - 转发规则的匹配内容。 - 取值范围：PATH或者HOST_NAME。PATH：匹配请求中的路径，HOST_NAME：匹配请求中的域名。 | | provisioning_status | String | 该字段为预留字段，暂未启用。 转发规则的配置状态。取值范围： - ACTIVE：默认值，表示正常。 - ERROR：表示当前规则所属策略与同一监听器下的其他策略存在相同的规则配置。 | #### 请求示例 - 请求样例 ``` GET https://{Endpoint}/v2/145483a5107745e9b3d80f956713e6a3/elb/loadbalancers/38278031-cfca-44be-81be-a412f618773b/statuses ``` #### 响应示例 - 响应样例 ``` { "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" } } } ``` #### 返回码 请参见[状态码](https://support.huaweicloud.com/api-elb/elb_gc_1102.html)。