Follow the steps described in this guide to use the Rackspace Cloud Orchestration API to create and access your stacks.

The simple exercises in this guide help you get started with the API by showing you how to access the API through either heat client commands or cURL commands.

For each exercise in this guide, you choose one of the following methods to call API operations:

  • heat client commands. The heat client provides easy command line access to the Cloud Orchestration API operations. We recommend that you use the heat client to run simple commands that call API operations. You can specify the --debug parameter on any heat command to show the underlying cURL request for the API operation. This is a good way to become familiar with the API requests. For details see the section called “How the heat client commands work”.

  • cURL commands. If you are familiar with or want to learn cURL commands, choose this method. With cURL, you send HTTP requests with embedded API operations from the command line. The cURL examples in this guide include request bodies in JSON format. For details see the section called “How cURL commands work”.

If you like, you can use cURL in one example and then use heat client commands in the next example. If you choose to use a cURL command for any example, you must export the environment variables required to run the cURL examples. For details see the section called “Step 5. Export environment variables to run cURL commands”.

To use the API, it helps to be familiar with HTTP 1.1, RESTful web services, the Rackspace Cloud Servers service, and JSON data serialization format.