查询负载均衡器状态树
功能介绍
查询负载均衡器状态树,包括负载均衡器及其关联的子资源的状态信息。
注意:该接口中的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 |
负载均衡器名称。 |
|
provisioning_status |
String |
负载均衡器的配置状态。 取值:
|
|
listeners |
Array of LoadBalancerStatusListener objects |
负载均衡器关联的监听器列表。 |
|
pools |
Array of LoadBalancerStatusPool objects |
负载均衡器关联的后端服务器组列表。 |
|
id |
String |
负载均衡器ID。 |
|
operating_status |
String |
负载均衡器的操作状态。 取值:
说明:DEGRADED和DISABLED状态仅在当前接口中返回,LB详情等其他接口不返回这两个状态值。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
监听器的名称。 |
|
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 |
转发策略名称。 |
|
rules |
Array of LoadBalancerStatusL7Rule objects |
转发规则状态信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
L7转发规则ID。 |
|
type |
String |
匹配内容类型。 取值:
使用说明: 同一个l7policy下创建的所有的l7rule的HOST_NAME不能重复。 |
|
provisioning_status |
String |
转发规则的配置状态。 取值:
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
provisioning_status |
String |
后端服务器组的配置状态。 取值:
|
|
name |
String |
后端服务器组名。 |
|
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 |
健康检查器名称。 |
|
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 |
操作成功正常返回。 |
错误码
请参见错误码。