# 修改VPN访问策略 - UpdateAccessPolicy
#### 功能介绍
根据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:p2cVpnGateway:updateAccessPolicy | write | p2cVpnGateway | g:ResourceTag/\<tag-key\> | -  | -      |
   
#### URI
PUT /v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/access-policies/{policy_id}
表1参数说明 
| 名称            | 类型     | 是否必选 | 描述                                                                                  |
|:---|:---|:---|:---|
| project_id    | String | 是    | 项目ID，可以通过[获取项目ID](https://support.huaweicloud.com/api-vpn/vpn_api_0051.html)获取项目ID。 |
| vpn_server_id | String | 是    | VPN服务端ID。                                                                           |
| policy_id     | String | 是    | 访问策略ID。                                                                             |
   
#### 请求消息
- 请求参数
  表2请求参数 
  | 名称            | 类型                                                                                                  | 必选 | 描述           |
  |:---|:---|:---|:---|
  | access_policy | [UpdateVpnAccessPolicyRequestBodyContent] object | 是  | 更新访问策略请求体对象。 |
     
   表3UpdateVpnAccessPolicyRequestBodyContent 
  | 名称            | 类型               | 必选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                               |
  |:---|:---|:---|:---|
  | name          | String           | 否  | 访问策略名称。                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | user_group_id | String           | 否  | - 功能描述：关联用户组ID。  - 格式：36位UUID。                                                                                                                                                |
  | description   | String           | 否  | 访问策略描述。                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | dest_ip_cidrs | Array of strings | 否  | - 功能描述：目的IP网段列表。  - 格式："点分十进制/掩码"格式，例如192.168.1.0/24。  - 约束：至少有1个网段，至多10个网段。   |
     
  - 请求样例
    ```
    PUT https://{Endpoint}/v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/access-policies/{policy_id}
    {
      "access_policy": {
        "name": "policy-001-update",
        "user_group_id": "efb92c43-c2e9-44c0-b2e5-5b980f0ca90a",
        "description": "访问策略1-update",
        "dest_ip_cidrs": [
    "192.168.12.0/24",
    "192.168.1.0/24"
        ]
      }
    }
    ```
    
   
 
#### 响应消息
- 响应参数 返回状态码为 200: successful operation。
  表4响应Body参数列表 
  | 名称            | 类型                                                                           | 描述         |
  |:---|:---|:---|
  | access_policy | [VpnAccessPolicy] object | VPN访问策略对象。 |
  | request_id    | String                                                                       | 请求ID。      |
     
   表5VpnAccessPolicy 
  | 名称              | 类型              | 描述                                                                                                                                                                                                                                                                                                  |
  |:---|:---|:---|
  | id              | String          | - 功能描述：访问策略ID。  - 格式：36位UUID。                             |
  | name            | String          | 访问策略名称。                                                                                                                                                                                                                                                                                             |
  | type            | String          | 访问策略类型。                                                                                                                                                                                                                                                                                             |
  | user_group_id   | String          | - 功能描述：关联用户组ID。  - 格式：36位UUID。                         |
  | user_group_name | String          | 关联用户组名称。                                                                                                                                                                                                                                                                                            |
  | description     | String          | 访问策略描述。                                                                                                                                                                                                                                                                                             |
  | dest_ip_cidrs   | Array of String | - 功能描述：目的IP网段列表。  - 格式："点分十进制/掩码"格式，例如192.168.1.0/24。   |
  | created_at      | String          | - 功能说明：创建时间。  - UTC时间格式：*yyyy-MM-ddTHH:mm:ss.SSSZ*。        |
  | updated_at      | String          | - 功能说明：更新时间。  - UTC时间格式：*yyyy-MM-ddTHH:mm:ss.SSSZ*。        |
     
  - 响应示例
    ```
    {
        "access_policy": {
            "id": "36f3f232-9204-4774-be20-84cc94da8535",
            "name": "policy-001-update",
            "user_group_id": "efb92c43-c2e9-44c0-b2e5-5b980f0ca90a",
            "user_group_name": "用户组A",
            "description": "访问策略1-update",
            "dest_ip_cidrs": [
                "192.168.12.0/24",
                "192.168.1.0/24"
            ],
            "created_at": "2024-06-14T08:59:45.598Z",
            "updated_at": "2024-06-14T09:01:59.539Z"
        },
        "request_id": "2e4cc58a4ea5fe69f62d6d8943b5f99b"
    }
    ```
    
   
 
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。