修改VPN访问策略 - UpdateAccessPolicy

功能介绍

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

调用方法

请参见如何调用API。

授权信息

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

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

URI

PUT /v5/{project_id}/p2c-vpn-gateways/vpn-servers/{vpn_server_id}/access-policies/{policy_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	访问策略名称。
  type	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:ss.SSSZ。
  updated_at	String	功能说明：更新时间。 UTC时间格式：yyyy-MM-ddTHH:mm:ss.SSSZ。

  • 响应示例

    {
        "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"
    }

状态码

请参见状态码。