GET /unmanageRequest/jobs/<job_id>

Use the GET method to monitor the status of an unmanagement request that was made using the POST /unmanageRequest method.

Authentication

Authentication with user name and password is required.

Request URL

GET https://<management_server_IP>/unmanageRequest/jobs/<job_id>

where <job_id> is the job ID that was returned by the POST /unmanageRequest method.

Query parameters

None

Response codes

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

Response body

Attributes Type Description
progress Double Percentage complete of the bulk management job. This can be one of the following values.
  • 0.0. Created.
  • > 0.0. In progress.
  • 100.0. Complete.
result Integer Result of the job. This can be one of the following values.
  • 0. Created.
  • 50. In progress.
  • 100. Complete.
results Array of objects Results of the bulk unmanagement jobs
  messageBundle String Location where messages.properties can be found if it is not located in the default task management bundle. This value is always "com.lenovo.lxca.discovery.bundle.tasks.messages."
  messageID String Message ID ("0509_LONG")
  messageAttributes String This can be one of the following values.
  • deviceIP if not null
  • deviceserial number if not null
  • deviceUUID
  progress Long Percentage complete of the unmanagement job. If the job is complete, "JOB_DONE" is returned.
  result String Result of the request. This can be one of the following values.
  • success. The request was successful.
  • failed. The request failed.
  resultLongDescription String Long description result
  resultShortDescription String Short description resul.
  status Object Status details about the list of management steps
    description Array of objects List of message descriptions
      messageBundle String Location where messages.properties can be found if it is not located in the default task management bundle. This value is always "com.lenovo.lxca.discovery.bundle.tasks.messages."
      messageID String Message ID for the set of unmanagement steps
    percentage Long Percentage complete of the set of unmanagement steps
    state String State of the set of unmanagement steps. The can be one of the following values.
  • RUNNING
  • RUNNING_COMPLETE
  • ERROR
    substatus Array of objects Results of each of the task in the unmanagement job
      completed Boolean Indicates whether the unmanagement step completed. This can be one of the following values.
  • true. The step has completed.
  • false. The step has not completed.
      id String Name of the unmanagement step
      longDescription String Long message description
      messageBundle String Location where messages.properties can be found if it is not located in the default task management bundle. This value is always "com.lenovo.lxca.discovery.bundle.tasks.messages."
      messageID String Message ID of the unmanagement step
      progress Long Progress of the unmanagement step
      shortDescription String Short message description
      started Boolean Indicates whether the unmanagement step has started. This can be one of the following values.
  • true. The step has started.
  • false. The step has not started.
      status Object Status details about the individual management step
        description Array of objects List of message descriptions
          messageBundle String Location where messages.properties can be found if it is not located in the default task management bundle. This value is always "com.lenovo.lxca.discovery.bundle.tasks.messages."
          messageID String Message ID for the set of unmanagement steps
        percentage Long Percentage complete of the unmanagement step
        state String State of the unmanagement step. This can be one of the following values.
  • ERROR
  • PENDING
  • RUNNING
  • RUNNING_COMPLETE
      userAction String Any user action that is required.
    summary Object Information about the job summary
This summary consists of the following types of information.
  • Description. Describes issues that occurred.

  • Actions. Describes whether the job completed successfully, and if not, lists the steps that the user can perform to resolve the issue. You must provide enough information so that the user can resolve the issue without help from the Lenovo Support.

  • Severity. Describes severity of the job.

The job summary is optional for a job that completes successfully; however, it is good practice to set the summary, even when the severity is informational.

      actionArgs Array of strings List of action arguments for the message
      actionBundleKey String Bundle in which the user action is declared
      actionBundleName String Bundle in which the translated user action is located
      actionText String User action to use if there is no translation
      descriptionArgs Array of strings List of arguments for the message
      descriptionBundleKey String Bundle in which the message description is declared
      descriptionBundleName String Bundle in which the translated message description is located
      descriptionText String Message description to use if there is no translation
      severity String Severity of the subtask. This can be one of the following values.
  • Informational. The task started or ended successfully.

  • Warning. The task completed, but there are some problems that the user must be aware of (for example, Windows was deployed but failed to set the IP addresses successfully). The user can decide if action is needed.

  • Critical. The task failed. Action is needed now and the scope is broad (perhaps an imminent outage to a critical resource will result).

  time_spent Long Duration of the task in milliseconds.
  taskid Integer Task ID
  uuid String UUID associated with the unmanagement.
status   Status of the management job. This can be one of the following values.
  • 0. Created.
  • 50. Incomplete.
  • 100. Done.
  • 101. Done_Warnimg.

Response example

{
    "progress": 100.0,
    "results": [{
        "messageBundle": "com.lenovo.lxca.discovery.bundle.rest.messages",
        "messageID": "0509_LONG",
        "messageParameters": "10.240.72.172",
        "progress": 100.0,
        "result": "SUCCESS",
        "resultLongDescription": "The unmanagement job has completed successfully",
        "resultShortDescription": "Success",
        "status": {
            "description": [{
                "messageBundle": "com.lenovo.lxca.discovery.bundle.tasks.messages",
                "messageID": "1028_LONG"
            }],
            "percentage": 100.0,
            "state": "Complete",
            "substatus": [{
                "completed": true,
                "id": "STARTING",
                "longDescription": "Starting device unmanagement job",
                "messageBundle": "com.lenovo.lxca.discovery.bundle.tasks.messages",
                "messageID": "1000_SHORT",
                "progress": 100.0,
                "shortDescription": "Starting",
                "started": true,
                "status": {
                    "percentage": 100.0,
                    "state": "Complete"
                },
                "userAction": ""
            },
            ...
            {
                "completed": true
                "id": "CFG_CABINET",
                "longDescription": "Configuring Hardware location",
                "messageBundle": "com.lenovo.lxca.discovery.bundle.tasks.messages",
                "messageID": "1097_SHORT",
                "progress": 100.0,
                "shortDescription": "Configuring Hardware location",
                "started": true,
                "status": {
                    "percentage": 100.0,
                    "state": "Complete"
                },
                "userAction": "",
            }]
        },
         "summary": {
            "actionArgs": [],
            "actionBundleKey": "",
            "actionBundleName": ""
            "actionText": "",
            "descriptionArgs": [],
            "descriptionBundleKey": "1028_LONG",
            "descriptionBundleName": "com.lenovo.lxca.discovery.bundle.tasks.messages",
            "descriptionText": "The unmanagement job has completed successfully",
            "severity": "Informational",
         }
        "time_spent": 234216,
        "taskid": 18725,
        "uuid": "46920c143355486f97c19a34abc7d746"
    }],
    "status": "DONE"
}