VMware VCLOUD API 1.0 - TECHNICAL NOTE, Programming Manual

Page: 41 / 212

VMware, Inc. 41
4
The vCloud API supports upload and download of OVF packages, and upload of media images. Transfer
operations are characterized as uploads when the operation transfers content from the local host to a remote
one, and as downloads when the local host requests the transfer of content from a remote host. Uploads are
typically initiated by a POST request, and downloads by a GET request. Uploads and downloads are
facilitated by the vCloud transfer service, which provides temporary storage for files.
The vCloud API also supports a clone operation that copies vApps, vApp templates, or media images. The
clone operation also allows you to specify that the source object be deleted after the operation completes,
which effectively moves or renames the source object.
After they have been uploaded or cloned, templates and media images can be added to catalogs as needed.
This chapter includes the following topics:

“Summary of Provisioning Requests” on page 41

“Upload OVF to Create a vApp Template” on page 42

“View the OVF Descriptor of a vApp Template” on page 47

“Download a vApp Template as OVF” on page 47

“Upload a Media Image” on page 50

“Copying and Moving” on page 50

“Changing a Name or Description” on page 53

“Delete a vAppTemplate, vApp, or Media Image” on page 54

“Cataloging vApp Templates and Media Images” on page 54

“Controlling Access” on page 56
Summary of Provisioning Requests
Table 4 ‐ 1 summarizes provisioning requests supported in this release. The table uses the following
conventions:

API ‐ URL is a URL of the form http://vcloud.example.com/api/v1.0.

id is an integer.
Provisioning
4
Table 4-1. Summary of Provisioning Requests
Operation Request Request Body Response
Upload OVF to Create a
vApp Template
POST API ‐ URL /vdc/ id /
action/uploadVAppTemplate
UploadVAppTemplateParams VAppTemplate
Download a vApp
Template as OVF
GET download ‐ URL None Depends on
file type