You need to enable JavaScript to run this app.
Torch Log Service

Torch Log Service

Copy page
Download PDF
Host group management API
DeleteHostGroup
Copy page
Download PDF
DeleteHostGroup
Call the DeleteHostGroup interface to delete the host group.​
Usage notes​
The call frequency limit is 20 times/s, and exceeding the frequency limit will report an error ExceedQPSLimit.​
tip​
  • After deleting a host group, its corresponding hosts will stop collecting and reporting log data.​
  • If the collection configuration is associated with multiple host groups, after deleting one of them, the other host groups will continue to collect according to the specified rules.​
Request syntax​
  • Request Method: DELETE​
  • Request URL: https://{tls-endpoint}/DeleteHostGroup​
Request parameters​
The table below only lists the request parameters specific to this interface and some common parameters. For more information, please see Common parameters.​
Body​
​
Name​
Type​
Required​
Example​
Description​
HostGroupId​
String​
True​
c7********​
The ID of the host group.​
​
Responses​
There are no unique return parameters for this interface. For more information, please refer to the Response message.​
Sample Request​
​
DELETE https://{tls-endpoint}/DeleteHostGroup HTTP/1.1​
Content-Type: application/json​
{​
"HostGroupId": "c7**********"​
}​
​
Sample Response​
​
HTTP/1.1 200 OK​
Content-Type: application/json; charset=utf-8​
​
Error code​
The following table lists the error codes related to the interface and business logic. For common error codes, please refer to the Common error codes.​
​
HTTP status code​
Error code​
Error message​
Description​
400​
InvalidArgument​
Invalid argument key %s, value %s, please check argument.​
Parameter is invalid.​
404​
HostGroupNotExist​
HostGroup %s does not exist​
The host group does not exist​
500​
InternalServerError​
We encountered an unexpected server error, please try again later.​
Internal server error.​
​
​
​
Last updated: 2025.10.28 18:41:59