GET /serverCertificate/jobs/`{job_id}`

Use the PUT method to retrieve information about a specific job for provisioning a signed server certificates to all managed devices.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/serverCertificate/jobs/{job_id}

where {job_id} is the job ID that was returned by the POST /serverCertificate/tmp method.

Query parameters

None

Response codes

Code	Description	Comments
200	OK	The request completed successfully.
500	Internal Server Error	An internal error occurred. A descriptive error message is returned in the response body.

Response body

Attributes						Type	Description
response						Array of objects	Response content
	progress					Double	Percentage complete of the job. This can be one of the following values. 0. Created 50. In progress. 100. Complete.
	result					Array	Information about the job results. There is one entry for each managed device on which cryptographic settings are being changed.
		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.security.base.bundle.tasks.messages.
		messageID				String	Message ID for the set of job tasks
		messageAttributes				String	UUID that is associated with the job
		progress				Long	Percentage complete of the job. This value can be `0` -`100`
		result				String	Result of the request. This can be one of the following values. SUCCESS
		resultShortDescription				String	Short description of the result
		resultLongDescription				String	Long description of the result
		status				Object	Information about the current status of the job
			description			Array
				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.security.base.bundle.tasks.messages.
				messageDisplay		String	Translated label that corresponds to the message ID or to the pre-translated backup string if no message ID is specified
				messageID		String	Message ID for the set of job tasks
				messageTime		String	Time when this message was generated
			percentage			Long	Percentage complete of the job
			state				State of the job. This can be one of the following values. Aborted Blocked Cancelled CancelledWithError CancelledWithWarning Cancelling Complete CompleteWithError CompleteWithWarning Expired Initializing Interrupted InterruptedWithError InterruptedWithWarning Investigating Pending Resolved Running RunningWithError RunningWithWarning Skipped Stopped StoppedWithError StoppedWithWarning Unknown Uploading Validating Waiting
			substatus			Array	Information about each step in the overall task. There is one entry for each step.
				completed		Boolean	Indicates whether the step completed. This can be one of the following values. true. The step has completed. false. The task has not completed.
				id		String	Short name of the 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.security.base.bundle.tasks.messages.
				messageID		String	Message ID for the task
				progress		String	Progress of the task
				shortDescription		String	Short message description
				started		Boolean	Indicates if the management step has started. This can be one of the following values. true. The step has started. false. The step has not started.
				status		Object
					percentage	Integer	Percentage complete of the task
					state	String	State of the task. This can be one of the following values. Aborted Blocked Cancelled CancelledWithError CancelledWithWarning Cancelling Complete CompleteWithError CompleteWithWarning Expired Initializing Interrupted InterruptedWithError InterruptedWithWarning Investigating Pending Resolved Running RunningWithError RunningWithWarning Skipped Stopped StoppedWithError StoppedWithWarning Unknown Uploading Validating Waiting
				userAction		String	Any user action that is required
		taskid				Integer	Name of the job Note This job ID might not be the same as the job ID that is returned by the POST /serverCertificate/tmp method.
		taskName				String	Name of the job
		time_spent				Long	Duration of the task in milliseconds
		uuid				String	UUID of the device for which this job is running
	status					String	Current status of the overall task. This can be one of the following values. CREATED INCOMPLETE DONE
	title					String	Job title. This is always Managed System Cryptography Settings.
result						String	Result of the request . This can be one of the following values. success. The request completed successfully. failure. The request failed. A descriptive error message was returned.
messages						Array	Information about one or more messages
	id					String	Message identifier of a returned message
	text					String	Message text associated with the message identifier
	explanation					String	Additional information to clarify the reason for the message
	recovery					Array	Recovery information
		text				String	User actions that can be taken to recover from the event
		URL				String	Link to the help system for more information, if available

Give documentation feedback

GET /serverCertificate/jobs/{job_id}

Authentication​

Request URL​

Query parameters​

Response codes​

Response body​