VMware VCLOUD API 1.0 - API

VMware, Inc. 145
Chapter 8 XML Representations in the vCloud API
XML Namespace Identifiers
ElementsusedasrequestorresponsebodiescontainasetofattributesthatenableXMLvalidation.Thebody
ofaPUTorPOSTrequestmustcontainallXMLnamespaceidentifiersrequiredtovalidatetheXMLit
contains.AresponsebodytypicallyincludesalltheXMLnamespaceidentifiersthattheserverused
tovalidate
it,inadditiontootherattributesthatspecifytheschemalocationssearchedduringvalidation.Table 8‐5
summarizestheseattributesandshowsthenamespaceidentifiersandprefixesusedintheexamplesinthis
guide.
XMLnamespaceidentifiersareomittedfrommostoftheexampleresponses(see“A b o u t theExamples”on

page 19).Example 8‐1showshowtheyappearinatypicalresponsebody.
Example 8-1. Response Body Showing XML Namespace Identifiers
<VApp xmlns="http://www.vmware.com/vcloud/v1" status="8" name="Linux FTP server"
type="application/vnd.vmware.vcloud.vApp+xml"
href="http://vcloud.example.com/api/v1.0/vApp/vapp-7"
xmlns:ovf="http://schemas.dmtf.org/ovf/envelope/1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.vmware.com/vcloud/v1
http://vcloud.example.com/api/v1.0/schema/master.xsd">
...
</vApp>
8Theobjectispoweredoff. YES YES
†
YES
9Theobjectisinaninconsistentstate. No YES YES
10 Childrendonotallhavethesamestatus. YES Y ES No
11 Uploadinitiated,OVFdescriptorpending YES No No
12 Uploadinitiated,copyingcontents YES No No
13 Uploadinitiated,diskcontentspending YES No No
14 Uploadhasbeenquarantined YES No No
15 Uploadquarantineperiodhasexpired YES No No
† IndicatesthatallChildrenhavethisstatus
Table 8-4. vAppTemplate, vApp, and Vm status Attribute Values (Continued)
Value Description vAppTemplate vApp Vm
Table 8-5. XML Namespace Identifiers
Name Value Requirement
xmlns http://www.vmware.com/vcloud/v1.0 Requiredinallrequestbodies.
xmlns:vmext http://www.vmware.com/vcloud/extension/v1 Requiredinrequestbodiesthat
includeelementsfromthevSphere
PlatformExtensions
xmlns:ovf http://schemas.dmtf.org/ovf/envelope/1 Requiredinrequestbodiesthat
includeelementsprefixedwithovf:
xmlns:rasd http://schemas.dmtf.org/wbem/wscim/1/cim‐schema/2/
CIM_ResourceAllocationSettingData
Requiredinrequestbodiesthat
includeelementsprefixedwithrasd:
xmlns:vssd http://schemas.dmtf.org/wbem/wscim/1/cim‐schema/2/
CIM_VirtualSystemSettingData
Notrequiredinrequestbodies.
xsi:schemaLocation Aninstallation‐dependent
schemalocationsearchpath.
Formoreinformation,see
http://www.w3.org/TR/xmlschema‐0/#schemaLocation
Notrequiredinrequestbodies.
xmlns:xsi http://www.w3.org/2001/XMLSchema‐instance Notrequiredinrequestbodies.