AddProhibitionBlack-永久封禁 IP--Web应用防火墙-火山引擎

文档中心

立即注册

导航

Web应用防火墙

AddProhibitionBlack-永久封禁 IP

最近更新时间：2025.05.30 18:16:50首次发布时间：2023.11.10 18:24:49

将封禁列表中的 IP 永久封禁。封禁成功后，该 IP 状态将变成“已永久封禁”，且被添加至访问黑名单，该 IP 对当前域名的访问行为将由 WAF 直接拦截。

请求说明

请求方式：POST
请求地址：https://waf.volcengineapi.com/?Action=AddProhibitionBlack&Version=2020-12-09

请求参数

参数	类型	是否必填	示例值	描述
Iplist	Array of strings	是	`["1.1.1.1", "1.1.1.2"]`	需要永久封禁的 IP 地址信息。
Host	String	是	`example.volcwaf001.com`	对应的防护网站域名。

返回参数

参数	类型	示例值	描述
IpSuccess	Array of strings	`["1.1.1.1", "1.1.1.2"]`	已经被永久封禁的 IP 地址信息。
IpFaild	Array of strings	`["1.1.1.3"]`	封禁失败的 IP 地址信息。`null`表示全部封禁成功。

请求示例

POST https://waf.volcengineapi.com/?Action=AddProhibitionBlack&Version=2020-12-09
X-Date: 20230711T035055Z
Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-beijing/waf/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8***

{
  "Iplist": [
    "19.252.**.**",
    "19.252.**.**"
  ],
  "Host": "example.volcwaf001.com"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20231010150810003BD36578B25ED3****",
        "Action": "AddProhibitionBlack",
        "Version": "2020-12-09",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": {
        "IpSucess": [
            "19.252.**.**",
            "19.252.**.**"
        ],
        "IpFaild": null
    }
}