更新时间:2026-09-03 GMT+08:00
开启公网访问控制白名单
功能介绍
当集群已经开启“公网访问”时,可以使用该接口开启公网访问控制白名单。
调用方法
请参见如何调用API。
URI
POST /v1.0/{project_id}/clusters/{cluster_id}/public/whitelist/update
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| white_list | 是 | String | 参数解释: 公网访问控制白名单,需要添加白名单的网段或IP,以逗号隔开,正确示例:192.168.1.1,10.0.0.0/24。 约束限制: 不支持:0.0.0.0、x.x.x.x/0、非标准格式(如192.168.1)或重复项。 取值范围: 有效的网段或IP。 默认取值: 不涉及 |
响应参数
状态码:200
请求成功。
无
请求示例
开启公网访问控制白名单。
POST https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/public/whitelist/update
{
"white_list" : "192.168.0.1"
} 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功。 |
| 400 | 非法请求。 建议直接修改该请求,不要重试该请求。 |
| 409 | 服务器在完成请求时发生冲突。 返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。 |
| 412 | 未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。 |
错误码
请参见错误码。
父主题: 公网访问