Drush Cloud reference

Using Acquia Cloud Drush commands, you can use all of the features of the Cloud API on the command line or from shell scripts, using the Drush command-line tool. This reference describes only the Acquia Cloud Drush commands for using the Cloud API. For information about how to get started with the Acquia Cloud Drush integration, see Developing with the Cloud API.

Acquia Cloud API commands

Type Command Description
API credentials ac-api-login Store Acquia Cloud API credentials and configuration information.
Code deployment ac-code-deploy Deploy code from one site environment to another.
ac-code-path-deploy Deploy a specific branch or tag in an environment.
Database commands ac-database-add Add a database.
ac-database-copy Copy a database from one site environment to another.
ac-database-delete Delete a database.
ac-database-info Show information about a site database.
ac-database-instance-backup Create a backup of a database instance.
ac-database-instance-backup-delete Delete a database instance backup.
ac-database-instance-backup-download Download a database instance backup of a site environment.
ac-database-instance-backup-info Show information about a site environment's database instance backup.
ac-database-instance-backup-list List a site environment's database instance backups.
ac-database-instance-backup-restore Restore a database instance from a backup.
ac-database-instance-info Show information about a site environment's database instance.
ac-database-instance-list List a site environment's database instances.
ac-database-list List a website's databases.
Domains ac-domain-add Add a domain name to an environment.
ac-domain-delete Delete a domain name from an environment.
ac-domain-info Show information about a site domain.
ac-domain-list List a website's domains.
ac-domain-move Move one or more domains from one site environment to another.
ac-domain-purge Purge a domain from the Varnish cache.
Environments ac-environment-info Show information about a site environment.
ac-environment-install Install a Drupal distribution from a preselected list, URL, or Drush Makefile.
ac-environment-list List a website's environments.
ac-environment-livedev Enable or disable live development on a site environment.
Files ac-files-copy Copy files from one site environment to another.
Servers ac-server-info Show information about a server.
ac-server-list List servers for a site and environment.
Sites ac-site-info Show information about a site.
SSH keys ac-sshkey-add Add an SSH key to a site.
ac-sshkey-delete Delete an SSH key from a site.
ac-sshkey-info Show information about a site SSH key.
ac-sshkey-list List a site's SSH keys.
SVN users ac-svnuser-add Add an SVN user to a site.
ac-svnuser-delete Delete an SVN user from a site.
ac-svnuser-info Show information about a site SVN user.
ac-svnuser-list List a site's SVN users.
Tasks ac-task-info Show information about a site task.
ac-task-list List a website's tasks.
API aliases acquia-update Retrieves and updates Drush aliases for all accessible Acquia Cloud sites..

Common options

All Acquia Cloud API commands have the following options:

Command Description
--cainfo= Path to a file containing the SSL certificates needed to verify the ac-api-endpoint.
--caller= Acquia Cloud API caller name. Default is the current username.
--endpoint= Acquia Cloud API endpoint URL.
--format= Format to output the object. Use "var_export" for var_export, and "json" for JSON. If not provided, the output is printed in a human-readable format.
--email= Acquia Cloud API email address. See Cloud API authentication.
--key= Acquia Cloud API key. See Cloud API authentication.
--acapi-conf-path= By default, the ac-api-login command stores default option values for future Acquia Cloud API commands in $HOME/.drush/.acapi.drushrc.php. Use this option to specify a different file location.

Command detail

API credentials

ac-api-login

Store Acquia Cloud API credentials and configuration information.
This command stores default option values for future Acquia Cloud API commands in $HOME/.drush/.acapi.drushrc.php. This is most useful for stashing your API email and key so you do not have to enter it every time. You can change the file location where this is stored using the acapi-conf-path option.

Arguments

  • None

Options

  • Common options
  • --reset - Discard any existing stored values from a previous call. Without this option, new values will be merged with existing values.

Code deployment

ac-code-deploy

Deploy code from one site environment to the target environment.

Arguments

  • target - The target environment.

Options


ac-code-path-deploy

Deploy a specific branch or tag in an environment.

Arguments

  • path - The branch or tag to deploy.

Options


Database commands

ac-database-add

Add a database.

Arguments

  • db - The name of the database.

Options


ac-database-copy

Copy a database from one site environment to the target environment.

Arguments

  • db - The database.
  • target - The target environment.

Options


ac-database-delete

Delete a database. By default, creates a backup of each instance of the database before deleting it.

Arguments

  • db - The database.

Options

  • Common options
  • --no-backup - Do not make a final backup of each instance of this database before deleting it.

ac-database-info

Show information about a site database.

Arguments

  • db - Database name.

Options


ac-database-instance-backup

Create a backup of a database instance.

Arguments

  • db - The database.

Options


ac-database-instance-backup-delete

Delete a database instance backup.

Arguments

  • db - The database.
  • backupid - The backup ID.

Options


ac-database-instance-backup-download

Download a database instance backup of a site environment.

Arguments

  • db - The database.
  • backupid - The backup ID.

Options

  • Common options
  • --result-file= - Save to a file; specify the full path in which to store the backup. If no path is provided, the backup is sent the standard output.

ac-database-instance-backup-info

Show information about a site environment's database instance backup.

Arguments

  • db - Database name.
  • backup - The backup ID.

Options


ac-database-instance-backup-list

List a site environment's database instance backups.

Arguments

  • db - Database name.

Options


ac-database-instance-backup-restore

Restore a database instance from a backup.

Arguments

  • db - The database.
  • backupid - The backup ID.

Options


ac-database-instance-info

Show information about a site environment's database instance.

Arguments

  • db - The database name.

Options


ac-database-instance-list

List a site environment's database instances.

Arguments

  • None

Options


ac-database-list

List a website's databases.

Arguments

  • None

Options


Domains

ac-domain-add

Add a domain name to an environment.

Arguments

  • domain - The domain name.

Options


ac-domain-delete

Delete a domain name from an environment.

Arguments

  • domain - The domain name.

Options


ac-domain-info

Show information about a site domain.

Arguments

  • domain - The domain name.

Options


ac-domain-list

List a website's domains. If a site has an Elastic Load Balancer (ELB), also returns the name of the ELB.

Arguments

  • None

Options


ac-domain-move

Move one or more domains from one site environment to the target environment.

Arguments

  • target - The target environment to which you are moving the domains.
  • domains - A comma-separated list of the domains to move, or * to move all domains in the source environment.

Options


ac-domain-purge

Purge a domain from the Varnish cache.

Arguments

  • domain - The domain name.

Options


Environments

ac-environment-info

Show information about a site environment.

Arguments

  • None

Options


ac-environment-install

Install a Drupal distribution into an environment from a URL or a Drush Make file.

Arguments

  • type - Type of distro source. One of distro_url or make_url.
  • source - Depending on type, one of:
    • distro_url - A publicly accessible URL to any Drupal distribution in standard format.
    • make_url - A publicly accessible URL to a Drush Make file.

Options


ac-environment-list

List a website's environments.

Arguments

  • None

Options


ac-environment-livedev

Enable or disable live development on a site environment.

Arguments

  • action - The action to take: enable or disable live development on the environment.

Options


Files

ac-files-copy

Copy files from one site environment to the the target environment.

Arguments

  • target - The target environment.

Options


Servers

ac-server-info

Show information about a server.

Arguments

  • server - The server name.

Options


ac-server-list

List servers for a site and environment.

Arguments

  • None

Options


Sites

ac-site-info

Show information about a website.

Arguments

  • None

Options


SSH keys

ac-sshkey-add

Add an SSH key to a website.

Arguments

  • ssh_pub_key - File containing the SSH public key.
  • nickname - The SSH key nickname.

Options


ac-sshkey-delete

Delete an SSH key from a site.

Arguments

  • sshkeyid - The ID of the SSH key to delete.

Options


ac-sshkey-info

Show information about a website SSH key.

Arguments

  • sshkeyid - The ID of the SSH key.

Options


ac-sshkey-list

List a website's SSH keys.

Arguments

  • None

Options


SVN users

ac-svnuser-add

Add an SVN user to a website.

Arguments

  • username - SVN username.
  • password - SVN password.

Options


ac-svnuser-delete

Delete an SVN user from a website.

Arguments

  • svnuserid - The ID of the SVN user to delete.

Options


ac-svnuser-info

Show information about a website SVN user.

Arguments

  • svnuserid - The ID of the SVN user.

Options


ac-svnuser-list

List a website's SVN users.

Arguments

  • None

Options


Tasks

ac-task-info

Show information about a site task.

Arguments

  • task - The task ID.

Options


ac-task-list

List a website's tasks. By default, returns only the last 7 days of tasks and no more than 50 tasks. You can modify this default behavior by using the limit or days arguments in the command.

Arguments

  • days - Return tasks from the past n days. Default is 7.
  • limit - Maximum number of tasks to return. Default is 50.

Options


API aliases

acquia-update

Retrieves and updates Drush aliases for all accessible Acquia Cloud sites.

Arguments

  • None

Options

Add new comment

Plain text

  • No HTML tags allowed.
  • Lines and paragraphs break automatically.
  • Web page addresses and email addresses turn into links automatically.
By submitting this form, you accept the Mollom privacy policy.

Contact supportStill need assistance? Contact Acquia Support