UpdateCustomPage - 更新自定义响应拦截规则--Web应用防火墙-火山引擎

文档中心

立即注册

导航

UpdateCustomPage - 更新自定义响应拦截规则

最近更新时间：2025.07.07 15:00:47首次发布时间：2024.02.01 14:25:21

调用 UpdateCustomPage 接口更新自定义响应拦截规则。

请求说明

请求方式：POST
请求地址：https://waf.volcengineapi.com/?Action=UpdateCustomPage&Version=2023-12-25

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	UpdateCustomPage	要执行的操作，取值：UpdateCustomPage。
Version	String	是	2023-12-25	API的版本，取值：2023-12-25。

Body

参数	类型	是否必填	示例值	描述
Policy	Integer	是	1	执行策略动作： 1 : 观察 8：拦截
RedirectUrl	String	否	/test/Path1	重定向匹配路径，`PageMode=2`时需要填写。
Id	Integer	是	1876	规则 ID，获取方式可参考ListCustomPage-查询自定义响应拦截规则详情。
GroupId	Integer	否	9922	高级条件规则组 ID，获取方式可参考ListCustomPage-查询自定义响应拦截规则详情。
Advanced	Integer	否	1	是否配置高级条件。 0：否 1：是
Body	String	否	!!! 系统禁止访问	页面内容。当`PageMode=0`时，需要传入的内容为固定模板。 text/html：`<!DOCTYPE html> <html> <meta charset="utf-8"> <body> <p> !!! 系统禁止访问 </p> </body> </html>` text/xml：`<?xml version="1.0" encoding="UTF-8"?><body> !!! 系统禁止访问 </body>` application/json：`{"Content":"!!! 系统禁止访问"}` 当`PageMode=1`时，支持自定义内容。
ContentType	String	否	text/html	页面类型。 text/html text/xml application/json
PageMode	Integer	是	0	响应页面模板。 0：系统默认 1：自定义 2：重定向
Code	Integer	是	403	自定义 HTTP 返回码。
Enable	Integer	是	1	规则开关，默认为开启。 0：关闭 1：开启
Url	String	是	/test	匹配路径。支持通配符``，``只能出现一次。某个具体的 URL 地址，例如需要放行`test.com/test.html`，则填写`/test.html`。针对整个网站，则填写``即可。某个路径前缀适配的所有地址，例如`/test/`。
Description	String	否	增加一条自定义响应拦截规则。	规则备注。
Name	String	是	自定义规则1	规则名称，支持英文、汉字、数字, 不支持特殊字符，长度限制在 20 个字符内。
ClientIp	String	是	ALL	生效 IP 范围，需填写 `ALL`，即对所有 IP 生效。
Host	String	是	example.volcwaf001.com	防护规则关联的域名。
ProjectName	String	否	default	所属项目资源名称，获取方式可参考ListDomain-查询云 WAF 实例防护网站信息。
Accurate	Object	否	--	高级条件详情，`Advanced=1`时需要填写。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=UpdateCustomPage&Version=2023-12-25 HTTP/1.1
Host: waf.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250626T073559Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250626/cn-beijing/waf/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "Policy": 1,
  "RedirectUrl": "/test/Path1",
  "Id": 1876,
  "GroupId": 9922,
  "Advanced": 1,
  "Body": "<!DOCTYPE html> <html> <meta charset=\"utf-8\"> <body> <p> !!! 系统禁止访问 </p> </body> </html>",
  "ContentType": "text/html",
  "PageMode": 0,
  "Code": 403,
  "Enable": 1,
  "Url": "/test",
  "Description": "增加一条自定义响应拦截规则。",
  "Name": "自定义规则1",
  "ClientIp": "ALL",
  "Host": "example.volcwaf001.com",
  "ProjectName": "default",
  "Accurate": {
    "Logic": 1,
    "AccurateRules": [
      {
        "ValueString": "http",
        "Opretar": 2,
        "ObjType": 0,
        "HttpObj": "request.schema",
        "Property": 0
      }
    ]
  }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240104161554508548FB743E0FDB****",
        "Action": "UpdateCustomPage",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": null
}

错误码

您可访问公共错误码，获取更多错误码信息。