Host Log Monitoring API - DELETE analysis job

Deletes or cancels the specified log analysis job.

The request produces an application/json payload.

DELETE

Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}
SaaS https://{your-environment-id}.live.dexp.ae/api/v1/entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}

To execute this request, you need the Access logs permission assigned to your API token. See the Authentication page to learn how to obtain and use it.

Parameters

Parameter Type Description In Required

hostId

string

Parameter	Type	Description	In	Required
hostId	string	The entity ID of the required host.	path	required
jobId	string	The ID of the log analysis job to be deleted. You can retrieve it from the response of the `POST /entity/infrastructure/hosts/{hostId}/logs/{logPath}` request.	path	required

The entity ID of the required host.

path

required

jobId

string

The ID of the log analysis job to be deleted.

You can retrieve it from the response of the POST /entity/infrastructure/hosts/{hostId}/logs/{logPath} request.

path

required

Response format

Parameters JSON model

Element	Type	Description
message	string	The message on successful job deletion.

{
  "message": "Job has been deleted successfully"
}

Example

In this example the request deletes the log analysis job with the ID 32502e45-ed3d-47b9-b150-23e787ee285e.

The API token is passed in the Authorization header.

The response confirms job deletion.

Curl

curl -X DELETE \
  https://mySampleEnv.live.dexp.ae/api/v1/entity/infrastructure/hosts/HOST-FE05D86A03025CAA/logs/jobs/32502e45-ed3d-47b9-b150-23e787ee285e \
  -H 'Authorization: Api-Token abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dexp.ae/api/v1/entity/infrastructure/hosts/HOST-FE05D86A03025CAA/logs/jobs/32502e45-ed3d-47b9-b150-23e787ee285e

Response content

{
  "message": "Job has been deleted successfully"
}

Response code

200