# 查询VPN访问策略 - QueryAccessPolicy
#### 功能介绍
根据访问策略ID，查询VPN访问策略。
#### 调用方法
请参见[如何调用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:getAccessPolicy | read | p2cVpnGateway | g:ResourceTag/\<tag-key\> | -  | -      |
   
#### URI
GET /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。                                                                             |
   
#### 请求消息
- 请求参数 无。
  
- 请求样例
  ```
  GET https://{Endpoint}/v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/access-policies/{policy_id}
  ```
  
 
#### 响应消息
- 响应参数 返回状态码为 200: 查询成功。
  表2响应Body参数列表 
  | 名称            | 类型                                                                           | 描述         |
  |:---|:---|:---|
  | access_policy | [VpnAccessPolicy] object | VPN访问策略对象。 |
  | request_id    | String                                                                       | 请求ID。      |
     
   表3VpnAccessPolicy 
  | 名称              | 类型              | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
  |:---|:---|:---|
  | id              | String          | - 功能描述：访问策略ID。  - 格式：36位UUID。                                                                                                                                                                                                                                                                               |
  | name            | String          | 访问策略名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
  | type            | String          | - 功能说明：访问策略类型。  - 取值范围： - Default  - Custom     |
  | 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": "4f746482-a575-4e1f-9e80-5f6f69ff8588",
          "name": "policy-001",
          "type": "Custom",
          "user_group_id": "7625fd92-2e20-4e4d-8c56-66f110fbfaa8",
          "user_group_name": "user-group1",
          "description": "访问策略1",
          "dest_ip_cidrs": [
              "172.16.0.0/24",
              "172.16.1.0/24"
          ],
          "created_at": "2024-06-17T13:32:19.57Z",
          "updated_at": "2024-06-17T13:32:19.57Z"
      },
      "request_id": "85657002f01c35576606003cc36114ab"
  }
  ```
  
 
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。