PUT /tasks

Use this PUT method to cancel one or more jobs (tasks).

  • This API requires Lenovo XClarity Administrator v1.2.0 or later.

  • Deleting one or more task using this API is no longer supported. Use DELETE /tasks/<job_list> instead.


Authentication with user name and password is required.

Request URL

PUT https://<management_server_IP>/tasks

Query parameters


Request body

Table 1. Cancel one or more jobs
Attributes Required / Optional Type Description
action Required String Action to take. This can be the following value.
  • cancel. Cancels the specified jobs.

list Required Array of strings One or more job IDs
The following example cancels a single job.
   "action": "cancel",
   "list": ["83"]

Response codes

Code Description
200 OK
400 Bad request
401 Unauthorized. The user could not be authenticated.
403 Forbidden. The server could not authenticate this session.
412 Precondition failed.
500 Internal server error. An internal error occurred.

Response body