Deletes a machine group. If a Logtail configuration file for log collection is applied to the machine group, the configuration file is disassociated from the machine group after the machine group is deleted.
Request syntax
DELETE /machinegroups/{groupName} HTTP/1.1
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
Request elements
- Request headers
The DeleteMachineGroup API operation does not have operation-specific request headers. For information about the common request headers of Log Service API operations, see Common request headers.
- Parameters
Parameter Type Required Example Description groupName string Yes test-machine-group-4 The name of the machine group.
Response elements
- Response headers
The DeleteMachineGroup API operation does not have operation-specific response headers. For information about common response headers of Log Service API operations, see Common response headers.
- Response parameters
The HTTP status code 200 is returned.
Examples
- Sample requests
DELETE /machinegroups/test-machine-group-4 HTTP/1.1 Header : { "x-log-apiversion": "0.6.0", "Authorization": "LOG <yourAccessKeyId>:<yourSignature>", "Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com", "Date": "Tue, 10 Nov 2015 19:13:28 GMT", "Content-Length": "0", "x-log-signaturemethod": "hmac-sha1", "User-Agent": "sls-java-sdk-v-0.6.0", "Content-Type": "application/x-protobuf", "x-log-bodyrawsize": "0" }
- Sample success responses
HTTP/1.1 200 OK Header : { "Date": "Tue, 10 Nov 2015 19:13:28 GMT", "Content-Length": "0", "x-log-requestid": "564241D899248C827B000CFE", "Connection": "close", "Server": "nginx/1.6.1" }
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
404 | GroupNotExist | group {GroupName} does not exist. | The error message returned because the specified machine group does not exist. |
500 | InternalServerError | internal server error. | The error message returned because an internal server error has occurred. |
For more information about the error codes, see Common error codes.