更新时间：2026-01-12 GMT+08:00
集群负载均衡监听器配置
功能介绍
该接口用于对集群的负载均衡监听器配置。
调用方法
请参见如何调用API。
URI
POST /v1.0/{project_id}/clusters/{cluster_id}/es-listeners
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
protocol |
是 |
String |
协议类型，支持HTTP、HTTPS |
|
protocol_port |
是 |
Integer |
端口。 |
|
server_cert_id |
否 |
String |
server证书ID。如protocol为HTTPS则该字段必选。 |
|
ca_cert_id |
否 |
String |
CA证书ID。如protocol为HTTPS且为双向认证时则该字段必选。 |
|
type |
否 |
String |
类型：searchTool 表示对Elasticsearch/Opensearch进行监听器配，viewTool 表示对Kibana/Opensearch Dashboard进行监听器配置，默认为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 |
未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 |
错误码
请参见错误码。
父主题： 负载均衡
