Creating a VPN User Group
Function
This API is used to create a VPN user group on a specified VPN server.
Calling Method
For details, see Calling APIs.
URI
| 
         Parameter  | 
       
         Type  | 
       
         Mandatory  | 
       
         Description  | 
      
|---|---|---|---|
| 
         project_id  | 
       
         String  | 
       
         Yes  | 
       
         Specifies a project ID. You can obtain the project ID by referring to Obtaining the Project ID.  | 
      
| 
         vpn_server_id  | 
       
         String  | 
       
         Yes  | 
       
         Specifies the ID of a VPN server.  | 
      
| 
         Parameter  | 
       
         Type  | 
       
         Mandatory  | 
       
         Description  | 
      
|---|---|---|---|
| 
         X-Client-Token  | 
       
         String  | 
       
         No  | 
       
        
  | 
      
Request
- Request parameters 
    
Table 3 Request parameters Parameter
Type
Mandatory
Description
user_group
Yes
Specifies the to-be-created VPN user group object.
Table 4 CreateVpnUserGroupRequestBodyContent Parameter
Type
Mandatory
Description
name
String
Yes
- Specifies a user group name.
 - The value is a string of 1 to 64 characters, which can contain letters, digits, underscores (_), and hyphens (-).
 - A user group name must be unique.
 
description
String
No
- Specifies user group description.
 - The value is a string of 0 to 64 characters, which can contain uppercase letters, lowercase letters, digits, and the following special characters: `~!@#$%^&*()-_=+\|[{}];:'",<.>/?
 
- Example request
      
POST https://{Endpoint}/v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/groups { "user_group": { "name": "user-group1", "description": "UserGroup1" } } 
 
Response
- Response parameters
    
Returned status code 201: successful operation
Table 5 Parameters in the response body Parameter
Type
Description
user_group
user_group object
Specifies the user group object.
request_id
String
Specifies a request ID.
 
- Example response
   
{ "user_group": { "id": "7625fd92-2e20-4e4d-8c56-66f110fbfaa8" }, "request_id": "94d271493e144135423e7377e40127cf" } 
Status Codes
For details, see Status Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.