Docs

Web Application Firewall

Domain group management

UpdateHostGroup

The UpdateHostGroup API supports updating the specified domain group information by domain group ID, including the domain group name, domain group list, and more.

HTTP request

Method: POST

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

Request parameters

The following table lists only the request parameters specific to this API and some common parameters. For more information, see Common parameters.

Query

Action String required Sample value: UpdateHostGroup

API name. The current API name is UpdateHostGroup.

Version String required Sample value: 2023-12-25

API version. The current API version is 2023-12-25.

Body

Action String Optional Sample value: Add

Action for modifying the domain list

Add: Add domain

Delete: Delete domain

ALL: Overwrite all domains

Leave blank: Do not modify domain information

ProjectName String Optional Sample value: Project1

Project name.

Description String Optional Sample value: Used for batch association with blocklist.

Domain group description.

HostGroupID Integer required Sample value: 1234

The domain group ID to be updated, which can be obtained through the Query domain group API.

HostList String[] Optional Sample value: ["volcwaf.com","www.testwaf.com"]

Domain list information.

Name String Optional Sample value: Key protected domain name

Domain group name.

Response parameters

This API has no specific response parameters. For more information, see Response structure.

Error codes

You can visit Common error codes to get more error code information.

Sample 1

Request

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

{
    "Action": "Add",
    "ProjectName": "Project1",
    "Description": "Batch lists",
    "HostGroupID": 1234,
    "HostList": [
        "volcwaf.com",
        "www.testwaf.com"
    ],
    "Name": "keyDomainNames"
}

Response

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

Last updated: 2026.04.22 17:27:29