文档首页> VPC终端节点 VPCEP> API参考 (巴黎区域) > API> 终端节点服务功能> 批量添加或移除终端节点服务的白名单
更新时间:2024-03-14 GMT+08:00

批量添加或移除终端节点服务的白名单

功能介绍

批量添加或移除当前用户下终端节点服务的白名单。

账号默认在自身用户的终端节点服务的白名单中。

URI

POST /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions/action

参数说明如表1所示。
表1 参数说明

参数

是否必选

描述

project_id

项目ID,获取方法请参见获取项目ID

vpc_endpoint_service_id

终端节点服务的ID。

请求消息

  • 参数说明
    表2 请求参数

    名称

    是否必选

    参数类型

    描述

    permissions

    Array of strings

    permission列表。

    权限格式为:iam:domain::domain_id

    其中,

    • “iam:domain::”为固定格式。
    • “domain_id”为可连接用户的账号ID。

      支持输入1~64个字符,包括“a~z”、“A~Z”、“0~9”或者“*”。“*”表示所有终端节点可连接。

      例如:iam:domain::6e9dfd51d1124e8d8498dce894923a0dd。

    action

    String

    要执行的操作。

    add/remove。

  • 请求样例

    为ID为“4189d3c2-8882-4871-a3c2-d380272eed88”的终端节点服务添加白名单。

    POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions/action
    {
        "permissions":
          [
            "iam:domain::fc973eea581490997e82ea11a1d0101"
          ],
        "action":"add"
    } 

    删除ID为“4189d3c2-8882-4871-a3c2-d380272eed88”的终端节点服务的白名单。

    POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions/action
    {
      "permissions":
        [
          "iam:domain::5fc973eea581490997e82ea11a1d0101"
        ],
       "action":"remove"
    }

响应消息

  • 参数说明
    表3 响应参数

    名称

    参数类型

    描述

    permissions

    Array of strings

    permission列表。

    权限格式为iam:domain:: 6e9dfd51d1124e8d8498dce894923a0d或“*”,“*”表示所有用户的终端节点可连接。其中6e9dfd51d1124e8d8498dce894923a0d为可连接的用户domain_id。

  • 响应样例
    {
      "permissions":
        [
          "iam:domain::5fc973eea581490997e82ea11a1d0101",
          "iam:domain::5fc973eea581490997e82ea11a1d0102"
          ]
    }

状态码

状态码请参见状态码