
# 修改VPN用户 - UpdateVPNUser
#### 功能介绍
根据VPN用户ID，修改指定的用户。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-vpn/vpn_api_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpn/vpn_api_0044.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项                   | 访问级别  | 资源类型（\*为必须）   | 条件键                       | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| vpn:p2cVpnUser:update | write | p2cVpnUser    | -                         | -  | -      |
| vpn:p2cVpnUser:update | write | p2cVpnGateway | g:ResourceTag/\<tag-key\> | -  | -      |
   
#### URI
PUT /v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/users/{user_id}
表1参数说明 
| 名称            | 类型     | 是否必选 | 描述                                                                                  |
|:---|:---|:---|:---|
| project_id    | String | 是    | 项目ID，可以通过[获取项目ID](https://support.huaweicloud.com/api-vpn/vpn_api_0051.html)获取项目ID。 |
| vpn_server_id | String | 是    | VPN服务端ID。                                                                           |
| user_id       | String | 是    | 用户ID。                                                                               |
   
#### 请求消息
- 请求参数
  表2请求参数 
  | 名称   | 类型                                                                                       | 必选 | 描述           |
  |:---|:---|:---|:---|
  | user | [UpdateVpnUserRequestBodyContent] object | 是  | 更新VPN用户请求对象。 |
     
   表3UpdateVpnUserRequestBodyContent 
  | 名称            | 类型     | 必选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  |:---|:---|:---|:---|
  | description   | String | 否  | - 功能说明：用户描述。  - 格式：0-64字符，包含中文、英文、数字、下划线。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
  | user_group_id | String | 否  | - 功能说明：所属用户组ID。  - 格式：36位UUID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | static_ip     | String | 否  | - 功能说明：客户端的静态IP地址。  - 格式：点分十进制IPv4地址（如192.168.0.5）或者"disable"。  - 约束： - 必须在客户端网段范围内  - 不能与客户端网段的网关IP相同。例如客户端网段为192.168.0.0/24，则不能指定客户端地址为192.168.0.1  - 必须填写30位掩码网段的第一个主机地址。例如对于192.168.10.4/30这个30位掩码网段中的四个IP地址，只能指定客户端地址为192.168.10.5  - 不能与其他用户指定的IP地址相同     |
     
  
- 请求样例
  ```
  PUT https://{Endpoint}/v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/users/{user_id}
  {
    "user": {
      "description": "用户描述-update",
      "user_group_id": "PTnsQAbZ-KOgW-mCzt-C9Sk-rMM3TcNjQ8wY"
    }
  }
  ```
  
 
#### 响应消息
- 响应参数 返回状态码为 200: successful operation。
  表4响应Body参数列表 
  | 名称         | 类型                                                                   | 描述       |
  |:---|:---|:---|
  | user       | [VpnUser] object | VPN用户对象。 |
  | request_id | String                                                               | 请求ID。    |
     
   表5VpnUser 
  | 名称              | 类型     | 描述                                                                                                                                                                                                                                                                                                               |
  |:---|:---|:---|
  | id              | String | - 功能说明：用户ID。  - 格式：36位UUID。                                             |
  | name            | String | 用户名称。                                                                                                                                                                                                                                                                                                            |
  | description     | String | 用户描述。                                                                                                                                                                                                                                                                                                            |
  | user_group_id   | String | - 功能说明：所属用户组ID。  - 格式：36位UUID。                                                 |
  | user_group_name | String | 所属用户组名称。                                                                                                                                                                                                                                                                                                         |
  | static_ip       | String | - 功能说明：客户端的静态IP地址。  - 格式：点分十进制IPv4地址（如192.168.0.5）或者"disable"。   |
  | created_at      | String | - 功能说明：创建时间。  - UTC时间格式：*yyyy-MM-ddTHH:mm:ss.SSSZ*。                   |
  | updated_at      | String | - 功能说明：更新时间。  - UTC时间格式：*yyyy-MM-ddTHH:mm:ss.SSSZ*。                      |
     
  - 响应示例
    ```
    {
        "user": {
            "id": "41ad472e-d3e4-482b-8f00-7b2c1bfc4b7d",
            "name": "1111",
            "description": "用户描述-update",
            "user_group_id": "PTnsQAbZ-KOgW-mCzt-C9Sk-rMM3TcNjQ8wY",
            "user_group_name": "user-group2",
            "created_at": "2024-06-17T06:53:46.302Z",
            "updated_at": "2024-06-17T08:45:20.973Z"
        },
        "request_id": "380562b4bda6dfe116c42e707d8e9110"
    }
    ```
    
   
 
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。
