1.0
Table Of Contents
- vCloud API Programming Guide
- Contents
- About This Book
- Introducing the VMware vCloud API
- Hello vCloud: A Structured REST Workflow Example
- Logging In and Getting an Organization List
- Browsing an Organization
- Finding a vApp Template
- Getting Information About a vDC
- Instantiating the Template in the vDC
- Deploying and Powering On the vApp
- Getting Information About the vApp
- Displaying the Console
- Deleting the vApp
- Logging Out
- Moving on to Additional Use Cases
- Browsing
- Provisioning
- Summary of Provisioning Requests
- Upload OVF to Create a vApp Template
- View the OVF Descriptor of a vApp Template
- Download a vApp Template as OVF
- Upload a Media Image
- Copying and Moving
- Changing a Name or Description
- Delete a vAppTemplate, vApp, or Media Image
- Cataloging vApp Templates and Media Images
- Controlling Access
- Datacenter Operations
- Summary of Datacenter Operations Requests
- vApp Lifecycle
- Instantiate a vApp Template
- Compose a vApp
- Recompose a vApp to Add or Remove Virtual Machines
- Capture a vApp to Create a vApp Template
- Reconfiguring vApps and Virtual Machines
- Deploying and Controlling vApps and Virtual Machines
- Deploy a vApp or Virtual Machine
- Undeploy a vApp or Virtual Machine
- Power On a vApp or Virtual Machine
- Power Off a vApp or Virtual Machine
- Reset a vApp or Virtual Machine
- Suspend a vApp or Virtual Machine
- Discard the Suspended State of a vApp or Virtual Machine
- Shut Down a vApp or Virtual Machine
- Reboot a vApp or Virtual Machine
- List Media Devices of a Virtual Machine
- Insert Media Into a Virtual Machine
- Eject Media from a Virtual Machine
- Get a Screen Thumbnail for a Virtual Machine
- Get a Screen Ticket for a Virtual Machine
- Provide User Input Requested by a Virtual Machine
- Control Access to vApps
- Retrieve a Task
- Administrative Operations
- VMware vSphere Platform Operations
- Summary of vSphere Platform Operations Requests
- List vSphere Platform Operations and Objects for a vCloud
- List Provider vDCs in a vCloud
- List External Networks in a vCloud
- List Network Pools in a vCloud
- List vCenter Servers Registered to a vCloud
- List ESX/ESXi Hosts in a vCloud
- Create a Provider vDC
- Create an External Network
- Create a Network Pool
- Import a Virtual Machine from vCenter
- XML Representations in the vCloud API
- User API Reference
- Request Parameters Reference
- Administrative API Reference
- vSphere Platform Extensions Reference
- OVF and the vCloud API
- An Introduction to REST for vCloud API Users
- Index
VMware, Inc. 171
10
ThischapterprovidesreferenceinformationabouttherequestparametersdefinedinthisreleaseofthevCloud
API.Elementsdocumentedinthischapterprovideparameterstorequeststhatcreate,delete,modify,or
changethestateofanobject.FormoreinformationabouthowthevCloudAPIusesXMLtorepresentobjects,
and
howthisreferencematerialisorganized,see“XMLRepresentationsinthevCloud API”onpage 141
Thischapterprovidesreferencematerialonthefollowingelementsandtheelementstheycontain:
“UploadVAppTemplateParams”onpage 171
“InstantiateVAppTemplateParams”onpage 172
“InstantiationParams”onpage 172
“ComposeVAppParams”onpage 173
“RecomposeVAppParams”onpage 174
“DeployVAppParams”onpage 175
“UndeployVAppParams”onpage 175
“CaptureVAppParams”onpage 175
“CloneMediaParams”onpage 176
“CloneVAppTemplateParams”onpage 176
“CloneVAppParams”onpage 176
“MediaInsertOrEjectParams”onpage 177
“VmPendingQuestion”onpage 177
“VmQuestionAnswer”onpage 177
“ControlAccessParams”onpage 177
UploadVAppTemplateParams
TheUploadVAppTemplateParamselementformsthebodyofanuploadVappTemplaterequest.
Content-Type application/vnd.vmware.vcloud.uploadVAppTemplateParams+xml
Request Parameters Reference
10
Schema
Name Min Max Type Description
name 11 xs:string Specifiesthenamegiventothetemplate
Description 0 1 xs:string Descriptionofthetemplate
transferFormat 0 1 xs:string Ignoredinthisrelease
manifestRequired 0 1 xs:boolean Trueiftheuploadincludesamanifestfile