The vCloud API defines a set of objects common to cloud computing environments. An understanding of these objects, their properties, and their relationships is essential to using the vCloud API.

vCloud API Object Taxonomy
Illustration of the object hierarchy: an Organization that contains two VDC objects, three Catalog objects, two Network objects, and containers for Users, Groups, and Tasks

vCloud API objects have the following high-level properties:


Your organization is a unit of administration for users, groups, and computing resources.

Users and Groups

Your organization can contain an arbitrary number of users and groups. Permissions within an organization are controlled through the assignment of rights and roles to users and groups.


Catalogs contain references to vApp templates and media images. A Virtual Infrastructure Administrator or catalog owner controls catalog sharing. Virtual Infrastructure Administrators in organizations that have permission to publish catalogs control publication and subscription options for catalogs in their organization.

Organization VDCs

An organization virtual datacenter (organization VDC) is a deployment environment for virtual systems owned by the containing organization, and an allocation mechanism for resources such as networks, storage, CPU, and memory.

Organization VDC Networks

An organization VDC can be provisioned with zero or more networks. These organization VDC networks can be configured to provide routed connections to external networks, or can be isolated from external networks and other organization VDC networks.

Virtual Systems and Media Images

Virtual systems and ISO-format media images are stored in a catalog and represented as catalog item objects. Virtual systems are stored as templates, using an open standard format (OVF 1.0). These templates can be retrieved from catalogs and transformed into virtual systems, called vApps, through a process called instantiation, which binds a template’s abstract resource requirements to resources available in a VDC. A vApp contains one or more individual virtual machines (Vm elements), along with parameters that define operational details, including:

How the contained virtual machines are connected to each other and to external networks.

The order in which individual virtual machines are powered on or off.

End-user license agreement terms for each virtual machine.

Deployment lease terms, typically inherited from the containing organization, that constrain the consumption of VDC resources by the vApp.

Access control information specifying which users and groups can perform operations such as deploy, power on, modify, and suspend on the vApp and the virtual machines that it contains.


Asynchronous operations are tracked by task objects. Running and recently completed tasks initiated by members of an organization are kept on the organization’s tasks list.