AddIpGroup-创建地址组--Web应用防火墙-火山引擎

文档中心

立即注册

导航

Web应用防火墙

AddIpGroup-创建地址组

最近更新时间：2024.03.01 16:47:39首次发布时间：2024.02.01 14:25:21

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

注意事项

每个地域下最多支持添加 100 个地址组。
不同版本的实例下，地址组支持添加的 IP 地址数量不同。

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

请求说明

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

请求参数

参数	类型	是否必填	示例值	描述
Name	String	是	`123`	地址组名称，支持英文、汉字和数字，不支持特殊字符。长度限制在 25 个字符内。
AddType	String	是	`List`	添加方式。 List：手动添加 File：文件上传
IpList	Array of Strings	是	`["1.2.3.4","5.6.7.8"]`	需要添加的 IP 地址。支持输入 IP 地址或 IP 地址段。支持输入 IPv4 和 IPv6。

参数

类型

是否必填

示例值

描述

Name

String

是

123

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

AddType

String

是

List

添加方式。

List：手动添加
File：文件上传

IpList

Array of Strings

是

["1.2.3.4","5.6.7.8"]

需要添加的 IP 地址。

支持输入 IP 地址或 IP 地址段。
支持输入 IPv4 和 IPv6。

返回参数

参数	类型	示例值	描述
IpGroupId	Integer	`1526`	地址组 ID。

请求示例

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

{
  "Name":"123"，
  "AddType":"List"，
  "IpList":["1.2.3.4","5.6.7.8"]
}

返回示例

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