文档中心

Web应用防火墙

封禁管理

DeleteProhibitionBlack - 取消永久封禁 IP

取消已经永久封禁的攻击源 IP。取消永久封禁后，IP 的状态会变为“已取消封禁”。

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：DeleteProhibitionBlack

接口名称。当前 API 的名称为 DeleteProhibitionBlack。

Version String 必选示例值：2023-12-25

接口版本。当前 API 的版本为 2023-12-25。

Body

Host String 必选示例值：example.volcwaf001.com

对应的防护网站域名。

IpList String[] 必选示例值：["1.2.**.**"]

IP 列表。

ProjectName String 可选示例值：default

项目名称，即为当前资源关联对应项目，仅可关联当前身份下具有权限的项目。项目名称获取方式可参考ListProjectResources - 获取项目资源列表。

返回参数

IpFailed Object[] 可选示例值：["1.1.**.**"]

操作失败的 IP 地址信息。返回 null 表示所有 IP 操作成功。

Ip String 可选示例值：1.1.**.**

操作失败的 IP。

Reason String 可选示例值：demoReason

失败原因。

RuleName String 可选示例值：demoName

失败的规则名称。

RuleTag String 可选示例值：F000000001193

失败的规则 ID。

IpSuccess String[] 可选示例值：["1.2.**.**"]

操作成功的 IP 地址。

错误码

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

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=DeleteProhibitionBlack&Version=2023-12-25

{
    "Host": "example.volcwaf001.com",
    "IpList": [
        "1.2.**.**"
    ],
    "ProjectName": "default"
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "DeleteProhibitionBlack",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": {
        "IpFailed": null,
        "IpSuccess": [
            "1.2.**.**"
        ]
    }
}

最近更新时间：2026.01.20 15:17:10

这个页面对您有帮助吗？

有用

无用