查询负载均衡状态树

功能介绍

查询负载均衡器状态树。可通过该接口查询负载均衡器关联的监听器、后端云服务器组、后端云服务器、健康检查、转发策略、转发规则的主要信息，了解负载均衡器下资源的拓扑情况。

URI

GET /v2.0/lbaas/loadbalancers/{loadbalancer_id}/statuses

表1 参数说明
参数	是否必选	参数类型	描述
loadbalancer_id	是	String	负载均衡器ID。

请求消息

无

响应消息

表2 响应参数
参数	参数类型	描述
statuses	Object	负载均衡器状态树。详见表3。

表3 statuses字段说明
参数	参数类型	描述
loadbalancer	Object	负载均衡器对象。详见表4。

表4 loadbalancer字段说明
参数	参数类型	描述
id	String	负载均衡器ID。
name	String	负载均衡器名称。支持的最大字符长度：255
listeners	Array	负载均衡器关联的监听器列表。listeners对象参考表5。
pools	Array	负载均衡器关联的后端服务器组列表。pools对象参考表6。
operating_status	String	负载均衡器的操作状态。取值范围：可以为ONLINE、OFFLINE、DEGRADED、DISABLED或NO_MONITOR。该字段为预留字段，暂未启用。默认为ONLINE。支持的最大字符长度：16
provisioning_status	String	负载均衡器的配置状态。取值范围：可以为ACTIVE、PENDING_CREATE 或者ERROR。该字段为预留字段，暂未启用。默认为ACTIVE。支持的最大字符长度：16

表5 listeners字段说明
参数	参数类型	描述
id	String	监听器ID。
name	String	监听器名称。
l7policies	Array	监听器关联的转发策略列表，l7policy对象参考表9。
pools	Array	监听器关联的后端云服务器组列表，pools对象参考表6。
operating_status	String	监听器的操作状态。取值范围：可以为ONLINE、OFFLINE、DEGRADED、DISABLED或NO_MONITOR。该字段为预留字段，暂未启用。默认为ONLINE。
provisioning_status	String	监听器的配置状态。取值范围：可以为ACTIVE、PENDING_CREATE 或者ERROR。该字段为预留字段，暂未启用。默认为ACTIVE。

表6 pools字段说明
参数	参数类型	描述
id	String	后端服务器组ID。
name	String	后端服务器组名称。
healthmonitor	Object	后端服务器组的健康检查详情，健康检查对象参考表7。
members	Array	后端服务器组中包含的后端服务器列表，后端服务器对象参考表8。
operating_status	String	后端服务器组的操作状态。取值范围：可以为ONLINE、OFFLINE、DEGRADED、DISABLED或NO_MONITOR。该字段为预留字段，暂未启用。默认为ONLINE。
provisioning_status	String	后端服务器组的配置状态。取值范围：可以为ACTIVE、PENDING_CREATE 或者ERROR。该字段为预留字段，暂未启用。默认为ACTIVE。

表7 healthmonitor字段说明
参数	参数类型	描述
id	String	健康检查ID。
name	String	健康检查名称。
type	String	健康检查类型。取值范围：UDP_CONNECT、TCP、HTTP。
provisioning_status	String	健康检查的配置状态。取值范围：可以为ACTIVE、PENDING_CREATE 或者ERROR。该字段为预留字段，暂未启用。默认为ACTIVE。

表8 members字段说明
参数	参数类型	描述
id	String	后端云服务器ID。
address	String	后端云服务器的IP地址。例如："192.168.3.11"。
protocol_port	Integer	后端服务器的端口号。取值范围：[0,65535]。
operating_status	String	后端服务器的健康检查状态。取值范围：可以为ONLINE、OFFLINE、DEGRADED、DISABLED或NO_MONITOR。ONLINE：健康检查在线，OFFLINE：健康检查离线，DISABLED：后端服务器无对应的弹性云服务器，NO_MONITOR：健康检查未开启。
provisioning_status	String	后端服务器的配置状态。取值范围：可以为ACTIVE、PENDING_CREATE 或者ERROR。该字段为预留字段，暂未启用。默认为ACTIVE。

表9 l7policies字段说明
参数	参数类型	描述
id	String	转发策略ID。
name	String	转发策略名称。
rules	Array	转发策略关联的转发规则列表，转发规则字段参考表10。
action	String	转发策略的转发动作；取值范围：REDIRECT_TO_POOL：转发到后端服务器组，REDIRECT_TO_LISTENER：重定向到监听器。
provisioning_status	String	转发策略的配置状态。取值范围：可以为ACTIVE、PENDING_CREATE 或ERROR。该字段为预留字段，暂未启用。默认为ACTIVE。

**表10** rules字段说明
参数	参数类型	描述
id	String	转发规则ID。
type	String	转发规则的匹配内容。取值范围：PATH或者HOST_NAME。PATH：匹配请求中的路径，HOST_NAME：匹配请求中的域名。
provisioning_status	String	转发规则的配置状态。取值范围：可以为ACTIVE、PENDING_CREATE 或ERROR。该字段为预留字段，暂未启用。默认为ACTIVE。

请求示例

请求样例

GET https://{Endpoint}/v2.0/lbaas/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"
        }
    }
}