Documentation
The Deltacloud documentation is divided into the following parts:
- REST API definition
- Currently-supported drivers
- Framework for writing additional drivers
- Ruby client
- C library
Usage
The server listens by default on http://localhost:3001/. For testing and exploring, the server can be used from a web browser and will return HTML to it. If you want to see XML output from the server in the browser, append ?format=xml to each URL.
On Webkit based browsers like Safari, you might need to instruct the server explicitly to return HTML . Do this by appending ?format=html to each URL.
Logging into the server
Deltacloud uses basic HTTP authentication to receive credentials from the client and passes them through to the backend cloud it is talking to. The credentials always consist of a username and password, and are never stored on the server. The exact credentials for logging into the server, and where you find them, depends on the backend cloud that the server is talking to.
The following table gives details about how to set up the server and what credentials to provide for each of the supported clouds. The entry from the Driver column needs to be passed as the --driver option to deltacloudd. Note that some of the drivers require additional information, e.g., API endpoint URL's, be passed through environment variables
| Cloud | Driver | Username | Password | Notes |
|---|---|---|---|---|
| mock | mock | mockuser | mockpassword | The mock driver doesn't talk to any cloud; it just pretends to be a cloud |
| Amazon EC2/S3 | ec2 | Access Key ID | Secret Access Key | This information can be found on the Security Credentials page in your AWS account |
| Eucalyptus | eucalyptus | Access Key ID | Secret Access Key | |
| GoGrid | gogrid | API Key | Shared Secret | Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret. |
| IBM SBC | sbc | Username | Password | |
| Microsoft Azure (Storage Account only) | azure | Public Storage Account Name | Primary Access Key | The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel. |
| OpenNebula | opennebula | OpenNebula user | OpenNebula password | Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening. |
| Rackspace Cloud Servers/Cloud Files | rackspace | Rackspace user name | API Key | Obtain the key from the API Access page in your control panel |
| RHEV-M | rhevm | RHEV-M user name plus Windows domain , e.g., admin@rhevm.example.com | RHEV-M password | Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint. |
| Rimuhosting | rimuhosting | not used (?) | API Key | |
| Terremark | terremark | Username | Password |