trial-management

Trial Site Management

Use when:

• Creating a new trial Drupal site on Acquia Cloud
• Checking whether a trial is still provisioning, has finished, or has failed
• Getting the live site URL or admin sign-in link for a completed trial
• Retrying a trial that failed to provision
• Picking a Drupal template or AWS region before creating a trial

Note: The Trials API is a lightweight, pre-MEO provisioning surface in the v2 Cloud API (acli api:*), not MEO (acli api:v3:*). A user can have only one active trial at a time.

---

The Trial Lifecycle

api:trials:create ──▶ pending ──▶ in-progress ──▶ completed
                                        │
                                        └────────▶ failed ──▶ api:trials:retry ──▶ in-progress

status is always one of: pending, in-progress, completed, failed. Poll with api:account:find-trial — never assume completion, always check status before trusting _links.

Status	What's available
pending / in-progress	percent_complete (0-100 integer) only. No site link yet.
completed	_links.site (live public URL) and _links.admin (one-time sign-in link) both appear.
failed	_links.retry appears. Call api:trials:retry, not api:trials:create again.

Stuck trial: if status is pending with site_name: null, the trial is stuck server-side and cannot be resumed or retried (api:trials:retry is for failed trials only). Do not call api:trials:create again. Report the trial's id to the user and direct them to Acquia Support to clear the record.

---

Check Your Trial (and get the live site URL)

acli api:account:find-trial

This looks up your own trial account — no ID argument needed. This is the command to poll after creating a trial, and the command to use whenever an agent or user asks "where's my site?" / "is my trial ready?".

Example response once provisioning finishes:

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "site_name": "mytrialsite",
    "status": "completed",
    "percent_complete": 100,
    "region": "us-east-1",
    "_links": {
        "site": { "href": "https://ppd2005c06prod.prod.acquia-sites.com" },
        "admin": { "href": "https://ppd2005c06prod.prod.acquia-sites.com/user/login?token=abc123def456" }
    }
}