A successful login by a system administrator returns a Session element that contains a link that you can use to retrieve a VMWExtension element.

Every vCloud Director installation depends on vSphere platform resources such as vCenter servers and hosts, vShield Manager, portgroups, virtual switches, and so on. The VMWExtension element provides access to a cloud-wide namespace of vSphere platform objects that are registered for use by the system, and links that allow you to add vSphere servers and related resources to your cloud. Objects in the admin/extension XML namespace provide a system administrator with programmatic access to these resources.

Use the credentials of a system administrator to create a login session. See Create a Login Session Using the Integrated Identity Provider.

1

Retrieve the XML representation of your Session object.

Use a request like this one:

GET https://vcloud.example.com/api/session
2

Examine the contents of the Session element to locate the link to the VMWExtension object.

This link has the following form:

<Link
   rel="down"
   type="application/vnd.vmware.admin.vmwExtension+xml"
   href="https://vcloud.example.com/api/admin/extension"/>
3

Retrieve the list of organizations by making a GET request to the href value of the Link described in Step 2.

The request returns a VMWExtension element, as shown in Example: Retrieve a List of vSphere Platform Operations and Objects for a Cloud.

Request:

GET https://vcloud.example.com/api/admin/extension

The response is a VMWExtension element containing a number of Link elements. This example shows only a subset of VMWExtension contents.

Response:

200 OK
Content-Type: application/vnd.vmware.admin.vmwextension+xml
...
<vmext:VMWExtension
   xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
   xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
   type="application/vnd.vmware.admin.vmwExtension+xml">
   <vcloud:Link
      rel="down"
      type="application/vnd.vmware.admin.vmwProviderVdcReferences+xml"
      href="https://vcloud.example.com/api/admin/extension/providerVdcReferences" />
   <vcloud:Link
      rel="down"
      type="application/vnd.vmware.admin.vmwExternalNetworkReferences+xml"
      href="https://vcloud.example.com/api/admin/extension/externalNetworkReferences" />
   <vcloud:Link
      rel="down"
      type="application/vnd.vmware.admin.vmwNetworkPoolReferences+xml"
      href="https://vcloud.example.com/api/admin/extension/networkPoolReferences" />
   <vcloud:Link
      rel="down"
      type="application/vnd.vmware.admin.vmwVimServerReferences+xml"
      href="https://vcloud.example.com/api/admin/extension/vimServerReferences" />
   <vcloud:Link
      rel="down"
      type="application/vnd.vmware.admin.vmwHostReferences+xml"
      href="https://vcloud.example.com/api/admin/extension/hostReferences" />
   <vcloud:Link ... />
   ...
  <vcloud:Link
      rel="down"
      type="application/vnd.vmware.admin.extensionServices+xml"
      href="https://vcloud.example.com/api/admin/extension/service" />
</vmext:VMWExtension>