更新时间:2026-01-12 GMT+08:00

开启公网访问

功能介绍

当集群开启了“安全模式”和“HTTPS访问”时,可以选择是否配置“公网访问”。配置公网访问后,用户可以获得一个公网访问的IP地址,通过这个IP地址可以在公网访问该安全集群。同时,还支持配置访问控制,设置允许公网访问集群的IP地址或网段。

Elasticsearch和OpenSearch集群的公网访问是通过共享型负载均衡器实现外网访问,共享型负载均衡器资源与其他实例共享资源,如果业务追求更优的负载均衡体验,推荐使用独享型负载均衡器接入集群,配置方案请参见配置Elasticsearch集群独享型负载均衡。

调用方法

请参见如何调用API

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/public/open

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

指定开启公网访问的集群ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

eip

BindPublicReqEip object

参数解释

公网弹性IP信息。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

white_list

String

参数解释

公网访问控制白名单。

约束限制

需要添加白名单的网段或IP,以逗号隔开,不可重复。

取值范围

不涉及

默认取值

不涉及

表3 BindPublicReqEip

参数

是否必选

参数类型

描述

band_width

BindPublicReqEipBandWidth object

参数解释

公网带宽信息。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表4 BindPublicReqEipBandWidth

参数

是否必选

参数类型

描述

size

Integer

参数解释

公网带宽大小,单位:Mbit/s。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

action

String

参数解释

开启公网访问操作行为。

取值范围

固定为bindZone,表示绑定成功。

请求示例

开启公网访问。

POST https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/public/open

{
  "eip" : {
    "band_width" : {
      "size" : 5
    }
  },
  "white_list" : "127.0.0.1",
  "is_auto_pay" : 1
}

响应示例

状态码:200

请求已成功。

{
  "action" : "bindZone"
}

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

409

服务器在完成请求时发生冲突。

返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。

412

未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码