查询后端服务器组详情
功能介绍
后端服务器组详情。
调用方法
请参见如何调用API。
URI
GET /v3/{project_id}/elb/pools/{pool_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
pool_id |
是 |
String |
后端服务器组ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
IAM鉴权Token。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
request_id |
String |
请求ID。 注:自动生成 。 |
pool |
Pool object |
后端服务器组对象。 |
参数 |
参数类型 |
描述 |
---|---|---|
admin_state_up |
Boolean |
后端云服务器组的管理状态,只支持设置为true。 不支持该字段,请勿使用。 |
description |
String |
后端云服务器组的描述信息。 |
healthmonitor_id |
String |
后端云服务器组关联的健康检查的ID。 |
id |
String |
后端云服务器组的ID。 |
lb_algorithm |
String |
后端云服务器组的负载均衡算法。 取值:
使用说明:
|
listeners |
Array of ListenerRef objects |
后端云服务器组关联的监听器ID列表。 |
loadbalancers |
Array of LoadBalancerRef objects |
后端云服务器组关联的负载均衡器ID列表。 |
members |
Array of MemberRef objects |
后端云服务器组中的后端云服务器ID列表。 |
name |
String |
后端云服务器组的名称。 |
project_id |
String |
后端云服务器组所在的项目ID。 |
protocol |
String |
后端云服务器组的后端协议。 取值:TCP、UDP、HTTP、HTTPS、QUIC和TCPSSL。 使用说明:
|
session_persistence |
SessionPersistence object |
会话持久性对象。 |
ip_version |
String |
后端云服务器组支持的IP版本。 取值:
当协议为HTTP时,ip_version为v4。 |
slow_start |
SlowStart object |
慢启动信息。开启慢启动后,将会在设定的时间段(duration)内对新添加到后端服务器组的后端服务器进行预热,转发到该服务器的请求数量线性增加。 当后端服务器组的协议为HTTP/HTTPS时有效,其他协议传入该字段将报错。 |
member_deletion_protection_enable |
Boolean |
是否开启误删保护。 取值:false不开启,true开启。
说明:
退场时需要先关闭所有资源的删除保护开关。 |
created_at |
String |
创建时间。格式:yyyy-MM-dd'T'HH:mm:ss'Z',UTC时区。 注意:独享型实例的历史数据以及共享型实例下的资源,不返回该字段。 |
updated_at |
String |
更新时间。格式:yyyy-MM-dd'T'HH:mm:ss'Z',UTC时区。 注意:独享型实例的历史数据以及共享型实例下的资源,不返回该字段。 |
vpc_id |
String |
后端云服务器组关联的虚拟私有云的ID。 |
type |
String |
后端服务器组的类型。 取值:
|
参数 |
参数类型 |
描述 |
---|---|---|
cookie_name |
String |
cookie名称。 共享型LB,支持字母、数字、中划线(-)和下划线(),最大长度64个字符。 独享型LB,支持字母、数字、中划线(-)、下划线()和点号(.),最大长度255个字符。 使用说明:
|
type |
String |
会话保持类型。 取值范围:SOURCE_IP、HTTP_COOKIE、APP_COOKIE。 使用说明:
|
persistence_timeout |
Integer |
会话保持的时间。当type为APP_COOKIE时不生效。 适用范围:如果pool的protocol为TCP、UDP和QUIC则范围为[1,60](分钟),默认值1; 如果pool的protocol为HTTP和HTTPS则范围为[1,1440](分钟),默认值1440。 |
请求示例
查询后端服务器组详情
GET https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/pools/36ce7086-a496-4666-9064-5ba0e6840c75
响应示例
状态码: 200
操作正常返回。
{ "pool" : { "type" : "", "vpc_id" : "", "lb_algorithm" : "LEAST_CONNECTIONS", "protocol" : "TCP", "description" : "My pool", "admin_state_up" : true, "member_deletion_protection_enable" : false, "loadbalancers" : [ { "id" : "098b2f68-af1c-41a9-8efd-69958722af62" } ], "project_id" : "99a3fff0d03c428eac3678da6a7d0f24", "session_persistence" : null, "healthmonitor_id" : "", "listeners" : [ { "id" : "0b11747a-b139-492f-9692-2df0b1c87193" }, { "id" : "61942790-2367-482a-8b0e-93840ea2a1c6" }, { "id" : "fd8f954c-f0f8-4d39-bb1d-41637cd6b1be" } ], "members" : [ ], "id" : "36ce7086-a496-4666-9064-5ba0e6840c75", "name" : "My pool.", "ip_version" : "dualstack" }, "request_id" : "c1a60da2-1ec7-4a1c-b4cc-73e1a57b368e" }
状态码
状态码 |
描述 |
---|---|
200 |
操作正常返回。 |
错误码
请参见错误码。