cis tasks: cancel
Cancel a running operation associated with the task. This is the best effort attempt. Operation may not be cancelled anymore once it reaches certain stage. This operation was added in vSphere API 6.7.1.
Request:
HTTP request
POST https://{server}/rest/cis/tasks/{task}?action=cancel
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| task | string | Task identifier. |
Response:
HTTP Status Code: 200
NoneErrors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 500 | error | if the system reports an error while responding to the request. |
| 400 | not_allowed_in_current_state | if the task is already canceled or completed. |
| 404 | not_found | if the task is not found. |
| 500 | resource_inaccessible | if the task's state cannot be accessed. |
| 503 | service_unavailable | if the system is unable to communicate with a service to complete the request. |
| 401 | unauthenticated | if the user can not be authenticated. |
| 403 | unauthorized | if the user doesn't have the required privileges. |
| 400 | unsupported | if the task is not cancelable. |