文档首页/ 虚拟专用网络 VPN/ API参考/ API/ 终端入云VPN API/ 访问策略/ 查询VPN访问策略 - QueryAccessPolicy
更新时间:2026-04-24 GMT+08:00

查询VPN访问策略 - QueryAccessPolicy

功能介绍

根据访问策略ID,查询VPN访问策略。

调用方法

请参见如何调用API

授权信息

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

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

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获取项目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。

    表3 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
  • 响应样例
    {
        "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"
    }

状态码

请参见状态码