更新时间:2024-11-29 GMT+08:00

修改VPN访问策略

功能介绍

根据VPN访问策略ID,修改指定的访问策略。

调用方法

请参见如何调用API

URI

PUT /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。

请求消息

  • 请求参数
    表2 请求参数

    名称

    类型

    必选

    描述

    access_policy

    UpdateVpnAccessPolicyRequestBodyContent object

    更新访问策略请求体对象。

    表3 UpdateVpnAccessPolicyRequestBodyContent

    名称

    类型

    必选

    描述

    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。

    表5 VpnAccessPolicy

    名称

    类型

    描述

    id

    String

    • 功能描述:访问策略ID。
    • 格式:36位UUID。

    name

    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:ssZ

    updated_at

    String

    • 功能说明:更新时间。
    • UTC时间格式:yyyy-MM-ddTHH:mm:ssZ
    • 响应示例
      {
          "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"
      }

状态码

请参见状态码