VMware VCLOUD API 1.0 - API User Manual

VMware, Inc. 49
Chapter 4 Provisioning
<Disk ovf:capacity="100" ovf:capacityAllocationUnits="byte * 2^20" ovf:diskId="vmdisk1"
ovf:fileRef="file1"
ovf:format="http://www.vmware.com/interfaces/specifications/
vmdk.html#streamOptimized"/>
</DiskSection>
<VirtualSystem ... ovf:id="Ubuntu Template">
...
</VirtualSystem>
</Envelope>
Inthisexample,thedescriptorreferencesonlyonefile:
<File ovf:href="disk0.vmdk" ovf:id="file1" ovf:size="1950489088"/>
ThehrefattributeoftheFileelementisthepathtothefilerelativetothelocationofthedescriptoritself.To
retrievethisfilefromtheserver,theclientmustmakeaGETrequesttoaURLthatitconstructswithasimple
two‐stepalgorithm:
1StartwiththeURL
thatwascontainedinthedownload:defaultattributeoftheLinktothedescriptor
thatwascontainedbytemplate.(SeeExample 4‐11.)
2ReplacethefinalcomponentofthatURLwiththevalueofthehrefattributeoftheFileinthe
downloadedOVFdescriptor.
Theresultofthisprocess,usingtheresponses
inExample 4‐11andExample 4‐12,istherequestURLshown
inExample 4‐13.
Example 4-13. Downloading a Referenced File
Request:
GET http://vcloud.example.com/transfer/..../disk0.vmdk
Response:
200 OK
...
...serializedcontentsoffiledisk0.vmdk...
EOF
Whenthedownloadcompletes,thevApptemplateisavailableontheclientasanOVFpackage.
Disable a vApp Template for Download
AnadministratororauthorizedusercanusethedisableDownloadactiontodisableavApptemplatefor
download,asshowninExample 4‐14.TheresponseisanHTTP204(NoContent)status.
Example 4-14. Disable a vApp Template for Download
Request:
POST http://vcloud.example.com/api/v1.0/vAppTemplate/vappTemplate-268/action/disableDownload
Response:
204 No Content
NOTEMakesurethatthedownloadedfilesmaintainthesamerelationshiptoeachotherinthelocalfile
systemastheyhadonthetransferserverfilesystem.Inthiscase,thedescriptoranddisk0.vmdkwereboth
inthesamedirectory(thedefaultarrangement).

VMware VCLOUD API 1.0 - API Specifications

General

Brand	VMware
Model	VCLOUD API 1.0 - API
Category	Software
Language	English