5.6

Table 1‑1. Object Type Descriptions (Continued)
Object Type Description Class Value
ComputeType Represents a reference to a Compute service.
Contains a list of virtual data centers contained in
the Compute service. The Compute service for a
Dedicated Cloud contains zero or more virtual data
centers. The Compute service for
Virtual Private Cloud always contains one virtual
data center.
vnd.vmware.vchs.compute
VdcReferenceType
Represents a reference to a virtual data center
representation on vCloud Air. Contains a link to
retrieve a vCloud session for each virtual data
center.
vnd.vmware.vchs.vdcref
VCloudSessionType
Represents a reference to a virtual data center on
the vCloud instance. The reference includes the full
URL to the vCloud instance and an authorization
token corresponding to the requesting customer
account. The authorization token must be used to
access objects within the scope of the virtual data
center and the Organization on the vCloud
instance.
vnd.vmware.vchs.vcloudsession
Link Relationships in the Object Types
The vCloud Air Platform APIs make extensive use of Link elements to provide references to objects and the
actions that they support. These elements are the primary mechanism by which a server tells a client how to
access and operate on an object.
vCloud Air creates Link elements in a response, which are read-only for the client. If a request includes a
Link element, the server ignores it.
Attributes of a Link Element
In the XML representation of a vCloud object, each Link element has the following form:
<Link
rel="relationship"
name="string"
type="application/xml;class=vnd.vmware.vchs.{type}"
href="URL" />
LinkType is used for only up and down links; typically, objects do not extend from LinkType.
The media type is represented in the request as the value of the class attribute:
application/xml;class=type;version=5.6
Where type corresponds to the XML structure returned. All class values start with the string
vnd.vmware.vchs.
Elements and References
The vCloud Air object model contains elements and references within those elements.
Elements References
Session Services
ServiceList Service
Chapter 1 About the vCloud Air Platform APIs
VMware, Inc. 9