查询VPN访问策略列表 - QueryAccessPolicies

功能介绍

通过VPN服务端ID，查询VPN访问策略列表。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
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获取项目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。

表4 VpnAccessPolicy
名称	类型	描述
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。

表5 PageInfo
名称	类型	描述
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"
}