Example of Accessing the API with cURL

The following example shows how to install an uploaded OS image onto the backup OS partition by submitting a POST request on the REST resource using cURL. If the request requires a timestamp, use the timestamp from the response of the /login API. For more information about cURL, see Use cURL.

curl -X POST \
    -b cookies.txt \
    -d@request.json \
    --header "Content-Type: application/json" \
    "https://$IPADDR/restapi/os_partition/install_image"

The following shows an example of the contents of the request.json file sent as the request body.

{
  "timestamp":<timestamp>
}

Example of the Response Headers

The following shows an example of the response headers.

HTTP/1.1 200 OK
Date: Thu, 17 Dec 2020 17:57:25 GMT
Server: Apache/2.4.6 () OpenSSL/1.0.2k-fips mod_fcgid/2.3.9 PHP/5.4.40

Example of the Response Body

The following example shows the contents of the response body in JSON format.

{
  "status": "fail",
  "message": "The Change OS Partition button has previously been pressed, and the Backup partition is selected for the next reboot as signified by an asterisk (*) in the OS Partition Versions section. In order to re-enable the upload and install controls, change the next boot OS back to the Active by pressing the Change OS Partition button."
}