1
About the vCloud SDK for .NET
The VMware vCloud API provides support for developers who are building interactive clients of VMware
vCloud Director using a RESTful application development style. vCloud API clients and servers communicate
over HTTP, exchanging representations of vCloud objects. These representations take the form of XML
elements. HTTP GET requests are used to retrieve the current representation of an object, HTTP POST and
PUT requests are used to create or modify an object, and HTTP DELETE requests are typically used to delete
an object.
The vCloud SDK for .NET is a C# language binding for the vCloud API. It provides C# class libraries and a set
of example applications. The classes and functions in the library encapsulate the interfaces, objects, and
operations that the vCloud API supports, while preserving its RESTful approach and compatibility with the
HTTP protocol family.
This vCloud SDK for .NET Developer's Guide provides information about setting up the SDK in a development
environment, and information about building and running the example applications included in the SDK.
This chapter includes the following topics:
"vCloud Object Taxonomy" on page 7
"vCloud SDK for .NET Design" on page 9
vCloud Object Taxonomy
The vCloud SDK for .NET defines a set of objects common to cloud computing environments. Figure
shows the principal object types.
vCloud Organizations
A vCloud contains one or more organizations. A vCloud organization is a unit of administration for a
collection of users, groups, and computing resources. Users authenticate at the organization level, supplying
credentials established by an organization administrator when the user was created or imported.
vCloud Users and Groups
An organization can contain an arbitrary number of users and groups. Users can be created by the
organization administrator or imported from a directory service such as LDAP. Groups must be imported
from the directory service. Permissions within an organization are controlled through the assignment of rights
and roles to users and groups.
vCloud Networks
An organization can be provisioned with one or more networks. These organization networks can be
configured to provide services such as DHCP, NAT, and firewalls.
VMware, Inc.
1
1‐1
7