GET /updateRepositories/firmware/status

Use this GET method to retrieve the status for a repository task.

Note: This API requires Lenovo XClarity Administrator v2.3.0 or later.

Authentication

Authentication with user name and password is required.

Request URL

GET https://<management_server_IP>/updateRepositories/firmware/status

Query parameters

Parameters Required / Optional Description
taskType=EXPORTREPOSITORY Required Type of repository task for which to retrieve status. This can be the following value.
  • EXPORTREPOSITORY. Returns status for an export task.​

taskid=<task_id> Required Job (task) ID that is returned by the PUT /updateRepositories/firmware?action=export method for collecting (exporting) firmware updates and UpdateXpress System Packs (UXSPs) in a .zip file. If 0 is specified, the status for all running tasks is returned.
The following example returns the status for a specific export job.
GET https://192.0.2.0/updateRepositories/firmware/status?tasktype=EXPORTREPOSITORY&taskid=12

Request body

None

Response codes

Code Description
200 OK
400 Bad request
403 Forbidden
409 Conflict
500 Internal server error

Response body

Attributes Type Description
current String Name of the ZIP file
downloadednum Integer Number of firmware-update and UXSPs that is currently exported
Tip: After the export is complete, the download number is the same as the total.
downloadedsize Integer Size of the .zip file that is currently exported
Tip: After the export is complete, the download size is the same as the total size.
progress Integer Percentage complete of the bulk management job. This can be one of the following values
  • 0. Created.

  • 50. In progress.

  • 100. Complete.

state String This can be one of the following values.
  • canceled. The request was canceled.

  • complete. The request completed successfully.

  • error. The request encountered an error.

taskIds String ID of the task that collected the files.
total Integer Total number of firmware-update and UXSPs in the .zip file
totalsize Integer Total size of the .zip file
updates Array  
errorMsg Array Information about one or more messages.
  messages Array Message.
    id String The message identifier of a returned message.
    text String Message text associated with the message identifier.
  result String The results of the request . This can be one of the following values.
  • success. The request completed successfully.

  • failure. The request failed. A descriptive error message is returned.

  • informational

Response example

The following example returns the export status when the export completed successfully.

{
   "current": "repository20181112011742.zip",
   "downloadednum": 0,
   "downloadedsize": 8298,
   "progress": 100,
   "state": "complete",
   "taskIds": "",
   "total": 0,
   "totalsize": 8298,
   "updates": [],
   "errorMsg": {
      "result": "informational",
      "messages": [{
         "id": "FQXHMUP2500I",
         "text": "Repository operation completed successfully."
      }]
   }
}