查询后端云服务器组详情
功能介绍
根据后端云服务器组的ID查询后端云服务器组详情。
URI
GET /v2/{project_id}/elb/pools/{pool_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
操作用户的项目ID。 |
pool_id |
是 |
String |
后端云服务器组ID。 |
请求消息
无
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
pool |
Pool object |
后端云服务器组对象。详见表3 pool字段说明 |
参数 |
参数类型 |
描述 |
---|---|---|
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 of Members objects |
后端云服务器组关联的后端云服务器ID的列表。详见表7 |
healthmonitor_id |
String |
后端云服务器组关联的健康检查的ID。 |
admin_state_up |
Boolean |
后端云服务器组的管理状态。 该字段为预留字段,暂未启用。取值范围:true/false。
|
listeners |
Array of Listeners objects |
后端云服务器组关联的监听器ID列表。详见表8 |
loadbalancers |
Array of Loadbalancers objects |
后端云服务器组关联的负载均衡器ID列表。详见表9 |
session_persistence |
SessionPersistence object |
后端云服务器组的会话持久性。详见表10。 当开启会话保持后,在一定时间内,来自同一客户端的请求会发送到同一个后端云服务器上。 取值范围:当会话保持关闭时,该字段取值为null。 |
protection_status |
String |
String 当前资源保护状态, 取值:
|
protection_reason |
String |
String 资源保护的原因。仅当protection_status为consoleProtection时有效。 |
参数 |
参数类型 |
描述 |
---|---|---|
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名称。支持字母、数字、中划线(-)和下划线(_),最大长度64个字符。 当会话保持类型是APP_COOKIE时,为必选字段,其它类型时不可指定。 |
persistence_timeout |
否 |
Integer |
会话保持的超时时间。 当type为APP_COOKIE时不生效。
取值范围:
|
请求示例
- 请求样例1 查询后端云服务器组的详情
GET https://{Endpoint}/v2/1867112d054b427e808cc6096d8193a1/elb/pools/5a9a3e9e-d1aa-448e-af37-a70171f2a332
响应示例
- 响应样例1
{ "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" } }
返回码
请参见状态码。