更新时间:2026-04-24 GMT+08:00

添加VPN用户到组 - AddUserGroup

功能介绍

将VPN用户添加到指定用户组中。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

vpn:p2cVpnGateway:addUsers

write

p2cVpnUser

-

-

-

p2cVpnGateway

g:ResourceTag/<tag-key>

URI

POST /v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/groups/{group_id}/add-users

表1 参数说明

名称

类型

是否必选

描述

project_id

String

项目ID,可以通过获取项目ID获取项目ID。

vpn_server_id

String

VPN服务端ID。

group_id

String

VPN用户组ID。

请求消息

  • 请求参数
    表2 请求参数

    名称

    类型

    是否必选

    描述

    users

    Array of OpVpnUser objects

    VPN用户列表。

    表3 OpVpnUser

    名称

    类型

    是否必选

    描述

    id

    String

    • 功能描述:VPN用户ID。
    • 格式:36位UUID。
    • 请求样例
      POST https://{Endpoint}/v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/groups/{group_id}/add-users
      
      {
        "users": [
          {
            "id": "41ad472e-d3e4-482b-8f00-7b2c1bfc4b7d"
          },
         {
            "id": "a609eecb-3fa6-4d6d-a8c3-256a12d02b6c"
          }
        ]
      }

响应消息

  • 响应参数

    返回状态码为 201: successful operation。

    表4 响应Body参数列表

    名称

    类型

    描述

    request_id

    String

    请求ID。

    • 响应示例
      {
          "request_id": "63c49a90467d1ee8a111e587eaedac1f"
      }

状态码

请参见状态码