更新时间:2022-01-25 GMT+08:00

查询负载均衡状态树

功能介绍

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

URI

GET /v2/{project_id}/elb/loadbalancers/{loadbalancer_id}/statuses

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

操作用户的项目ID。

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/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"
            }
        }
    }

返回码

请参见负载均衡返回码说明