A member of a tenant organization using the vCloud Air Virtual Private Cloud OnDemand service option can use the vCloud API to access resources managed by the vCloud Air Compute Service. This service provides compute, networking, and storage functionality to vCloud Air tenants.

Before you can use the vCloud API to work with an instance's resources, you must obtain an authorization token from the vCloud Air Identity Management Service, and retrieve Compute Service instance information from the vCloud Air Service Controller.

Verify that the following conditions are met.

You have vCloud Air login credentials that are valid for access to the vCloud Air Virtual Private Cloud OnDemand service option.

You have finalized your user account by signing in to vCloud Air Web site and accepting the vCloud Air terms of service. For details on how to finalize a user account, see vCloud Air - Virtual Private Cloud OnDemand Getting Started.

You have an HTTP client to use with vCloud Air. You can use a browser or other HTTP client program to send requests and receive responses. See REST Client Programs for examples.

1

A successful login request to the vCloud Air Identity Management Service authenticates you to the system and returns an authorization token that you must include in all subsequent vCloud Air API requests. This token can also be used to authorize vCloud API requests.

2

Before you can use the vCloud API to work with the an instance of the vCloud Air Compute Service, you must query the vCloud Air Service Controller to retrieve information about the instances available to you.

After completing these steps, you will have your vCloud Air authorization token and the orgName and sessionUri instance attributes that you need, and can begin to use the vCloud API with the vCloud Air Compute Service.

Log in to the Compute Service by completing the steps in Log In To the Compute Service in vCloud Air Virtual Private Cloud OnDemand.