POST /users/{uid}/appliances/{aid}/images
Summary
- Method:
POST
- Response Code:
201
- Response Formats:
application/xml
application/json
- Since:
UForge 1.0
Request to generate a machine image from an appliance.
This response body is an image ticket
that provides the meta-data of the machine image that is to be generated. The actual generation is done asynchronously. To poll the status of this generation, use machineImageStatus-get
.
Once complete, the machine image can be downloaded if the compressed
flag was provided in the request.
To cancel a generation use machineImageGeneration-cancel
Note
to generate a machine image, the appliance
must have as a minimum an os profile
.
- Requires Authentication:
true
- Entitlements Required:
image_generate
uid
(required): the user name (login name) of theuser-object
aid
(required): the id of theappliance-object
A image-object
object
curl "https://uforge.example.com/api/users/{uid}/appliances/{aid}/images" -X POST \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml"-H "Content-type: application/xml" --data-binary "@representation.xml"
Example of representation.xml content (the request body):
<ns0:image xmlns:ns0="http://www.usharesoft.com/uforge">
<compress>true</compress>
<targetFormat>
<name>VirtualBox</name>
</targetFormat>
<installProfile>
<memorySize>512</memorySize>
</installProfile>
</ns0:image>
appliance-object
applianceImage-publish
image-object
imagepkgs-object
machineImageFile-download
machineImageGeneration-cancel
machineImagePkg-getAll
machineImagePublish-cancel
machineImagePublishedStatus-get
machineImagePublishedStatus-getAll
machineImagePublished-delete
machineImagePublished-deleteAll
machineImagePublished-download
machineImagePublished-get
machineImagePublished-getAll
machineImageStatus-get
machineImageStatus-getAll
machineImage-delete
machineImage-deleteAll
machineImage-download
machineImage-downloadFile
machineImage-get
machineImage-getAll
machineImage-publish
machineImage-regenerate