Acquia Cloud has two additional interfaces that developers can use to extend, enhance, and customize Acquia Cloud:
- Acquia Cloud API
The Acquia Cloud API is a RESTful web interface that allows developers to extend, enhance, and customize Acquia Cloud. It includes developer workflow, site management, and provisioning capabilities.
- Acquia Cloud Drush commands
The Acquia Cloud Drush commands allow you to use all features of the Acquia Cloud API either on the command line or from shell scripts using the excellent Drush command-line tool.
What can the Acquia Cloud API do?
You can use the Acquia Cloud API to do many of the tasks that are needed as part of your daily application development and continuous integration process.
Deploy code, databases, and user-uploaded files across your Development, Staging, and Production environments. The Acquia Cloud API lets you run any branch or tag from your Git repository in any environment, just as you can do from the Acquia Cloud interface. This allows you to automate these functions, instead of having to log in to the Acquia Cloud interface and manually drag elements from one environment to another.
Create, restore, and delete backups of your application’s databases. Acquia Cloud fully supports Drupal multisite installations, with as many databases per codebase as you need.
Retrieve current information about your application and its environments, including deployed code, databases, backups, and tasks.
Even better, the real magic behind the Cloud API is its integration with Cloud Hooks, which lets you automate nearly any action to be performed along with your workflow actions. You can do the following:
- Perform Drupal database updates or run your test suite when new code is deployed, and roll back to a previous release if the tests fail.
- Scrub your Production database when it is copied to Development or Staging by removing customer emails or disabling production-only modules.
- Integrate with third-party services, for example, by performing a Blitz.io performance test, when you deploy new code.
To get started with the Acquia Cloud API, do the following:
- Find your Cloud API credentials, as described in Cloud API authentication.
- Download the Acquia Cloud Drush integration, as described in Using Drush aliases.
- Use your Acquia Cloud API credentials in the Drush Cloud commands described in the Drush Cloud command reference or using the RESTful interface over HTTP, passing the credentials in the request using
curl, as in the examples in the Cloud API reference.
To use the Cloud API, a user must have the Access the Cloud API permission. By default, all users with the Team Lead, Senior Developer, and Administrator roles have this permission, while users with only the Developer role do not. Administrators can modify the permissions of existing roles, or add new custom roles with the desired permissions. For more information, see Working with roles and permissions: Editing a role.
Users who have the Access the Cloud API permission can use the Acquia Cloud API to take most of the actions enabled by the Acquia Cloud interface, and are not constrained by any other permissions in their use of the Acquia Cloud API
API rate limits
To prevent a single user from adversely affecting shared resources, there is a rate limit for Acquia Cloud APII calls. The rate limit varies by Acquia Cloud subscription level and is measured by authenticated calls per hour per Acquia Cloud API user (defined by the private key used with the call).
|Acquia Cloud Enterprise||1000|
|Acquia Cloud Professional||360|
|Acquia Cloud Free||10|
realm is a required parameter in calls to the Acquia Cloud API. This is the Acquia Cloud realm the environment is running in. The value is
prod for Acquia Cloud Enterprise and
devcloud for Acquia Cloud Professional. The realm corresponds to the element before
hosting.acquia.com in the environment's server names.