machineImage_downloadFile

GET /users/{uid}/appliances/{aid}/images/{itid}/downloads/{fileName}

Downloads a generated machine image.

This request is the same as machineImage_download

Note

You can only download a generated machine image if the initial generation request included the compress flag. For more information, see machineImage_generate.

The machine image can be downloaded without authentication if an downloadId is added as a query parameter. To retrieve the downloadId, use machineImage_get.

Note

The downloadId can only be used once, afterwards it expires, and a new downloadId must be retrieved.

Security Summary

  • Requires Authentication: false
  • Entitlements Required: None

URI Parameters

  • uid (required): the user name (login name) of the user
  • fileName (required): the file name of the machine image
  • itid (required): the id of the image
  • aid (required): the id of the appliance

HTTP Request Body Parameters

None

Example Request

curl "https://uforge.example.com/api/users/{uid}/appliances/{aid}/images/{itid}/downloads/{fileName}" -X GET \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml"