查询后端云服务器组详情
功能介绍
根据后端云服务器组的ID查询后端云服务器组详情。
URI
GET /v2.0/lbaas/pools/{pool_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
pool_id |
是 |
String |
后端云服务器组ID。 |
请求消息
无
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
pool |
Object |
后端云服务器组对象。详见表3 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
后端云服务器组 ID。 |
tenant_id |
String |
后端云服务器组所属的项目 ID。 支持的最大字符长度:255 |
project_id |
String |
此参数和tenant_id参数含义一样,均指后端云服务器组所属的项目 ID。 |
name |
String |
后端云服务器组名称。 支持的最大字符长度:255 |
description |
String |
后端云服务器组的描述信息。 支持的最大字符长度:255 |
protocol |
String |
后端云服务器组的后端协议。 取值范围:TCP、UDP和HTTP。 当指定listener_id创建后端云服务器组时,后端云服务器组的protocol和它关联的监听器的protocol有如下关系:
|
lb_algorithm |
String |
后端云服务器组的负载均衡算法。
取值范围:
|
members |
Array |
后端云服务器组关联的后端云服务器ID的列表。 |
healthmonitor_id |
String |
后端云服务器组关联的健康检查的ID。 |
admin_state_up |
Boolean |
后端云服务器组的管理状态。 该字段为预留字段,暂未启用。取值范围:true/false。
|
listeners |
Array |
后端云服务器组关联的监听器ID列表。 |
loadbalancers |
Array |
后端云服务器组关联的负载均衡器ID列表。 |
session_persistence |
Object |
后端云服务器组的会话持久性。详见表9。 当开启会话保持后,在一定时间内,来自同一客户端的请求会发送到同一个后端云服务器上。 取值范围:当会话保持关闭时,该字段取值为null。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
关联的后端服务器id |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
关联的后端服务器组id |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
关联的负载均衡器id |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
会话保持的类型。
取值范围:
当后端云服务器组的protocol为TCP时,只按SOURCE_IP生效;当后端云服务器组的protocol为HTTP时,只按HTTP_COOKIE、APP_COOKIE生效。 |
cookie_name |
String |
cookie名称。 当会话保持类型是APP_COOKIE时,为必选字段,其它类型时不可指定。 |
persistence_timeout |
Integer |
会话保持的超时时间。 当type为APP_COOKIE时不生效。
|
请求示例
- 请求样例 查询后端云服务器组的详情
GET https://{Endpoint}/v2.0/lbaas/pools/5a9a3e9e-d1aa-448e-af37-a70171f2a332
响应示例
- 响应样例
{ "pool": { "lb_algorithm": "SOURCE_IP", "protocol": "TCP", "description": "", "admin_state_up": true, "loadbalancers": [ { "id": "6f52004c-3fe9-4c09-b8ce-ed9d9c74a3b1" } ], "tenant_id": "1867112d054b427e808cc6096d8193a1", "project_id": "1867112d054b427e808cc6096d8193a1", "session_persistence": null, "healthmonitor_id": null, "listeners": [ { "id": "6e29b2cd-4e53-40f6-ae7b-29e918de67f2" } ], "members": [], "id": "5a9a3e9e-d1aa-448e-af37-a70171f2a332", "name": "my-pool" } }
返回码
请参见状态码。