ActiveGate API - DELETE an auto-update job
Deletes the specified ActiveGate auto-update job.
| DELETE | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/{jobId} |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/{agId}/updateJobs/{jobId} | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/{jobId} |
Authentication
To execute this request, you need Write ActiveGates (activeGates.write) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| agId | string | The ID of the required ActiveGate. | path | optional |
| jobId | string | A unique identifier for a update-job of ActiveGate. | path | optional |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 204 | - | Success. The update-job have been deleted. Response doesn't have a body. |
| 400 | Error | Failed. The input is invalid. |
| 404 | Error | Not found. See response body for details. |
Example
In this example, the request deletes the update job with the ID of -7240069678607892845 from the ActiveGate with the ID of 1812885988. The response code of 204 indicates that the deletion was successful.
The API token is passed in the Authorization header.
Curl
curl -L -X DELETE 'https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/1812885988/updateJobs/-7240069678607892845' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'Request URL
https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/1812885988/updateJobs/-7240069678607892845Response code
204