GET /signingCertificate/jobs/<job_id>

Use the PUT method to retrieve information about a specific job for provisioning a signing certificate to managed devices.

Note: This API requires Lenovo XClarity Administrator v1.2.0 or later.

Authentication

Authentication with user name and password is required.

Request URL

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

where <job_id> is the job ID that was returned by the PUT /signingCertificate method.

Query parameters

None

Response codes

Code Description
200 OK. The request completed successfully.
500 Internal server error. For more information, see the error message 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

  • CancelledWithErrors

  • CancelledWithWarning

  • Cancelling

  • Complete

  • CompleteWithErrors

  • CompleteWithWarnings

  • Expired

  • Initializing

  • Interrupted

  • InterruptedWithError

  • InterruptedWithWarning

  • Investigating

  • Pending

  • Resolved

  • Running

  • RunningWithErrors

  • RunningWithWarnings

  • Skipped

  • Stop

  • StoppedWithError

  • StoppedWithWarnings

  • Unknown

  • Uploading

  • Validating

  • Waiting

  • Working

      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

  • CancelledWithErrors

  • CancelledWithWarning

  • Cancelling

  • Complete

  • CompleteWithErrors

  • CompleteWithWarnings

  • Expired

  • Initializing

  • Interrupted

  • InterruptedWithError

  • InterruptedWithWarning

  • Investigating

  • Pending

  • Resolved

  • Running

  • RunningWithErrors

  • RunningWithWarnings

  • Skipped

  • Stop

  • StoppedWithError

  • StoppedWithWarnings

  • Unknown

  • Uploading

  • Validating

  • Waiting

  • Working

        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 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

Response example