文档中心

Web应用防火墙

地址组管理

AddIpGroup - 创建地址组

创建地址组。您可以通过手动添加或上传文件的方式创建地址组，上传文件需要满足模板设定的要求。本文介绍通过手动添加的方式上传 IP 地址组。

注意事项

每个地域下最多支持添加 100 个地址组。

不同版本的实例下，地址组支持添加的 IP 地址数量不同。

实例版本	每个地址组支持的 IP 数量
基础版	10 条
高级版	100 条
企业版	500 条
旗舰版	1000 条

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：AddIpGroup

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

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

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

Body

Name String 必选示例值：group1

地址组名称，支持英文、汉字和数字，不支持特殊字符。长度限制在 25 个字符内。

ProjectName String 可选示例值：default

资源所属项目名称。获取方式可参考ListProjectResources - 获取项目资源列表。

AddType String 必选示例值：List

添加方式。

List：手动添加

File：文件上传

IpList String[] 可选示例值：["1.2.**.**","5.6.**.**"]

需要添加的 IP 地址。

支持输入 IP 地址或 IP 地址段。

支持输入 IPv4 和 IPv6。

返回参数

IpGroupId Integer 可选示例值：1526

地址组 ID。

错误码

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

输入示例 1

输入示例

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

{
    "Name": "group1",
    "ProjectName": "default",
    "AddType": "List",
    "IpList": [
        "1.2.**.**",
        "5.6.**.**"
    ]
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "AddIpGroup",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": {
        "IpGroupId": 1526
    }
}

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

这个页面对您有帮助吗？

有用

无用