VMware VCLOUD API 1.0 - TECHNICAL NOTE, Programming Manual

Page: 145 / 212

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 “About 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>
8 The object is powered off. YES YES
†
YES
9 The object is in an inconsistent state. No YES YES
10 Children do not all have the same status. YES YES 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.