GET /users/{uid}/appliances/{aid}/pimages/{pitid}/downloads
Summary
- Method:
GET
- Response Code:
200 / 304
- Response Formats:
*/*
- Since:
UForge 3.0
Downloads a published machine image.
This request is the same as machineImage-downloadFile
Note
You can only download a published machine image if the initial machine image generation request included the compress
flag. For more information, see machineImage-generate
.
The published machine image can be downloaded without authentication if an downloadId
is added as a query parameter
. To retrieve the downloadId, use machineImagePublished-getAll
.
Note
The downloadId
can only be used once, afterwards it expires, and a new downloadId
must be retrieved.
- Requires Authentication:
false
- Entitlements Required:
None
uid
(required): the user name (login name) of theuser-object
aid
(required): the id of theappliance-object
pitid
(required): the id of thepublishimage-object
None
curl "https://uforge.example.com/api/users/{uid}/appliances/{aid}/pimages/{pitid}/downloads" -X GET \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml"
appliance-object
machineImageGeneration-cancel
machineImagePublishedStatus-getAll
machineImagePublished-deleteAll
machineImagePublished-getAll
machineImageStatus-get
machineImageStatus-getAll
machineImage-delete
machineImage-deleteAll
machineImage-download
machineImage-downloadFile
machineImage-generate
machineImage-get
machineImage-getAll
machineImage-publish
machineImage-regenerate
publishimage-object