GET /unmanageRequest/jobs/`{job_id}`

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

Authentication

Authentication with username 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	Comments
200	OK	The request completed successfully.
400	Bad Request	A query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body.
403	Forbidden	The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request.
404	Not found	A specified resource cannot be found. A descriptive error message is returned in the response body.
409	Conflict	There is a conflict with the current state of the resource. A descriptive error message is returned in the response body.
500	Internal Server Error	An internal error occurred. A descriptive error message is returned in the response body.

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 request started or ended successfully. Warning. The request completed, but there are some problems that you must be aware of . You can decide if action is needed. Critical. The request 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.

The following example is returned if the request is successful.

{
    "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"
}

Give documentation feedback

GET /unmanageRequest/jobs/{job_id}

Authentication​

Request URL​

Query parameters​

Response codes​

Response body​