获取集群的负载均衡器信息
功能介绍
云搜索服务集成了共享型负载均衡器的能力,支持绑定公网访问和开启终端节点服务。相比共享型负载均衡器,独享型负载均衡器功能更丰富、性能更强。
该接口用于获取集群的负载均衡器信息,包括服务器证书名称、服务器证书ID、弹性负载均衡开关信息、负载均衡器对象信息、监听对象信息、健康检查结果等。
调用方法
请参见如何调用API。
URI
GET /v1.0/{project_id}/clusters/{cluster_id}/es-listeners
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| serverCertName | String | 参数解释: 服务器证书名称。 取值范围: 不涉及 |
| serverCertId | String | 参数解释: 服务器证书ID。 取值范围: 不涉及 |
| cacertName | String | 参数解释: CA证书名称。 取值范围: 不涉及 |
| cacertId | String | 参数解释: CA证书ID。 取值范围: 不涉及 |
| elb_enable | Boolean | 参数解释: 弹性负载均衡开关信息。 取值范围: |
| authentication_type | String | 参数解释: 认证方式。 取值范围: |
| loadBalancer | LoadBalancer object | 参数解释: 负载均衡器对象信息。 取值范围: 不涉及 |
| listener | Elbv3Listener object | 参数解释: 监听器对象信息。 取值范围: 不涉及 |
| healthmonitors | Array of Member objects | 参数解释: 健康检查结果集合。 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 负载均衡器ID。 取值范围: 不涉及 |
| name | String | 参数解释: 负载均衡器名称。 取值范围: 不涉及 |
| guaranteed | String | 参数解释: 是否独享型负载均衡器。 取值范围: |
| billing_info | String | 参数解释: 资源账单信息。 取值范围: |
| description | String | 参数解释: 描述信息。 取值范围: 不涉及 |
| vpc_id | String | 参数解释: 负载均衡器所属VPC ID,即虚拟私有云ID。 取值范围: 不涉及 |
| provisioning_status | String | 参数解释: 负载均衡器的配置状态。 取值范围: |
| listeners | Array of IdListWrapper objects | 参数解释: 关联的listener列表。 取值范围: 不涉及 |
| vip_address | String | 参数解释: 负载均衡器的IPv4虚拟IP地址。 取值范围: 不涉及 |
| vip_port_id | String | 参数解释: 负载均衡器的IPv4对应的port ID。 取值范围: 不涉及 |
| ipv6_vip_address | String | 参数解释: 负载均衡器的IPv6地址。 取值范围: 不涉及 |
| publicips | Array of PublicIpInfo objects | 参数解释: 负载均衡器绑定的公网IP。 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| publicip_id | String | 参数解释: 弹性公网IP配置ID。 取值范围: 不涉及 |
| publicip_address | String | 参数解释: 弹性公网IP地址。 取值范围: 不涉及 |
| ip_version | Integer | 参数解释: IP版本信息。 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 监听器ID。 取值范围: 不涉及 |
| name | String | 参数解释: 监听器的名称。 取值范围: 不涉及 |
| protocol | String | 参数解释: 监听器的监听协议。 取值范围: 不涉及 |
| protocol_port | Integer | 参数解释: 监听器的前端监听端口。 取值范围: 不涉及 |
| ipgroup | ListenerIpGroup object | 参数解释: listener对象中的ipgroup信息。 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| ipgroup_id | String | 参数解释: 监听器关联的访问控制组的ID。创建时必选,更新时非必选。 取值范围: 不涉及 |
| enable_ipgroup | Boolean | 参数解释: 访问控制组的状态。 取值范围: |
请求示例
获取集群的负载均衡信息。
GET https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/es-listeners 响应示例
状态码:200
请求已成功。
{
"loadBalancer" : {
"id" : "5d45faad-6cb3-479b-96b8-3e2de0cc6268",
"name" : "elb-css",
"guaranteed" : "true",
"description" : "",
"listeners" : [ {
"id" : "011d14fa-908b-4cd9-b0d6-0768ddc6cb71"
}, {
"id" : "04b86029-c281-4490-a3bd-5ea1266658ba"
} ],
"publicips" : [ {
"publicip_id" : "f678e23c-96a5-49e8-8ea2-bd8b47d41e78",
"publicip_address" : "100.1.1.1",
"ip_version" : 4
} ],
"vpc_id" : "4f3deec3-efa8-4598-bf91-560aad1377a3",
"provisioning_status" : "ACTIVE",
"vip_address" : "10.0.0.1",
"ipv6_vip_address" : "2409:27ff:2003:3e:1fd::f3"
},
"listener" : {
"id" : "41ff041d-c7b9-4142-9167-fa93d54f97da",
"name" : "css-searchServer",
"protocol" : "HTTPS",
"protocol_port" : 9265
},
"healthmonitors" : [ {
"instance_id" : "bac86342-2222-43e6-817f-57f040a174a6",
"name" : "",
"address" : "10.0.0.87",
"protocol_port" : 9200,
"operating_status" : "ONLINE"
}, {
"instance_id" : "d935b82c-f94b-4ae0-9997-ddc90885d8c6",
"name" : "",
"address" : "10.0.0.61",
"protocol_port" : 9200,
"operating_status" : "ONLINE"
} ],
"serverCertName" : "server1",
"serverCertId" : "82375af01c0d40f6a44c15962c570625",
"elb_enable" : true,
"authentication_type" : "single"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功。 |
| 400 | 非法请求。 建议直接修改该请求,不要重试该请求。 |
| 409 | 服务器在完成请求时发生冲突。 返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。 |
| 412 | 未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。 |
错误码
请参见错误码。