更新时间：2026-09-02 GMT+08:00

修改集群的终端节点服务白名单

功能介绍

终端节点的访问控制功能支持通过白名单设置允许访问终端节点的IP地址或网段。在购买终端节点时以及购买完成后，均可以开启或关闭终端节点的访问控制功能，也可以添加或删除白名单。该接口用于修改终端节点服务白名单。

调用方法

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/vpcepservice/permissions

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及取值范围：账户的项目ID。默认取值：不涉及
cluster_id	是	String	参数解释：指定更改的集群ID。获取方法请参见获取集群ID。约束限制：不涉及取值范围：集群ID。默认取值：不涉及

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
vpc_permissions	是	Array of strings	参数解释：白名单信息（账号ID）列表，请参考查询指定条件下的项目列表获取账号ID。约束限制：不涉及

响应参数

状态码：200

请求成功。

无

请求示例

修改终端节点服务白名单。

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

{
  "vpc_permissions" : [ "dffef70c1db243cbb373e45791165281" ]
}

响应示例

无

状态码

状态码	描述
200	请求成功。
400	非法请求。建议直接修改该请求，不要重试该请求。
409	服务器在完成请求时发生冲突。返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。
412	未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码。

父主题： 终端节点