/api/space/software-management/packages/{id}/exec-verify

The following operation is supported on this resource:

  • POST - Verify Image on Devices
POST /packages/{id}/exec-verifyVersion 1

This API verifies the software package already staged on the real device (that is, on the physical device). It validates the MD5 checksum of the staged package on the device against the checksum present in the database.

Sample Usage

This API makes an asynchronous method call; so, you can optionally specify queue and schedule parameters:

POST /packages/{id}/exec-verify?queue=<queue>&schedule=<schedule>


Note: The queue URL denoted by <queue> must have been created already.


  • Parameters:
    NameTypeURI TypeDescriptionRequired
    software-package-idintPathThe ID for the software package under operation. Y
    queueQueue URLQueryA fully qualified queue URL, where job progress notifications will be sent (See Asynchronous API Usage)N
    schedulecron-like-expressionQuerySchedule this API in the future, by specifying a cron-like-expression (See Job Scheduling)N
  • Sample Input XML:
    <exec-verify>
      <devices>
        <device href= "/api/space/device-management/devices/458753" />
      </devices>
    </exec-verify>

  • Sample Output XML:
    <task href="/api/space/job-management/jobs/3997704">
      <id>3997704</id>
    </task>

  • Sample Input JSON:
    {
      "exec-verify": {
        "devices": [
          {
            "device": {
                "@href":"/api/space/device-management/devices/458753"
              }
          }
        ]
      }
    }

  • Sample Output JSON:
    {
      "task": {
        "@href":"/api/space/job-management/jobs/3997704",
        "id":3997704
      }
    }

  • Access Control

    The following capabilities are required to access this API: VerifyMD5Cap