VMware VCLOUD API 1.0 - API

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