配置集群负载均衡监听器
功能介绍
云搜索服务支持对接ELB负载均衡,该接口会自动为Elasticsearch/OpenSearch创建监听器、后端服务器组、健康检查,并对接独享型ELB负载均衡器。
调用方法
请参见如何调用API。
URI
POST /v1.0/{project_id}/clusters/{cluster_id}/es-listeners
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| protocol | 是 | String | 参数解释: 协议类型。 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| protocol_port | 是 | Integer | 参数解释: 监听器的监听端口。 约束限制: 不允许和ELB中的其他监听器的端口重复。 取值范围: 0-65535 默认取值: 不涉及 |
| server_cert_id | 否 | String | 参数解释: 监听器使用的服务器证书ID。 约束限制: 当protocol为HTTPS则该字段必选。 取值范围: 不涉及 默认取值: 不涉及 |
| ca_cert_id | 否 | String | 参数解释: 监听器使用的CA证书ID。 约束限制: 当protocol为HTTPS且为双向认证时则该字段必选。 取值范围: 不涉及 默认取值: 不涉及 |
| type | 否 | String | 参数解释: 配置类型。 约束限制: 不涉及。 取值范围: searchTool: 表示对Elasticsearch/OpenSearch进行监听器配置。 默认取值: searchTool |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| elb_id | String | 参数解释: 负载均衡器ID。 取值范围: 不涉及。 |
请求示例
集群负载均衡监听器配置。
POST https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/es-listeners
{
"protocol" : "HTTPS",
"protocol_port" : 9200,
"server_cert_id" : "1b74ae4afad741e6bc9497429d3d0838",
"ca_cert_id" : "2a7b050f598e4ea8a61cffbe2bdb312f"
} 响应示例
状态码:200
请求成功。
{
"elb_id" : "56a83547-a55a-407a-8245-7f9b3a0606c0"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功。 |
| 400 | 非法请求。 建议直接修改该请求,不要重试该请求。 |
| 409 | 服务器在完成请求时发生冲突。 返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。 |
| 412 | 未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。 |
错误码
请参见错误码。