# 查询VPN访问策略列表 - QueryAccessPolicies
#### 功能介绍
通过VPN服务端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:listAccessPolicies | list | p2cVpnGateway | g:ResourceTag/\<tag-key\> | -  | -      |
   
#### URI
GET /v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/access-policies
表1参数说明 
| 名称            | 类型     | 是否必选 | 描述                                                                                  |
|:---|:---|:---|:---|
| project_id    | String | 是    | 项目ID，可以通过[获取项目ID](https://support.huaweicloud.com/api-vpn/vpn_api_0051.html)获取项目ID。 |
| vpn_server_id | String | 是    | VPN服务端ID。                                                                           |
   
表2请求Query参数列表 
| 名称     | 类型      | 是否必选 | 描述                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| limit  | Integer | 否    | 分页查询时每页返回的记录数量。                                                                                                                                                                                                                                                                                                                                    |
| marker | String  | 否    | - 功能说明：查询本页的起始标记位，为空时为查询第一页。查询下一页的marker可以根据上一页响应的page_info对象中的next_marker填写。  - 约束：必须与limit一起使用。   |
   
#### 请求消息
- 请求参数 无。
  
- 请求样例
  ```
  GET https://{Endpoint}/v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/access-policies
  ```
  
 
#### 响应消息
- 响应参数 返回状态码为 200：查询成功。
  表3响应Body参数列表 
  | 名称              | 类型                                                                                    | 描述        |
  |:---|:---|:---|
  | access_policies | Array of [VpnAccessPolicy] objects | 访问策略对象列表。 |
  | total_count     | Integer                                                                               | 访问策略总数。   |
  | page_info       | [PageInfo] object                    | 分页查询页的信息。 |
  | request_id      | String                                                                                | 请求ID。     |
     
   表4VpnAccessPolicy 
  | 名称              | 类型              | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
  |:---|:---|:---|
  | 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*。                                                                                                                                                                                                                                                    |
     
   表5PageInfo 
  | 名称            | 类型      | 描述                                |
  |:---|:---|:---|
  | next_marker   | String  | 下一页的marker，值为上一次查询响应中最后一个资源的创建时间。 |
  | current_count | Integer | 当前列表中资源数量。                        |
     
  
 
- 响应样例
  ```
  {
      "access_policies": [
          {
              "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"
          }
      ],
      "total_count": 1,
      "page_info": {
          "current_count": 1
      },
      "request_id": "02b5b35cab4c2963d1d89560f50017b9"
  }
  ```
  
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。