更新时间:2024-11-29 GMT+08:00

查询VPN用户组

功能介绍

根据VPN用户组ID,查询用户组信息。

调用方法

请参见如何调用API

URI

GET /v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/groups/{group_id}

表1 参数说明

名称

类型

是否必选

描述

project_id

String

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

vpn_server_id

String

VPN服务端ID。

group_id

String

用户组ID。

请求消息

  • 请求参数

    无。

  • 请求样例
    GET https://{Endpoint}/v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/groups/{group_id} 

响应消息

  • 响应参数

    返回状态码为 200: 查询成功。

    表2 响应Body参数列表

    名称

    类型

    描述

    user_group

    VpnUserGroup object

    VPN用户组对象。

    request_id

    String

    请求ID。

    表3 VpnUserGroup

    名称

    类型

    描述

    id

    String

    • 功能描述:VPN用户组ID。
    • 格式:36位UUID。

    name

    String

    用户组名称。

    description

    String

    用户组描述。

    type

    String

    • 功能说明:用户组类型。
    • 取值范围:

      Default:默认用户组。

      Custom:用户创建用户组。

    user_number

    Integer

    用户数量。

    created_at

    String

    • 功能说明:创建时间。
    • UTC时间格式:yyyy-MM-ddTHH:mm:ssZ

    updated_at

    String

    • 功能说明:更新时间。
    • UTC时间格式:yyyy-MM-ddTHH:mm:ssZ
    • 响应样例
      {
          "user_group": {
              "id": "7625fd92-2e20-4e4d-8c56-66f110fbfaa8",
              "name": "user-group1",
              "description": "用户组1",
              "type": "Custom",
              "user_number": 0,
              "created_at": "2024-06-17T09:48:27.548Z",
              "updated_at": "2024-06-17T09:48:27.548Z"
          },
          "request_id": "6735d32bb3e35e9154caba1dbc6c2dc6"
      }

状态码

请参见状态码