VMware VCLOUD API 1.0 - TECHNICAL NOTE, Programming Manual

Page: 148 / 212

vCloud API Programming Guide
148 VMware, Inc.
<MediaType>application/vnd.vmware.vcloud.vdc+xml</MediaType>
<ComplexTypeName>CatalogItemType</ComplexTypeName>
<SchemaLocation>http://vcloud.example.com/api/v1.0/schema/master.xsd</SchemaLocation>
</MediaTypeMapping>
<MediaTypeMapping>
...
</MediaTypeMapping>
</VersionInfo>
</SupportedVersions>
SupportedVersions
A SupportedVersions element is a container for VersionInfo elements.
VersionInfo
A VersionInfo element defines the login URL and media types supported by a version of the vCloud API.
This element is read ‐ only.
MediaTypeMapping
A MediaTypeMapping element defines the name, MIME content type, and schema location of a complex type
supported by this version of the vCloud API.
This element is read ‐ only.
Extensibility
The vCloud API is designed to be extensible. All complex types defined by the API extend a single abstract
complex type. This complex type and all types based on it can include zero or more instances of an extension
element that can contain an arbitrary number of elements and attributes.
VCloudExtensibleType is an abstract type that all complex types defined in the vCloud API namespace
(http://www.vmware.com/vcloud/v1) extend. This type allows custom attributes to be added to any type and
supports definition of custom elements within the VCloudExtension element.
The VCloudExtension element has an attribute named required that specifies how clients and servers
proceed when they see unknown extension. The required attribute is optional but if omitted is assumed to
be present with a value of true . That is to say, all VCloudExtension elements are assumed to require a server
that understands them.
Schema
Name Min Max Type Description
Version 1 1 xs:string Version number
LoginUrl 1 1 xs:string URL for logging in to this version
MediaTypeMapping 0 n MediaTypeMappingType Media type of the referenced object. Links to
actions do not have a media type.
Schema
Name Min Max Type Description
MediaType 1 1 xs:string MIME content type of this complex type
ComplexTypeName 1 1 xs:string Name of this complex type
SchemaLocation 1 1 xs:anyURI URL for the XML schema definition document that defines
this complex type