文档中心

Web应用防火墙

域名组管理

UpdateHostGroup - 更新域名组

UpdateHostGroup 接口支持通过域名组 ID 更新指定域名组信息，包括域名组名称、域名组列表等。

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：UpdateHostGroup

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

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

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

Body

Action String 可选示例值：Add

域名列表修改动作

Add：增加域名

Delete：删除域名

ALL：覆盖全部域名

不填写：不修改域名信息

ProjectName String 可选示例值：Project1

项目名称。

Description String 可选示例值：用于批量关联禁止访问名单。

域名组描述。

HostGroupID Integer 必选示例值：1234

需要更新的域名组 ID，可通过查询域名组接口获取。

HostList String[] 可选示例值：["volcwaf.com","www.testwaf.com"]

域名列表信息。

Name String 可选示例值：重点防护域名

域名组名称。

返回参数

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

错误码

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

输入示例 1

输入示例

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

{
    "Action": "Add",
    "ProjectName": "Project1",
    "Description": "用于批量关联禁止访问名单。",
    "HostGroupID": 1234,
    "HostList": [
        "volcwaf.com",
        "www.testwaf.com"
    ],
    "Name": "重点防护域名"
}

输出示例

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

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

这个页面对您有帮助吗？

有用

无用