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

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

功能介绍

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

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

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"
      ]
}

状态码

状态码请参见状态码。