components:
examples: {}
headers: {}
parameters:
Acquia_Cloud_API_Documentation_AgreementUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_agreement-uuid'
Acquia_Cloud_API_Documentation_AlertUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_alert-uuid'
Acquia_Cloud_API_Documentation_ApmType:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_apm-type'
Acquia_Cloud_API_Documentation_ApplicationUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_application-uuid'
Acquia_Cloud_API_Documentation_ArtifactId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_artifact-id'
Acquia_Cloud_API_Documentation_BackupId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_backup-id'
Acquia_Cloud_API_Documentation_CertificateId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_certificate-id'
Acquia_Cloud_API_Documentation_ConfigurationSetId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_configuration-set-id'
Acquia_Cloud_API_Documentation_CronId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_cron-id'
Acquia_Cloud_API_Documentation_DatabaseName:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
Acquia_Cloud_API_Documentation_DeprecatedFrom:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_deprecated-from'
Acquia_Cloud_API_Documentation_DeprecatedTo:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_deprecated-to'
Acquia_Cloud_API_Documentation_Domain:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_domain'
Acquia_Cloud_API_Documentation_DomainRegistrationUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_domain-registration-uuid'
Acquia_Cloud_API_Documentation_DrushVersion:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_drush-version'
Acquia_Cloud_API_Documentation_EnvironmentId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
Acquia_Cloud_API_Documentation_EnvironmentVariableName:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-variable-name'
Acquia_Cloud_API_Documentation_Filter:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter'
Acquia_Cloud_API_Documentation_FilterStackMetrics:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter-stack-metrics'
Acquia_Cloud_API_Documentation_FilterUsageMetrics:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter-usage-metrics'
Acquia_Cloud_API_Documentation_From:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_from'
Acquia_Cloud_API_Documentation_FromNoDefault:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_from-no-default'
Acquia_Cloud_API_Documentation_FromStackMetrics:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_from-stack-metrics'
Acquia_Cloud_API_Documentation_IdeUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_ide-uuid'
Acquia_Cloud_API_Documentation_IdentityProviderUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_identity-provider-uuid'
Acquia_Cloud_API_Documentation_IndexId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_index-id'
Acquia_Cloud_API_Documentation_Limit:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_limit'
Acquia_Cloud_API_Documentation_LogForwardingDestinationUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-forwarding-destination-uuid'
Acquia_Cloud_API_Documentation_LogType:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-type'
Acquia_Cloud_API_Documentation_MessageUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_message-uuid'
Acquia_Cloud_API_Documentation_Name:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_name'
Acquia_Cloud_API_Documentation_NotificationUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_notification-uuid'
Acquia_Cloud_API_Documentation_Offset:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_offset'
Acquia_Cloud_API_Documentation_OrganizationUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_organization-uuid'
Acquia_Cloud_API_Documentation_Permission:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_permission'
Acquia_Cloud_API_Documentation_Range:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_range'
Acquia_Cloud_API_Documentation_Resolution:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_resolution'
Acquia_Cloud_API_Documentation_RoleUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_role-uuid'
Acquia_Cloud_API_Documentation_ServerId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-id'
Acquia_Cloud_API_Documentation_ServerType:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-type'
Acquia_Cloud_API_Documentation_ShieldAclUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_shield-acl-uuid'
Acquia_Cloud_API_Documentation_SiteId:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_site-id'
Acquia_Cloud_API_Documentation_Sort:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_sort'
Acquia_Cloud_API_Documentation_SshKeyUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_ssh-key-uuid'
Acquia_Cloud_API_Documentation_StackMetricsMetricType:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_stack-metrics-metric-type'
Acquia_Cloud_API_Documentation_SubscriptionUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_subscription-uuid'
Acquia_Cloud_API_Documentation_TagName:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_tag-name'
Acquia_Cloud_API_Documentation_TeamUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_team-uuid'
Acquia_Cloud_API_Documentation_To:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_to'
Acquia_Cloud_API_Documentation_ToNoDefault:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_to-no-default'
Acquia_Cloud_API_Documentation_Token:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_token'
Acquia_Cloud_API_Documentation_TokenDeleteReason:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_token-delete-reason'
Acquia_Cloud_API_Documentation_TokenUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_token-uuid'
Acquia_Cloud_API_Documentation_UsageMetric:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_usage-metric'
Acquia_Cloud_API_Documentation_UserSearch:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_user-search'
Acquia_Cloud_API_Documentation_UserUuid:
$ref: '#/components/parameters/Acquia_Cloud_API_Documentation_user-uuid'
Acquia_Cloud_API_Documentation_agreement-uuid:
description: The entity's universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: agreementUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_alert-uuid:
description: The entity's universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: alertUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_apm-type:
description: The APM type.
example: newrelic
in: path
name: apmType
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_application-uuid:
description: The entity's universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: applicationUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_artifact-id:
description: An ID that uniquely identifies an artifact.
example: drupal8
in: path
name: artifactId
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_backup-id:
description: The database backup identifier.
example: 1
in: path
name: backupId
required: true
schema:
type: integer
Acquia_Cloud_API_Documentation_certificate-id:
description: An ID that uniquely identifies a certificate.
example: 7
in: path
name: certificateId
required: true
schema:
type: integer
Acquia_Cloud_API_Documentation_configuration-set-id:
description: An ID that uniquely identifies a configuration set.
example: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
in: path
name: configurationSetId
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_cron-id:
description: An ID that uniquely identifies a cron job.
example: e10a665c-c9ec-4422-a82b-b32c82329f9d
in: path
name: cronId
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_database-name:
description: The database name, typically lower snake case.
example: my_db
in: path
name: databaseName
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_deprecated-from:
deprecated: true
description: (Use filter `from` instead.) Specifies an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
formatted date. Used in conjunction with `to` query.
example: '2019-10-01'
in: query
name: from
required: false
schema:
type: string
Acquia_Cloud_API_Documentation_deprecated-to:
deprecated: true
description: (Use filter `to` instead.) Specifies an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
formatted date. Used in conjunction with `from` query.
example: '2020-01-01'
in: query
name: to
required: false
schema:
type: string
Acquia_Cloud_API_Documentation_domain:
description: A domain name.
example: example.com
in: path
name: domain
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_domain-registration-uuid:
description: The Domain Registration universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: domainRegistrationUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_drush-version:
description: Specifies the drush aliases formatting, either 8 (example.aliases.drushrc.php)
or 9 (example.site.yaml)
example: 8
in: query
name: version
required: true
schema:
enum:
- 8
- 9
type: integer
Acquia_Cloud_API_Documentation_environment-id:
description: The environment identifier. The identifier is a compound key consisting
of the internal database ID of the environment and the application UUID.
example: 12-d314739e-296f-11e9-b210-d663bd873d93
in: path
name: environmentId
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_environment-variable-name:
description: The environment variable name.
example: EXAMPLE_VARIABLE_NAME
in: path
name: environmentVariableName
required: true
schema:
maxLength: 255
minLength: 1
pattern: ^(?!(ACQUIA_|AH_))[A-Za-z_][A-Za-z0-9_]*$
type: string
Acquia_Cloud_API_Documentation_filter:
description: 'The filters query string parameter restricts the data returned
from your request. Filtered queries restrict the rows that do (or do not)
get included in the result by testing each row in the result against the filters.
Not all fields are filterable.
There are eight filter operators that can be used and they must be URL encoded
in order to be included. The operators are:
* Equals: `= (%3D)`
* Does not equal: `!= (!%3D)`
* Greater than: `> (%3E)`
* Less than: `< (%3C)`
* Greater than or equal to: `>= (%3E%3D)`
* Less than or equal to: `<= (%3C%3D)`
* Contains substring: `=@ (%3D@)`
* Does not contain substring: `!@ (!@)`
Filters can be combined using `OR` and `AND` boolean logic. The `OR` operator
is defined using a comma (`,`) and the `AND` operator is defined using a semi-colon
(`;`).
Some examples:
* `filter=field%3Dvalue` (`field` equals `''value''`)
* `filter=field%3D@*partialmatch` (`field` ends with `''partialmatch''`)
* `filter=field%3D@*partialmatch,field%3Dvalue` (`field` ends with `''partialmatch''`
OR `field` equals `''value''`)
* `filter=field%3D@*partialmatch,field%3Dvalue;field2%3C5` (`field` ends with
`''partialmatch''` OR `field` equals `''value''` AND `field2` > `5`)
'
in: query
name: filter
required: false
schema:
minimum: 1
type: string
Acquia_Cloud_API_Documentation_filter-stack-metrics:
description: 'The filters query string parameter restricts the data returned
from your request. Filtered queries restrict the rows that do (or do not)
get included in the result by testing each row in the result against the filters.
Not all fields are filterable.
There are eight filter operators that can be used and they must be URL encoded
in order to be included. The operators are:
* Equals: `= (%3D)`
* Does not equal: `!= (!%3D)`
* Greater than: `> (%3E)`
* Less than: `< (%3C)`
* Greater than or equal to: `>= (%3E%3D)`
* Less than or equal to: `<= (%3C%3D)`
* Contains substring: `=@ (%3D@)`
* Does not contain substring: `!@ (!@)`
Filters can be combined using `OR` and `AND` boolean logic. The `OR` operator
is defined using a comma (`,`) and the `AND` operator is defined using a semi-colon
(`;`).
Some examples:
* `filter=field%3Dvalue` (`field` equals `''value''`)
* `filter=field%3D@*partialmatch` (`field` ends with `''partialmatch''`)
* `filter=field%3D@*partialmatch,field%3Dvalue` (`field` ends with `''partialmatch''`
OR `field` equals `''value''`)
* `filter=field%3D@*partialmatch,field%3Dvalue;field2%3C5` (`field` ends with
`''partialmatch''` OR `field` equals `''value''` AND `field2` > `5`)
**For this endpoint, the "metric" filter is required. Multiple metrics can
be returned in one request. The following metrics are available:**
* apache-requests, bal-cpu, bal-memory, cron-memory, db-cpu, db-disk-size,
db-disk-usage, db-memory, file-disk-size, file-cpu, file-disk-usage, file-memory,
http-2xx, http-3xx, http-4xx, http-5xx, mysql-slow-query-count, nginx-requests,
out-of-memory, php-proc-max-reached-site, php-proc-max-reached-total, php-proc-site,
php-proc-total, varnish-cache-hit-rate, varnish-requests, web-cpu, web-memory
'
in: query
name: filter
required: true
schema:
minimum: 1
type: string
Acquia_Cloud_API_Documentation_filter-usage-metrics:
description: 'The filters query string parameter restricts the data returned
from your request. Filtered queries restrict the rows that do (or do not)
get included in the result by testing each row in the result against the filters.
Not all fields are filterable.
Filter parameters include:
* `from` - Specifies absolute time period to retrieve results from. Requires
ISO 8601 format.
* `to` - Specifies absolute time period to retrieve results until. Requires
ISO 8601 format.
Formatting examples:
* `2023-09-01`
* `2023-09-01T00%3A00%3A00.000Z` (`2023-09-01T00:00:00.000Z`)
Usage examples:
* `{endpoint}?filter=from%3D2025-04-01,to%3D2025-04-30` (`from` is `2025-04-01`
and `to` is `2025-04-30`)
* `{endpoint}?filter=from%3D2025-04-01T00:00:00.000Z,to%3D2025-04-30T23:59:59.000Z`
(`from` is `2025-04-01T00:00:00.000Z` and `to` is `2025-04-30T23:59:59.000Z`)
'
in: query
name: filter
required: false
schema:
minimum: 1
type: string
Acquia_Cloud_API_Documentation_from:
description: 'Specifies absolute time period to retrieve results from. Requires
ISO 8601 format.
Some examples:
* `2023-09-01`
* `2023-09-01T00%3A00%3A00.000Z` (`2023-09-01T00:00:00.000Z`)
'
example: '2023-09-01'
in: query
name: from
required: false
schema:
type: string
Acquia_Cloud_API_Documentation_from-no-default:
description: An ISO-8601 formatted date retrieve results from.
example: '2021-01-29T22:45:21+00:00'
in: query
name: from
required: false
schema:
type: string
Acquia_Cloud_API_Documentation_from-stack-metrics:
description: An ISO-8601 formatted date retrieve metrics from.
example: '2021-01-29T22:45:21+00:00'
in: query
name: from
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_ide-uuid:
description: The Cloud IDE universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: ideUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_identity-provider-uuid:
description: The entity's universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: identityProviderUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_index-id:
description: An ID that uniquely identifies an index.
example: ABCDE-1234.test.example
in: path
name: indexId
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_limit:
description: The maximum number of items to return.
example: 10
in: query
name: limit
required: false
schema:
type: integer
Acquia_Cloud_API_Documentation_log-forwarding-destination-uuid:
description: The entity's universally unique identifier.
example: dbd8a966-2b25-11e9-b210-d663bd873d93
in: path
name: logForwardingDestinationUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_log-type:
description: An ID that uniquely identifies a log type.
example: php-error
in: path
name: logType
required: true
schema:
enum:
- apache-access
- apache-error
- drupal-request
- drupal-watchdog
- fpm-access
- fpm-error
- php-error
- cloud-hook
- cronjob
- mysql-slow-query
type: string
Acquia_Cloud_API_Documentation_message-uuid:
description: The entity's universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: messageUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_name:
description: A name that uniquely identifies an entity.
example: drupal8
in: path
name: name
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_notification-uuid:
description: The entity's universally unique identifier.
example: 2343b683-b194-4217-982a-6a95c72ad9a8
in: path
name: notificationUuid
required: true
schema:
format: uuid
type: string
Acquia_Cloud_API_Documentation_offset:
description: An integer to signify the offset to paginate from.
example: 10
in: query
name: offset
required: false
schema:
type: integer
Acquia_Cloud_API_Documentation_organization-uuid:
description: The organization entity's universally unique identifier.
example: 1e7efab9-0fac-4a2c-ad94-61efc78623ba
in: path
name: organizationUuid
required: true
schema:
format: uuid
maxLength: 36
minLength: 36
type: string
Acquia_Cloud_API_Documentation_permission:
description: Specifies the permission you wish to check access for.
example: deploy to prod
in: query
name: permission
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_range:
description: ISO-8601 date/time of invite create date/time.
in: query
name: range
required: false
schema:
format: date-time
type: string
Acquia_Cloud_API_Documentation_resolution:
description: 'Specifies the data granularity of the request. Available resolutions:
minute, hour, day, week or month.
Limits:
- 3 hour limit for “minute” resolution
- 1 week limit for “hour” resolution
- 6 month limit for “day” resolution
- 1 year limit for "week" resolution
- 3 year limit for “month” resolution
'
in: query
name: resolution
required: false
schema:
enum:
- minute
- hour
- day
- week
- month
type: string
Acquia_Cloud_API_Documentation_role-uuid:
description: The entity's universally unique identifier.
example: da1c0a8e-ff69-45db-88fc-acd6d2affbb7
in: path
name: roleUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_server-id:
description: The internal database identifier of the server.
example: '42'
in: path
name: serverId
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_server-type:
description: Specifies the type of server metric to retrieve.
example: web
in: query
name: serverType
required: true
schema:
enum:
- web
- bal
- db
type: string
Acquia_Cloud_API_Documentation_shield-acl-uuid:
description: The entity's universally unique identifier.
example: a1234567-1234-123a-abc1-12ab345cd678
in: path
name: shieldAclUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_site-id:
description: The site id
example: 1938d81b-4b14-462d-9871-5f8a32eb59b3
in: path
name: siteId
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_sort:
description: 'A comma-delimited string with fields used for sorting. The order
of the fields is significant. A leading - in the field indicates the field
should be sorted in a descending order. Not all fields are sortable.
'
example: field1,-field2
in: query
name: sort
required: false
schema:
minimum: 1
type: string
Acquia_Cloud_API_Documentation_ssh-key-uuid:
description: The SSH key entity's universally unique identifier.
example: 981b7910-2fe9-11e9-b210-d663bd873d93
in: path
name: sshKeyUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_stack-metrics-metric-type:
description: Specifies the type of StackMetrics metric to retrieve.
example:
- web-cpu
- web-memory
in: path
name: stackMetricsMetricType
required: true
schema:
items:
enum:
- apache-requests
- bal-cpu
- bal-memory
- cron-memory
- db-cpu
- db-disk-size
- db-disk-usage
- db-memory
- file-disk-size
- file-cpu
- file-disk-usage
- file-memory
- http-2xx
- http-3xx
- http-4xx
- http-5xx
- mysql-slow-query-count
- nginx-requests
- out-of-memory
- php-proc-max-reached-site
- php-proc-max-reached-total
- php-proc-site
- php-proc-total
- varnish-cache-hit-rate
- varnish-requests
- web-cpu
- web-memory
type: string
type: array
Acquia_Cloud_API_Documentation_subscription-uuid:
description: The subscription entity's universally unique identifier.
example: 0f3ad33e-2fe4-11e9-b210-d663bd873d93
in: path
name: subscriptionUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_tag-name:
description: The name of the application tag.
example: green
in: path
name: tagName
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_team-uuid:
description: The entity's universally unique identifier.
example: 3eef5d81-62f4-429c-aa94-e17d05ab4740
in: path
name: teamUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_to:
description: 'Optionally specifies absolute time period to retrieve results
until. Requires ISO 8601 format.
Some examples:
* `2023-09-29`
* `2023-09-29T00%3A00%3A00.000Z` (`2023-09-29T00:00:00.000Z`)
'
example: '2023-09-29'
in: query
name: to
required: false
schema:
type: string
Acquia_Cloud_API_Documentation_to-no-default:
description: An ISO-8601 formatted date retrieve results to.
example: '2021-01-29T23:55:21+00:00'
in: query
name: to
required: false
schema:
type: string
Acquia_Cloud_API_Documentation_token:
description: The token identifier.
in: path
name: token
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_token-delete-reason:
description: Specifies the reason for the token revocation for future reference.
example: The quick brown fox jumped over the lazy dog.
in: query
name: tokenDeleteReason
schema:
type: string
Acquia_Cloud_API_Documentation_token-uuid:
description: The token entity's universally unique identifier.
example: 882f3258-2fe9-11e9-b210-d663bd873d93
in: path
name: tokenUuid
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_usage-metric:
description: A usage data metric type.
example: views
in: path
name: usageMetric
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_user-search:
description: The user's username, email, name, or token. This can be a partial
match.
example: john doe
in: query
name: userSearch
required: true
schema:
type: string
Acquia_Cloud_API_Documentation_user-uuid:
description: The entity's universally unique identifier.
example: f2daa9cc-e5a0-4036-a5c8-f96e336c62b5
in: path
name: userUuid
required: true
schema:
type: string
Private_Network_Service_API_Filter:
description: 'Filter the result set using field-based criteria.
**Format:** `field:value`, `field=value` or `field:operator:value`
**Logical operators:**
- `,` (comma) - OR logic between filters
- `;` (semicolon) - AND logic between filters
- **Note:** Cannot mix OR and AND operators in the same query
**Comparison operators:**
- `=` - Equals (default if no operator specified)
- `!=` - Does not equal
- `>` - Greater than
- `<` - Less than
- `>=` - Greater than or equal to
- `<=` - Less than or equal to
- `=@` - Contains substring
- `!@` - Does not contain substring
**Wildcards:**
- `*` - Wildcard character for pattern matching
**Examples:**
- `status=active` - Filter by status equals active
- `name=@prod` - Filter by name containing "prod"
- `status=active;type=standard` - Status is active AND type is standard
- `status=active,status=pending` - Status is active OR pending
'
example: status:active;type:standard
in: query
name: filter
required: false
schema:
pattern: ^([a-zA-Z0-9_]+[:=](?:[a-zA-Z0-9_\-*]+|[>https://docs.acquia.com/acquia-cloud/develop/api/auth/\n\
\n### Example implementation\n\nAn example PHP script for making authenticated\
\ API requests can be found here. This script uses the League/oauth2-client library, installed via Composer.\n"
title: Acquia Cloud API - Environments
version: 2.0.0
x-logo:
altText: Acquia Cloud
backgroundColor: '#FFFFFF'
url: assets/cloud-platform.svg
openapi: 3.0.0
paths:
/environments/{environmentId}:
delete:
description: Deletes a CD environment.
operationId: deleteEnvironment
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/6992a41d-a953-4ded-ae99-41d2f4d62f69
self:
href: https://cloud.acquia.com/api/environments/123-a027502b-ad6c-a48e-a7e8-aa0def7d25e1
message: The environment is being deleted.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'403':
content:
application/hal+json:
examples:
Cannot delete CD environments on non-hosted applications:
value:
error: forbidden
message: CD environments cannot be deleted on non-hosted applications.
Cannot delete environments for managed applications:
value:
error: forbidden
message: Environments cannot be deleted for Service Management-enabled
applications.
Cannot delete environments on Node.js applications:
value:
error: forbidden
message: Environments cannot be deleted on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to delete this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Application Not found:
value:
error: not_found
message: The application you are trying to access does not exist,
or you do not have permission to access it.
Environment Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deletes a CD Environment.
tags:
- Environments
x-cli-name: environments:delete
get:
description: 'Return details about a specific environment.
To find your environment ID via API:
1. Make a request to GET `/api/applications/[uuid]/environments`.
2. Find the entry that matches your environment. If you don''t know the application
UUID, first make a request to GET `/api/applications`.
To find your environment ID via cloud.acquia.com:
1. Open [https://cloud.acquia.com](https://cloud.acquia.com).
2. Navigate to your application.
3. Navigate to the environment.
4. See the environment ID in the browser URL.
For example, in this URL `https://cloud.acquia.com/app/develop/applications/53785bca-1946-4adc-a022-e50d24686c20/environments/289576-53785bca-1946-4adc-a022-e50d24686c20`,
the environment id is `289576-53785bca-1946-4adc-a022-e50d24686c20`.
'
operationId: getEnvironment
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
application:
_links:
self:
href: https://cloud.acquia.com/api/applications/a47ac10b-58cc-4372-a567-0e02b2c3d470
name: Sample application
uuid: a47ac10b-58cc-4372-a567-0e02b2c3d470
_links:
available-runtimes:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/available-runtimes
cdn:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/cdn
cloud-actions:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/cloud-actions
crons:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/crons
databases:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases
dns:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/dns
domains:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/domains
eips:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/eips
logs:
href: https://cloud.acquia.com/api/environments/8-185f07c7-9c4f-407b-8968-67892ebcb38a/logs
metrics:
href: https://cloud.acquia.com/api/environments/8-185f07c7-9c4f-407b-8968-67892ebcb38a/metrics
parent:
href: https://cloud.acquia.com/api/environments
search:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/search
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470
servers:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/servers
ssl:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/ssl
variables:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/variables
active_domain: example.com
application:
name: Sample application
uuid: a47ac10b-58cc-4372-a567-0e02b2c3d470
artifact: null
balancer: balancers
configuration:
operating_system: precise
php:
apcu: 64
client_max_body_size: 128
interned_strings_buffer: 16
max_execution_time: 300
max_input_vars: 1000
max_post_size: 256
memcached_limit: 64
memory_limit: 128
opcache: 96
upload_max_filesize: 128
version: '8.3'
default_domain: sitedev.hosted.acquia-sites.com
domains:
- sitedev.hosted.acquia-sites.com
- example.com
flags:
cde: false
cdn: false
cloud-actions: false
eips: false
email: false
hsd: false
livedev: false
multi_region: false
multicert: false
production: false
production_mode: false
remote_admin: false
varnish: true
varnish_over_ssl: false
gardener:
multi-site: example.com/admin/gardens/staging
site-update: example.com/admin/gardens/site-update
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
image_url: null
ips:
- 10.0.1.5
label: Dev
name: dev
platform: cloud
region: us-east-1
size: medium
ssh_url: site.dev@sitedev.ssh.hosted.acquia-sites.com
status: normal
type: drupal
vcs:
path: master
type: git
url: site@svn-3.hosted.acquia-sites.com:site.git
weight: 0
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Return Details About a Specific Environment.
tags:
- Environments
x-cli-name: environments:find
options:
description: Displays environment options.
operationId: optionsEnvironment
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- default: 32
maximum: 512
minimum: 32
name: apcu
step: 1
- default: 8
maximum: 32
minimum: 8
name: interned_strings_buffer
step: 1
- default: 256
maximum: 1024
minimum: 0
name: client_max_body_size
step: 1
- default: 300
maximum: 300
minimum: 1
name: max_execution_time
step: 1
- default: 1000
maximum: 20000
minimum: 500
name: max_input_vars
step: 1
- default: 256
maximum: 1024
minimum: 64
name: max_post_size
step: 1
- default: 256
maximum: 1024
minimum: 0
name: upload_max_filesize
step: 1
- default: 128
maximum: 1024
minimum: 128
name: memory_limit
step: 1
- default: 64
maximum: 12288
minimum: 0
name: memcached_limit
step: 64
- default: 96
maximum: 512
minimum: 96
name: opcache
step: 1
- default: null
maximum: null
minimum: null
name: operating_system
step: null
- default: null
maximum: null
minimum: null
name: version
step: null
_links:
filter:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93{?filter}
templated: true
parent:
href: https://cloud.acquia.com/api/environments
self:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93
sort:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93{?sort}
templated: true
total: 10
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-options'
description: OK
'404':
content:
application/hal+json:
examples:
No environment or permission:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Displays Environment Options.
tags:
- Environments
put:
description: Modifies configuration settings for an environment. Note that some
settings cannot be configured for certain subscriptions.
operationId: putEnvironment
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
apcu: 32
client_max_body_size: 192
max_execution_time: 10
max_input_vars: 1000
max_post_size: 256
memcached_limit: 128
memory_limit: 192
operating_system: focal
upload_max_filesize: 192
version: '8.3'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-configuration'
application/x-www-form-urlencoded:
example:
apcu: 32
client_max_body_size: 192
max_execution_time: 10
max_input_vars: 1000
max_post_size: 256
memcached_limit: 128
memory_limit: 192
operating_system: focal
upload_max_filesize: 192
version: '8.3'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-configuration'
required: true
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/737a97a4-4c02-47e4-9924-d008de1aa7e5
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93
message: The environment configuration is being updated.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
No changes requested:
value:
error: forbidden
message:
system: No environment configuration changes are specified.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot delete CD environments on non-hosted applications:
value:
error: forbidden
message: CD environments cannot be deleted on non-hosted applications.
Cannot delete environments on Node.js applications:
value:
error: forbidden
message: Environments cannot be deleted on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to delete this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not available for static applications:
value:
error: not_available
message: Environment configuration cannot be modified for static
applications.
Not found:
value:
error: not_found
message: The application you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Conflict:
value:
error: conflict
message: operating_system cannot be configured on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Modifies Configuration Settings for an Environment.
tags:
- Environments
x-cli-name: environments:update
/environments/{environmentId}/actions/change-label:
post:
deprecated: true
description: Change the label for an environment.
operationId: postChangeEnvironmentLabel
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
label: New Label
schema:
properties:
label:
description: The new environment label.
type: string
required:
- label
type: object
application/x-www-form-urlencoded:
example:
label: New Label
schema:
properties:
label:
description: The new environment label.
type: string
required:
- label
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Changing label:
value:
message: Changing environment label.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
Label already used:
value:
error: validation_failed
message:
label: Another environment within this application already has
this label.
Missing parameter:
value:
error: validation_failed
message:
name: 'Missing required parameter(s): example_param'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to change the label for this
environment.
Labels can only be changed on hosted applications:
value:
error: forbidden
message: Environment labels cannot be changed on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Bad Request
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Change the Label for an Environment.
tags:
- Environments
x-cli-name: environments:label-update
/environments/{environmentId}/actions/clear-caches:
post:
description: Clear caches for Varnish and Platform CDN (if Platform CDN is enabled).
operationId: postEnvironmentsClearCaches
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
domains:
- domain1.example.com
- domain2.example.com
schema:
properties:
domains:
description: A list of domains to clear the caches for.
items:
format: hostname
type: string
type: array
required:
- domains
required: true
responses:
'202':
content:
application/hal+json:
examples:
Clearing cache:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42b56cff-0b55-4bdf-a949-1fd0fca61c6c
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/actions/clear-caches
message: Caches are being cleared.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
Can only be cleared on hosting applications:
value:
error: forbidden
message: Caches cannot be cleared on non-hosted applications.
Cannot be cleared for Node.js applications:
value:
error: forbidden
message: Caches cannot be cleared on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to clear caches on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Clears the Caches for One or More Domains Attached to This Environment.
tags:
- Environments
x-cli-name: environments:clear-caches
/environments/{environmentId}/artifacts/actions/switch:
post:
description: Deploys an artifact to this environment.
operationId: postDeployArtifact
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
artifact_id: '123'
schema:
properties:
artifact_id:
description: The id of the artifact to deploy.
type: string
required:
- artifact_id
type: object
application/x-www-form-urlencoded:
example:
artifact_id: '123'
schema:
properties:
artifact_id:
description: The id of the artifact to deploy.
type: string
required:
- artifact_id
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Deploying artifact:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/737a97a4-4c02-47e4-9924-d008de1aa7e5
self:
href: https://cloud.acquia.com/api/environments/642-99d416c4-88b5-48c0-ae8e-4719007d7b8d/artifacts/actions/switch
message: Deploying artifact.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Only ready artifacts can be deployed:
value:
error: validation_failed
message:
artifact_id: Only artifacts that are in the 'ready' state can
be deployed.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Forbidden
'403':
content:
application/hal+json:
examples:
Cannot be deployed on Node.js applications:
value:
error: forbidden
message: Artifacts can only be deployed on Node.js applications.
Cannot be deployed on managed applications:
value:
error: forbidden
message: Artifacts cannot be deployed on Service Management-enabled
applications.
Cannot be deployed on non-hosted applications:
value:
error: forbidden
message: Artifacts cannot be deployed on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to deploy an artifact to this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Bad Request
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not found:
value:
error: conflict
message: The artifact with ID 123 does not belong to this application
and cannot be deployed.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deploys an Artifact to This Environment.
tags:
- Environments
x-cli-name: environments:artifact-deploy
/environments/{environmentId}/available-runtimes:
get:
description: Returns a list of available runtimes.
operationId: getAvailableRuntimes
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93
self:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93/available-runtimes
runtime: php
versions:
- '8.2'
- '8.3'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_available-runtimes'
description: OK
'404':
content:
application/hal+json:
examples:
Do not exist on non-hosted applications:
value:
error: not_found
message: Available runtimes do not exist on non-hosted applications.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Not found or insufficient permissions:
value:
error: not_found
message: The available runtimes you are trying to access do not
exist, or you do not have permission to access them.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Return a List of Runtimes.
tags:
- Environments
x-cli-name: environments:runtime-list
/environments/{environmentId}/cdn:
delete:
description: Disables a CDN for an environment.
operationId: deleteCdnByEnvironmentId
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/ea01b886-40bb-c028-b3de-4353e25fa462
parent:
href: https://cloud.acquia.com/api/environments/8237-8675-93b8-4f45-cf515fec-e016647b53d4
self:
href: https://cloud.acquia.com/api/environments/8237-8675-93b8-4f45-cf515fec-e016647b53d4/cdn
message: Deprovisioning Platform CDN.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have sufficient permission to disable CDN
for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not enabled:
value:
error: conflict
message: Platform CDN is not enabled for this environment.
Not supported:
value:
error: conflict
message: This environment does not support Platform CDN.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Disables a CDN for an Environment.
tags:
- Environments
x-cli-name: environments:cdn-disable
get:
description: Returns the CDN status for an environment. The CDN must be enabled
for the status to be displayed.
operationId: getCdnByEnvironmentId
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/cdn
status: active
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_cdn'
description: OK
'404':
content:
application/hal+json:
examples:
CDN not found:
value:
error: not_found
message: The CDN you are trying to access does not exist, or you
do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns the CDN Status for an Environment.
tags:
- Environments
x-cli-name: environments:cdn-find
post:
description: Enables a CDN for an environment.
operationId: postCdnByEnvironmentId
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/ea01b886-40bb-c028-b3de-4353e25fa462
parent:
href: https://cloud.acquia.com/api/environments/8237-8675-93b8-4f45-cf515fec-e016647b53d4
self:
href: https://cloud.acquia.com/api/environments/8237-8675-93b8-4f45-cf515fec-e016647b53d4/cdn
message: Provisioning Platform CDN.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have sufficient permission to enable CDN for
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Already enabled:
value:
error: conflict
message: Platform CDN is already enabled for this environment.
Not supported:
value:
error: conflict
message: This environment does not support Platform CDN.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Enables a CDN for an Environment.
tags:
- Environments
x-cli-name: environments:cdn-enable
/environments/{environmentId}/cloud-actions:
get:
description: Returns a list of Cloud Actions on an environment.
operationId: getEnvironmentCloudActions
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions/f668295f-cbba-472d-8b75-c76ab89e553a
description: Backs up all environment databases
flags:
default: true
enabled: false
id: f668295f-cbba-472d-8b75-c76ab89e553a
label: Backup all databases
type: pre-deployment
- _links:
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions/fb4aa87a-8be2-42c6-bdf0-ef9d09a3de70
description: Turns on maintenance mode on the Drupal site
flags:
default: true
enabled: false
id: fb4aa87a-8be2-42c6-bdf0-ef9d09a3de70
label: Turn on Drupal maintenance mode
type: pre-deployment
- _links:
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions/102590e4-382b-4726-8b3f-855d5ca4225d
description: Clears all Drupal caches
flags:
default: false
enabled: false
id: 102590e4-382b-4726-8b3f-855d5ca4225d
label: Clear all Drupal caches
type: pre-deployment
_links:
filter:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions{?filter}
templated: true
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions
sort:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions{?sort}
templated: true
total: 3
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_cloud-actions'
description: OK
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to manage Cloud Actions on
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Cloud Actions unavailable:
value:
error: not_found
message: Cloud Actions are not available for this environment.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns a List of Cloud Actions.
tags:
- Environments
x-cli-name: environments:cloud-actions-find
put:
description: Modifies an existing list of Cloud Actions on an environment.
operationId: putEnvironmentCloudActions
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
cloud-actions:
9440be70-c042-47ae-9134-e85acbbd6edf: false
fb4aa87a-8be2-42c6-bdf0-ef9d09a3de70: true
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_put-cloud-actions'
application/x-www-form-urlencoded:
example:
cloud-actions:
9440be70-c042-47ae-9134-e85acbbd6edf: false
fb4aa87a-8be2-42c6-bdf0-ef9d09a3de70: true
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_put-cloud-actions'
required: true
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42047305-e30c-4c7e-931f-5407ce55a9e9
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions
message: Cloud Actions have been updated.
notification: 42047305-e30c-4c7e-931f-5407ce55a9e9
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to manage Cloud Actions on
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Modifies an Existing List of Cloud Actions.
tags:
- Environments
x-cli-name: environments:cloud-actions-update
/environments/{environmentId}/cloud-actions/actions/disable:
post:
description: Disables Cloud Actions on an environment.
operationId: postEnvironmentCloudActionsDisable
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/2d49d11c-f81d-46dd-89f2-fb7f2f54335f
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions
message: Cloud Actions have been disabled.
notification: 2d49d11c-f81d-46dd-89f2-fb7f2f54335f
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to manage Cloud Actions on
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Disables Cloud Actions.
tags:
- Environments
x-cli-name: environments:cloud-actions-disable
/environments/{environmentId}/cloud-actions/actions/enable:
post:
description: Enables Cloud Actions on an environment.
operationId: postEnvironmentCloudActionsEnable
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/003e8200-6105-48bc-80a7-6ba378ac8e91
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions/actions
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions/actions/enable
message: Cloud Actions have been enabled.
notification: 003e8200-6105-48bc-80a7-6ba378ac8e91
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to manage Cloud Actions on
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Enables Cloud Actions.
tags:
- Environments
x-cli-name: environments:cloud-actions-enable
/environments/{environmentId}/cloud-actions/actions/reset:
post:
description: Resets Cloud Actions to the default on an environment.
operationId: postEnvironmentCloudActionsReset
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/e5a15d33-ee5a-4af1-bfeb-4e76b3d33b4b
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions/actions
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/cloud-actions/actions/reset
message: Cloud Actions have been reset to the default.
notification: e5a15d33-ee5a-4af1-bfeb-4e76b3d33b4b
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to manage Cloud Actions on
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Resets Cloud Actions.
tags:
- Environments
x-cli-name: environments:cloud-actions-reset
/environments/{environmentId}/code:
post:
description: Deploys code to this environment.
operationId: postEnvironmentsDeployCode
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
cloud-actions: []
message: Optional commit message
source: 14-0c7e79ab-1c4a-424e-8446-76ae8be7e851
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_deploy-code'
application/x-www-form-urlencoded:
example:
cloud-actions: []
message: Optional commit message
source: 14-0c7e79ab-1c4a-424e-8446-76ae8be7e851
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_deploy-code'
required: true
responses:
'202':
content:
application/hal+json:
examples:
Code being deployed:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/a49eeebb-0929-444a-972c-07b94ce93ab9
parent:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93
self:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93/code
message: Deploying code.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Can only be deployed to environment within same application:
value:
error: validation_failed
message:
source: Code can only be deployed from an environment within
the same application.
Missing parameter:
value:
error: validation_failed
message:
name: 'Missing required parameter(s): example_param'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot deploy code on Node.js applications:
value:
error: forbidden
message: Code cannot be deployed on Node.js applications.
Cannot deploy code on non-hosted applications:
value:
error: forbidden
message: Code cannot be deployed on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to deploy code to this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Cannot be deployed to itself:
value:
error: conflict
message: Code cannot be deployed from an environment to itself.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deploys Code to This Environment.
tags:
- Environments
x-cli-name: environments:code-deploy
/environments/{environmentId}/code/actions/import:
post:
description: Imports a site to this environment.
operationId: postEnvironmentsImportSite
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
name: Drupal 8
url: http://www.example.com/path/to/site.tar.gz
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_import-site'
application/x-www-form-urlencoded:
example:
name: Drupal 8
url: http://www.example.com/path/to/site.tar.gz
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_import-site'
required: true
responses:
'202':
content:
application/hal+json:
examples:
Site is being imported:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/d82a122d-b7b8-46fc-9999-39cb824fac8d
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/code/actions/import
message: The site is being imported.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Cannot be imported on application:
value:
error: validation_failed
message:
general: Sites cannot be imported on this application.
File format not supported:
value:
error: validation_failed
message:
general: The installation file is not supported. It must be
a Drush make file (.make) or a Gzip-compressed tar archive
(.tar.gz or .tgz).
Invalid URL:
value:
error: validation_failed
message:
url: Invalid URL format.
Missing parameter:
value:
error: validation_failed
message:
name: 'Missing required parameter(s): example_param'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to deploy code to this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not found:
value:
error: conflict
message: Sites cannot be imported on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Imports a Site to This Environment.
tags:
- Environments
x-cli-name: environments:site-import
/environments/{environmentId}/code/actions/switch:
post:
description: Switches code on this environment to a different branch or release
tag.
operationId: postEnvironmentsSwitchCode
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
branch: my-feature-branch
cloud-actions: []
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_switch-code'
application/x-www-form-urlencoded:
example:
branch: my-feature-branch
cloud-actions: []
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_switch-code'
required: true
responses:
'202':
content:
application/hal+json:
examples:
Switching code:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/bfd9a39b-a85e-4de3-8a70-042d1c7e607a
self:
href: https://cloud.acquia.com/api/environments/861-ddccebef-eb2f-48ce-a92f-e0a16a3a0b53/code/actions/switch
message: Switching code.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Branch does not exist:
value:
error: validation_failed
message:
branch: The branch or tag "my-feature-branch" does not exist
within this environment.
Invalid branch name:
value:
error: validation_failed
message:
branch: The branch name contains invalid characters.
Missing parameter:
value:
error: validation_failed
message:
name: 'Missing required parameter(s): example_param'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot deploy code on Node.js applications:
value:
error: forbidden
message: Code cannot be switched on Node.js applications.
Cannot deploy code on non-hosted applications:
value:
error: forbidden
message: Code cannot be deployed on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to deploy code to this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Switches Code on This Environment to a Different Branch or Release
Tag.
tags:
- Environments
x-cli-name: environments:code-switch
/environments/{environmentId}/crons:
get:
description: Returns a list of the cron jobs on an environment.
operationId: getCronJobsByEnvironmentId
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/crons/e82b77cc-a9ed-4458-b12c-d87af1a795ad
command: /usr/local/bin/drush cc all
day_month: '*'
day_week: '*'
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
enabled: true
on_any_web: false
system: false
hour: '7'
id: e82b77cc-a9ed-4458-b12c-d87af1a795ad
label: Clear drush caches
minute: '25'
month: '*'
server:
id: '18'
name: web-18
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/crons/8eea655e-71be-4c71-bf5b-9c5c9a5c5b43
command: /usr/local/bin/drush -r /var/www/html/qa3/docroot ah-db-backup
dbname
day_month: '*'
day_week: '*'
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
enabled: false
on_any_web: false
system: true
hour: '9'
id: 8eea655e-71be-4c71-bf5b-9c5c9a5c5b43
label: Run backup
minute: '12'
month: '*'
server:
id: '6'
name: web-6
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/crons
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_crons'
description: OK
'404':
content:
application/hal+json:
examples:
Non-hosted application:
value:
error: not_found
message: Cron jobs do not exist on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Return Environment Cron Jobs.
tags:
- Environments
x-cli-name: environments:cron-job-list
post:
description: Creates a scheduled job with cron on an environment.
operationId: postEnvironmentCrons
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
command: /usr/local/bin/drush cc all
frequency: '*/30 * * * *'
label: My New Cron
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_post-cron'
application/x-www-form-urlencoded:
example:
command: /usr/local/bin/drush cc all
frequency: '*/30 * * * *'
label: My New Cron
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_post-cron'
required: true
responses:
'202':
content:
application/hal+json:
examples:
Adding cron:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/01fde3bb-b65f-4629-b761-9072a35e8e50
parent:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons/936a55fd-29eb-4317-bb6e-ad2a94b24589
message: Creating a new cron.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Invalid frequency:
value:
error: validation_failed
message:
frequency: The cron frequency does not appear to be valid.
Label in use:
value:
error: validation_failed
message:
name: The label for the cron is already used by another cron.
Please choose another label.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to create a cron in this environment.
Node.js application:
value:
error: forbidden
message: Cron jobs are not available for Node.js applications.
Non-hosted application:
value:
error: forbidden
message: Cron jobs cannot be created on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Cron not found:
value:
error: not_found
message: The cron does not belong to this environment, and cannot
be updated.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Creates a Scheduled Job with Cron.
tags:
- Environments
x-cli-name: environments:cron-create
/environments/{environmentId}/crons/{cronId}:
delete:
description: Deletes a cron job.
operationId: postEnvironmentCronDelete
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_cron-id'
responses:
'202':
content:
application/hal+json:
examples:
Deleting cron:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/767cee8d-05f6-4761-a3dc-755957dfc9e6
parent:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons/1891
message: Deleting cron.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to delete this cron.
Node.js application:
value:
error: forbidden
message: Cron jobs are not available for Node.js applications.
Non hosted application:
value:
error: forbidden
message: Cron jobs cannot be deleted on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment mismatch:
value:
error: not_found
message: The cron does not belong to this environment, and cannot
be removed.
No environment or permission:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deletes a Cron Job.
tags:
- Environments
x-cli-name: environments:cron-delete
get:
description: Return details about a specific cron job by environment ID and
cron job ID.
operationId: getCron
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_cron-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/crons
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/crons/e82b77cc-a9ed-4458-b12c-d87af1a795ad
command: /usr/local/bin/drush cc all
day_month: '*'
day_week: '*'
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
enabled: true
on_any_web: true
system: false
hour: '7'
id: e82b77cc-a9ed-4458-b12c-d87af1a795ad
label: Clear drush caches
minute: '25'
month: '*'
server:
id: '18'
name: web-18
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_cron'
description: OK
'404':
content:
application/hal+json:
examples:
Non-hosted application:
value:
error: not_found
message: Cron jobs do not exist on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Return Details About a Specific Cron Job.
tags:
- Environments
x-cli-name: environments:cron-find
put:
description: Modify an existing scheduled job on an environment.
operationId: putCron
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_cron-id'
requestBody:
content:
application/hal+json:
example:
command: /usr/local/bin/drush7 cc all
frequency: '*/5 * * * *'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_put-cron'
application/x-www-form-urlencoded:
example:
command: /usr/local/bin/drush7 cc all
frequency: '*/5 * * * *'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_put-cron'
required: true
responses:
'202':
content:
application/hal+json:
examples:
Update cron:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/ba232d96-dfe7-4850-9ca7-02e01a04f58d
parent:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons/2582
message: Updating cron.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to modify this cron.
Node.js applications:
value:
error: forbidden
message: Cron jobs are not available for Node.js applications.
Non-hosted application:
value:
error: forbidden
message: Cron jobs are not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment mismatch:
value:
error: not_found
message: The cron does not belong to this environment, and cannot
be updated.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Invalid frequency:
value:
error: validation_failed
message:
frequency: The cron frequency does not appear to be valid.
Label in use:
value:
error: conflict
message:
name: The label for the cron is already used by another cron.
Please choose another label.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Modify an Existing Scheduled Job.
tags:
- Environments
x-cli-name: environments:cron-update
/environments/{environmentId}/crons/{cronId}/actions/disable:
post:
description: Disables a cron job.
operationId: postEnvironmentCronDisable
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_cron-id'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/7b37b885-8ae4-454b-b8fa-ffaeff54f6a4
parent:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/crons/1234/actions
self:
href: https://cloud.acquia.com/api/environments/123-af127084-204d-430c-a2b7-3a6130269b27/crons/1234/actions/disable
message: The cron is being disabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to modify this cron.
Non-hosted application:
value:
error: forbidden
message: Cron jobs cannot be disabled on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment mismatch:
value:
error: not_found
message: The cron does not belong to this environment, and cannot
be disabled.
No cron or permission:
value:
error: not_found
message: The cron you are trying to access does not exist, or
you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Action currently unavailable:
value:
error: conflict
message: The cron is already disabled. No action taken.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Disables a Cron Job.
tags:
- Environments
x-cli-name: environments:cron-disable
/environments/{environmentId}/crons/{cronId}/actions/enable:
post:
description: Enables a cron job.
operationId: postEnvironmentCronEnable
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_cron-id'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/ceda2e82-54b7-4181-ae97-6a3163b187b8
parent:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons/1889/actions
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/crons/1889/actions/enable
message: The cron is being enabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to modify this cron.
Non-hosted application:
value:
error: forbidden
message: Cron jobs cannot be enabled on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment mismatch:
value:
error: not_found
message: The cron does not belong to this environment, and cannot
be enabled.
No cron or permission:
value:
error: not_found
message: The cron you are trying to access does not exist, or
you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Action currently unavailable:
value:
error: conflict
message: The cron is already enabled. No action taken.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Enables a Cron Job.
tags:
- Environments
x-cli-name: environments:cron-enable
/environments/{environmentId}/databases:
get:
description: 'Returns a list of databases.
Filterable fields:
* `name`
* `id`
Sortable fields:
* `name`
* `id`
'
operationId: getEnvironmentsDatabases
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_sort'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_limit'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_offset'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/14
db_host: dbhost.example.com
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
default: true
id: 14
name: my_db
password: supersecretdbpassword1!
ssh_host: sshhost.example.com
url: mysql://my_db_user:supersecretdbpassword1!@dbhost.example.com/my_db
user_name: my_db_user
- _links:
self:
href: https://cloud.acquia.com/api/environments/25-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/15
db_host: dbhost.example.com
environment:
id: 25-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
default: false
id: 15
name: my_db_stage
password: supersecretdbpassword1!
ssh_host: sshhost.example.com
url: mysql://my_db_user:supersecretdbpassword1!@dbhost.example.com/my_db_stage
user_name: my_db_user
_links:
filter:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases{?filter}
templated: true
limit:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases{?limit}
templated: true
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases
sort:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases{?sort}
templated: true
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_databases'
description: OK
'404':
content:
application/hal+json:
examples:
Do not exist on Node.js applications:
value:
error: not_available
message: Databases do not exist on Node.js applications
Do not exist on non-hosted applications:
value:
error: not_found
message: Databases do not exist on non-hosted applications.
Not found:
value:
error: not_found
message: The application you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns a List of Databases.
tags:
- Environments
x-cli-name: environments:database-list
post:
description: Copies a database to this environment.
operationId: postEnvironmentsDatabases
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
name: db_name
source: 14-0c7e79ab-1c4a-424e-8446-76ae8be7e851
schema:
properties:
name:
description: The name of the database to copy to the selected environment.
type: string
source:
description: The ID of the environment to copy the database from.
minLength: 38
type: string
required:
- name
- source
type: object
application/x-www-form-urlencoded:
example:
name: db_name
source: 14-0c7e79ab-1c4a-424e-8446-76ae8be7e851
schema:
properties:
name:
description: The name of the database to copy to the selected environment.
type: string
source:
description: The ID of the environment to copy the database from.
minLength: 38
type: string
required:
- name
- source
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Database being copied:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/a49eeebb-0929-444a-972c-07b94ce93ab9
parent:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93
self:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93/databases
message: The database is being copied
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Database does not exist in environment:
value:
error: validation_failed
message:
database: The database does not exist in this environment.
Missing parameter:
value:
error: validation_failed
message:
name: 'Missing required parameter(s): example_param'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Action not available on Node.js applications:
value:
error: forbidden
message: Databases cannot be copied on Node.js applications.
Action not available on non-hosted applications:
value:
error: forbidden
message: Databases cannot be copied on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to copy this database.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Cannot be copied to itself:
value:
error: conflict
message: A database cannot be copied from an environment to itself.
Cannot be copied to production:
value:
error: conflict
message: A database cannot be copied to an environment that is
currently in production mode.
Must belong to same application:
value:
error: conflict
message: The environments do not belong to the same application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Copies a Database to This Environment.
tags:
- Environments
x-cli-name: environments:database-copy
/environments/{environmentId}/databases/{databaseName}:
get:
description: Return details about a specific database.
operationId: getEnvironmentsDatabase
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
responses:
'200':
content:
application/hal+json:
example:
_links:
backups:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/14/backups
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases
php-config:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/14/php-config
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/14
db_host: dbhost.example.com
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
default: true
id: 14
name: my_db
password: supersecretdbpassword1!
ssh_host: sshhost.example.com
url: mysql://my_db_user:supersecretdbpassword1!@dbhost.example.com/my_db
user_name: my_db_user
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_database'
description: OK
'404':
content:
application/hal+json:
examples:
Database not found:
value:
error: not_found
message: The database you are trying to access does not exist,
or you do not have permission to access it.
Do not exist on Node.js applications:
value:
error: not_available
message: Databases do not exist on Node.js applications
Do not exist on non-hosted applications:
value:
error: not_found
message: Databases do not exist on non-hosted applications.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Return Details About a Specific Database.
tags:
- Environments
x-cli-name: environments:database-find
/environments/{environmentId}/databases/{databaseName}/backups:
get:
description: 'Returns a list of backups.
Filterable fields:
* `type`
* `created` Specifies an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
formatted date.
Sortable fields:
* `type`
* `created`
'
operationId: getEnvironmentsDatabaseBackups
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_deprecated-from'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_deprecated-to'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_sort'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_limit'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_offset'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
download:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/1/actions/download
parent:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/1
completed_at: '2012-05-15T12:00:00Z'
database:
id: 14
name: db_name
environment:
id: 1-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: Production
flags:
deleted: false
id: 1
started_at: '2012-05-15T12:00:00Z'
type: daily
- _links:
download:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/2/actions/download
parent:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/2
completed_at: '2012-03-28T12:00:01Z'
database:
id: 14
name: db_name
environment:
id: 1-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: Production
flags:
deleted: false
id: 2
started_at: '2012-03-28T12:00:00Z'
type: daily
- _links:
download:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/3/actions/download
parent:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/3
completed_at: '2017-01-08T04:00:01Z'
database:
id: 14
name: db_name
environment:
id: 1-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: Production
flags:
deleted: false
id: 3
started_at: '2017-01-08T04:00:00Z'
type: daily
- _links:
download:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/4/actions/download
parent:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups/4
completed_at: '2017-01-08T05:00:03Z'
database:
id: 14
name: db_name
environment:
id: 1-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: Production
flags:
deleted: false
id: 4
started_at: '2017-01-08T05:00:02Z'
type: daily
_links:
filter:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups{?filter}
templated: true
limit:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups{?limit}
templated: true
offset:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups{?offset}
templated: true
parent:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups
sort:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name/backups{?sort}
templated: true
pagination:
limit: 2
offset: 0
total: 2
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_backups'
description: OK
'404':
content:
application/hal+json:
examples:
Do not exist on Node.js applications:
value:
error: not_available
message: Databases do not exist on Node.js applications
Do not exist on non-hosted applications:
value:
error: not_found
message: Databases do not exist on non-hosted applications.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns a List of Backups.
tags:
- Environments
x-cli-name: environments:database-backup-list
post:
description: Create a backup.
operationId: postEnvironmentsDatabaseBackups
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
responses:
'202':
content:
application/hal+json:
examples:
Creating backup:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42b56cff-0b55-4bdf-a949-1fd0fca61c6c
parent:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/databases/my_db/
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/databases/my_db/backups/
message: Creating the backup.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Database does not exist in environment:
value:
error: validation_failed
message:
database: The database does not exist in this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Action not available on Node.js applications:
value:
error: forbidden
message: Database backups do not exist on Node.js applications.
Action not available on non-hosted applications:
value:
error: forbidden
message: Database backups are not available on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to backup this database.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Create a Backup.
tags:
- Environments
x-cli-name: environments:database-backup-create
/environments/{environmentId}/databases/{databaseName}/backups/{backupId}:
delete:
description: Deletes a database backup.
operationId: deleteEnvironmentsDatabaseBackup
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_backup-id'
responses:
'202':
content:
application/hal+json:
examples:
Deleting backup:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42b56cff-0b55-4bdf-a949-1fd0fca61c6c
parent:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/databases/my_db/backups
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/databases/my_db/backups/1
message: Deleting the database backup.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Database does not exist in environment:
value:
error: validation_failed
message:
backup: The database does not exist in this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Action not available on Node.js applications:
value:
error: forbidden
message: Database backups do not exist on Node.js applications.
Action not available on non-hosted applications:
value:
error: forbidden
message: Database backups are not available on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to delete this backup.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Database not found:
value:
error: not_found
message: The database you are trying to access does not exist,
or you do not have permission to access it.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deletes a Database Backup.
tags:
- Environments
x-cli-name: environments:database-backup-delete
get:
description: Return details about a specific backup.
operationId: getEnvironmentsDatabaseBackup
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_backup-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
database:
_links:
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/databases/db_name
id: 14
name: db_name
environment:
_links:
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470
id: 1-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: Production
_links:
download:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/database-backups/1/actions/download
parent:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/database-backups
self:
href: https://cloud.acquia.com/api/environments/1-a47ac10b-58cc-4372-a567-0e02b2c3d470/database-backups/1
completed_at: '2012-05-15T12:00:00Z'
database:
id: 14
name: db_name
environment:
id: 1-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: Production
flags:
deleted: false
id: 1
started_at: '2012-05-15T12:00:00Z'
type: daily
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_backup'
description: OK
'404':
content:
application/hal+json:
examples:
Database backup not found:
value:
error: not_found
message: The database backup you are trying to access does not
exist, or you do not have permission to access it.
Do not exist on Node.js applications:
value:
error: not_available
message: Databases backups do not exist on Node.js applications
Do not exist on non-hosted applications:
value:
error: not_found
message: Databases backups do not exist on non-hosted applications.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Return Details About a Specific Backup.
tags:
- Environments
x-cli-name: environments:database-backup-find
/environments/{environmentId}/databases/{databaseName}/backups/{backupId}/actions/download:
get:
description: Downloads the database backup file.
operationId: getEnvironmentsDatabaseDownloadBackup
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_backup-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/8a1c8503-0dae-4b08-a917-d2f01f4971ca
parent:
href: https://cloud.acquia.com/api/environments/12-482e4650-1b74-44db-8d4e-e86a3b1ed908/databases/sitedatabase/backups/4423492/actions
self:
href: https://cloud.acquia.com/api/environments/12-482e4650-1b74-44db-8d4e-e86a3b1ed908/databases/sitedatabase/backups/4423492/actions/download
expires_at: '2020-06-16T15:15:05+00:00'
url: http://example.com/backup.gz
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_file-download'
application/octet-stream:
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_file'
text/html:
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_file-download'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to download this backup.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Database not found:
value:
error: not_found
message: The database backup you are trying to access does not
exist, or you do not have permission to access it.
Do not exist on Node.js applications:
value:
error: not_available
message: Databases backups do not exist on Node.js applications
Do not exist on non-hosted applications:
value:
error: not_found
message: Databases backups do not exist on non-hosted applications.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Downloads the Database Backup File.
tags:
- Environments
x-cli-name: environments:database-backup-download
/environments/{environmentId}/databases/{databaseName}/backups/{backupId}/actions/restore:
post:
description: Restores this backup to the appropriate environment's database.
operationId: postEnvironmentsDatabaseRestoreBackup
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_backup-id'
responses:
'202':
content:
application/hal+json:
examples:
Restoring backup:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/f295cd91-c3c0-422c-a1ab-e91fe972041a
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/databases/test_database_1/backups/4189098/actions/restore
message: Restoring the database backup.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Does not belong to environment:
value:
error: validation_error
message:
backup: The database backup does not belong to this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Action not available on Node.js applications:
value:
error: forbidden
message: Database backups cannot be restored on Node.js applications.
Action not available on non-hosted applications:
value:
error: forbidden
message: Database backups cannot be restored on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to restore a backup to this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Database not found:
value:
error: not_found
message: The database you are trying to access does not exist,
or you do not have permission to access it.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Database not available:
value:
error: conflict
message: The database backup has not completed yet, and cannot
be restored at this time.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Restores This Backup to the Appropriate Environment's Database.
tags:
- Environments
x-cli-name: environments:database-backup-restore
/environments/{environmentId}/databases/{databaseName}/php-config:
get:
description: Returns PHP configuration details for this database.
operationId: getEnvironmentsDatabasePhpConfig
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_database-name'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/databases/mydb
self:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/databases/mydb/php-config
drupal: "if (file_exists('/var/www/site-php')) {\n\trequire '/var/www/site-php/sitegroup/myenv-settings.inc';\n\
}"
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_database-php-config'
description: OK
'404':
content:
application/hal+json:
examples:
Database not found:
value:
error: not_found
message: The database you are trying to access does not exist,
or you do not have permission to access it.
Do not exist on Node.js applications:
value:
error: not_available
message: Databases do not exist on Node.js applications
Do not exist on non-hosted applications:
value:
error: not_found
message: Databases do not exist on non-hosted applications.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns PHP Configuration Details for This Database.
tags:
- Environments
x-cli-name: environments:database-php-config-find
/environments/{environmentId}/dns:
get:
description: Returns environment DNS configuration information for apex domain
and subdomains.
operationId: getEnvironmentsDns
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-47c9ae06-2a57-11e9-b210-d663bd873d93
self:
href: https://cloud.acquia.com/api/environments/24-47c9ae06-2a57-11e9-b210-d663bd873d93/dns
apex_domain:
- type: A
value: 192.0.2.1
- type: AAAA
value: 2001:0db8:1729:aa03:80b5:1c65:bea:42ff
global_configuration:
apex_domain:
- type: A
value: 192.0.2.3
- type: A
value: 192.0.2.4
- type: AAAA
value: 2001:0db8:1730:aa03:80b5:1c65:bea:42ff
subdomains:
- type: CNAME
value: subdomain.example.com
regional_configuration:
apex_domain:
- type: A
value: 192.0.2.1
- type: AAAA
value: 2001:0db8:1729:aa03:80b5:1c65:bea:42ff
subdomains:
- type: CNAME
value: subdomain.example.com
subdomains:
- type: CNAME
value: subdomain.example.com
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_dns'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns DNS Configuration Details for an Environment.
tags:
- Environments
x-cli-name: environments:dns-find
/environments/{environmentId}/domains:
get:
description: 'Returns a list of domains.
Filterable fields:
* `hostname`
Sortable fields:
* `hostname`
'
operationId: getEnvironmentsDomains
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_sort'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_limit'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_offset'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470/domains/www.example.com
status:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470/domains/www.example.com/status
cdn:
status: installing
environment:
id: 24-abcd1234-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
active: true
default: true
wildcard: false
hostname: www.example.com
- _links:
dns:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470/dns
self:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470/domains/other.example.com
status:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470/domains/other.example.com/status
cdn: null
environment:
id: 24-abcd1234-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
active: false
default: false
wildcard: false
hostname: other.example.com
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470/domains/*.example.com
cdn:
status: active
environment:
id: 24-abcd1234-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
active: false
default: false
wildcard: true
hostname: '*.example.com'
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470
self:
href: https://cloud.acquia.com/api/environments/24-abcd1234-58cc-4372-a567-0e02b2c3d470/domains
total: 3
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_domains'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Only available for hosted applications:
value:
error: not_found
message: Domain names do not exist on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns a List of Domains.
tags:
- Environments
x-cli-name: environments:domain-list
post:
description: Adds a domain to the environment.
operationId: postEnvironmentsDomains
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
hostname: example.com
schema:
properties:
hostname:
description: The domain name to add.
format: hostname
maxLength: 253
minLength: 3
type: string
type: object
application/x-www-form-urlencoded:
example:
hostname: example.com
schema:
properties:
hostname:
description: The domain name to add.
maxLength: 253
minLength: 3
type: string
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Adding domain:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/737a97a4-4c02-47e4-9924-d008de1aa7e5
parent:
href: https://cloud.acquia.com/api/environments/642-99d416c4-88b5-48c0-ae8e-4719007d7b8d
self:
href: https://cloud.acquia.com/api/environments/642-99d416c4-88b5-48c0-ae8e-4719007d7b8d/domains
message: Adding domain example.com
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
Can only be created on hosted applications:
value:
error: forbidden
message: Domains cannot be created on non-hosted applications.
Cannot be added with Acquia Cloud Free:
value:
error: forbidden
message: Domains cannot be added on Acquia Cloud Free subscriptions.
Cannot be added with Acquia Cloud Site Factory:
value:
error: forbidden
message: Domains cannot be added on Acquia Cloud Site Factory
applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to add a domain to this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Cannot add names to application:
value:
error: forbidden
message: You cannot add domain names on this application.
Domain name already used:
value:
error: forbidden
message: The domain name cannot be used, as it already exists
within this application's environments.
Error adding domain name:
value:
error: forbidden
message: This domain cannot be added to this environment. For
more details, contact Acquia Support.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Adds a Domain to the Environment.
tags:
- Environments
x-cli-name: environments:domain-create
/environments/{environmentId}/domains/actions/clear-varnish:
post:
deprecated: true
description: Clears the Varnish cache for one or more domains attached to this
environment.
operationId: postEnvironmentsDomainsClearVarnish
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
domains:
- domain1.example.com
- domain2.example.com
schema:
properties:
domains:
description: A list of domains to clear the Varnish cache for.
items:
format: hostname
type: string
type: array
required:
- domains
required: true
responses:
'202':
content:
application/hal+json:
examples:
Clearing cache:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42b56cff-0b55-4bdf-a949-1fd0fca61c6c
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/domains/actions/clear-varnish
message: Varnish is being cleared for the selected domains.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
Can only be cleared on hosting applications:
value:
error: forbidden
message: Varnish cannot be cleared on non-hosted applications.
Cannot be cleared for Node.js applications:
value:
error: forbidden
message: Varnish cannot be cleared on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to clear Varnish on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Clears the Varnish Cache for One or More Domains Attached to
This Environment.
tags:
- Environments
x-cli-name: environments:domains-clear-varnish
/environments/{environmentId}/domains/{domain}:
delete:
description: Removes the domain from this environment.
operationId: deleteEnvironmentsDomain
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_domain'
responses:
'202':
content:
application/hal+json:
examples:
Deleting domain:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/67b7f08f-2dff-4c86-a8a0-35c4196880a3
parent:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/domains
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/domains/example.com
message: Removing the domain example.com
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
Can only be removed on hosted applications:
value:
error: forbidden
message: Domains cannot be removed on non-hosted applications.
Cannot be removed with Acquia Cloud Site Factory:
value:
error: forbidden
message: Domains cannot be removed on Acquia Cloud Site Factory
applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to remove domains on this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Domain not found:
value:
error: not_found
message: The domain you are trying to delete does not exist, or
you do not have permission to modify it.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Removes the Domain from This Environment.
tags:
- Environments
x-cli-name: environments:domain-delete
get:
description: Return details about a specific domain.
operationId: getEnvironmentsDomain
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_domain'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-47c9ae06-2a57-11e9-b210-d663bd873d93/domains
self:
href: https://cloud.acquia.com/api/environments/24-47c9ae06-2a57-11e9-b210-d663bd873d93/domains/example.com
status:
href: https://cloud.acquia.com/api/environments/24-47c9ae06-2a57-11e9-b210-d663bd873d93/domains/example.com/status
cdn:
status: active
environment:
id: 24-47c9ae06-2a57-11e9-b210-d663bd873d93
name: dev
flags:
active: true
default: false
wildcard: false
hostname: example.com
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_domain'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Only exist on hosted applications:
value:
error: not_found
message: Domain names do not exist on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Return Details About a Specific Domain.
tags:
- Environments
x-cli-name: environments:domain-find
/environments/{environmentId}/domains/{domain}/actions/clear-caches:
post:
description: Clear caches for Varnish and Platform CDN (if Platform CDN is enabled).
operationId: postEnvironmentsDomainClearCaches
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_domain'
responses:
'202':
content:
application/hal+json:
examples:
Clearing cache:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42b56cff-0b55-4bdf-a949-1fd0fca61c6c
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/domains/example.com/actions/clear-caches
message: Caches are being cleared.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
Can only be cleared on hosting applications:
value:
error: forbidden
message: Caches cannot be cleared on non-hosted applications.
Cannot be cleared for Node.js applications:
value:
error: forbidden
message: Caches cannot be cleared on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to clear caches on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Clears the Caches for the Specified Domain.
tags:
- Environments
x-cli-name: environments:domain-clear-caches
/environments/{environmentId}/domains/{domain}/actions/clear-varnish:
post:
deprecated: true
description: Clears the Varnish cache for the specified domain.
operationId: postEnvironmentsDomainClearVarnish
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_domain'
responses:
'202':
content:
application/hal+json:
examples:
Clearing cache:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42b56cff-0b55-4bdf-a949-1fd0fca61c6c
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/domains/example.com/actions/clear-varnish
message: Varnish is being cleared for domain 'example.com'.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
Can only be cleared on hosting applications:
value:
error: forbidden
message: Varnish cannot be cleared on non-hosted applications.
Cannot be cleared for Node.js applications:
value:
error: forbidden
message: Varnish cannot be cleared on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to clear Varnish on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Clears the Varnish Cache for the Specified Domain.
tags:
- Environments
x-cli-name: environments:domain-clear-varnish
/environments/{environmentId}/domains/{domain}/status:
get:
description: Returns details about the domain.
operationId: getEnvironmentsDomainStatus
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_domain'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/domains/example.com
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/domains/example.com/status
cnames:
- another.example.com
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
acquia_hosted: true
active: true
default: false
dns_resolves: true
hostname: example.com
ip_addresses:
- 12.23.34.45
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_domain-status'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Unable to determine status:
value:
error: not_found
message: Unable to determine status for this domain.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns Details About the Domain.
tags:
- Environments
x-cli-name: environments:domain-status-find
/environments/{environmentId}/eips:
get:
description: Returns a list of Web EIPs.
operationId: getEIPs
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- flags:
active: true
deprecated: false
legacy: false
id: f668295f-cbba-472d-8b75-c76ab89e553a
ipv4: 203.0.113.1
ipv6: 0:0:0:0:0:ffff:cb00:7101
status: created
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/eips
total: 1
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_eips'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Return a List of Web EIPs.
tags:
- Environments
x-cli-name: environments:eips-list
/environments/{environmentId}/files:
post:
description: Copies files to this environment.
operationId: postEnvironmentsFiles
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
source: 14-0c7e79ab-1c4a-424e-8446-76ae8be7e851
schema:
properties:
source:
description: The ID of the environment to copy files from.
type: string
type: object
application/x-www-form-urlencoded:
example:
source: 14-0c7e79ab-1c4a-424e-8446-76ae8be7e851
schema:
properties:
source:
description: The ID of the environment to copy files from.
type: string
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Files queued for copying:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/d53fccec-5c1b-4ad4-b431-5cd39ad2b453
parent:
href: https://cloud.acquia.com/api/environments/12-482e4650-1b74-44db-8d4e-e86a3b1ed908/files
self:
href: https://cloud.acquia.com/api/environments/12-482e4650-1b74-44db-8d4e-e86a3b1ed908/files
message: Copying files.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Missing parameter:
value:
error: validation_failed
message:
name: 'Missing required parameter(s): example_param'
Must be within same application:
value:
error: validation_failed
message:
name: Files can only be copied from an environment within the
same application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot be copied on Node.js applications:
value:
error: forbidden
message: Files cannot be copied on Node.js applications.
Cannot be copied on non-hosted applications:
value:
error: forbidden
message: Files cannot be copied on non-hosted applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to copy files to this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Cannot be copied to itself:
value:
error: conflict
message: Files cannot be copied from an environment to itself.
Cannot be copied to production:
value:
error: conflict
message: Files cannot be copied to an environment that is currently
in production mode.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Copies Files to This Environment.
tags:
- Environments
x-cli-name: environments:file-copy
/environments/{environmentId}/livedev/actions/disable:
post:
deprecated: true
description: Disable Live Development on this environment.
operationId: postEnvironmentsDisableLiveDev
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
discard: 1
schema:
properties:
discard:
description: Indicates whether uncommitted changes should be discarded
or not.
maximum: 1
minimum: 0
type: integer
type: object
application/x-www-form-urlencoded:
example:
discard: 1
schema:
properties:
discard:
description: Indicates whether uncommitted changes should be discarded
or not.
maximum: 1
minimum: 0
type: integer
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Disabling LiveDev:
value:
message: Disabling LiveDev.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
LiveDev cannot be disabled on production:
value:
error: validation_failed
message:
livedev: LiveDev cannot be disabled on a production environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to disable LiveDev for this
environment.
LiveDev is not available on Node.js applications:
value:
error: forbidden
message: LiveDev is not available on Node.js applications.
LiveDev is not available on managed applications:
value:
error: forbidden
message: LiveDev is not available for Service Management-enabled
applications.
Only available on hosted applications:
value:
error: forbidden
message: LiveDev is not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Cannot be enabled or disabled on production:
value:
error: validation_failed
message: LiveDev cannot be disabled or enabled on a production
environment.
LiveDev already disabled:
value:
error: validation_failed
message: LiveDev is already disabled on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Disable Live Development on This Environment.
tags:
- Environments
x-cli-name: environments:livedev-disable
/environments/{environmentId}/livedev/actions/enable:
post:
deprecated: true
description: Enable Live Development on this environment. Not supported on Acquia
Cloud Next.
operationId: postEnvironmentsEnableLiveDev
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'202':
content:
application/hal+json:
examples:
Enabling LiveDev:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/737a97a4-4c02-47e4-9924-d008de1aa7e5
self:
href: https://cloud.acquia.com/api/environments/642-99d416c4-88b5-48c0-ae8e-4719007d7b8d/livedev/actions/enable
message: Enabling LiveDev.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Cannot be enabled on CDE:
value:
error: validation_failed
message:
livedev: LiveDev cannot be enabled on a CD environment.
Cannot be enabled on production:
value:
error: validation_failed
message:
livedev: LiveDev cannot be enabled on a production environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot cannot be enabled on Node.js applications:
value:
error: forbidden
message: LiveDev cannot be enabled on Node.js applications.
Cannot cannot be enabled on managed applications:
value:
error: forbidden
message: LiveDev cannot be enabled for Service Management-enabled
applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to enable LiveDev for this
environment.
Only available on hosted applications:
value:
error: forbidden
message: LiveDev cannot be enabled on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
LiveDev already enabled:
value:
error: validation_failed
message: LiveDev is already enabled on this environment.
LiveDev not supported:
value:
error: conflict
message: LiveDev is not available for Cloud Next environments.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Enable Live Development on This Environment.
tags:
- Environments
x-cli-name: environments:livedev-enable
/environments/{environmentId}/log-forwarding-destinations:
get:
description: 'Returns a collection of log forwarding destinations for this environment.
Filterable fields:
* `label`
* `consumer`
Sortable fields:
* `label`
'
operationId: getEnvironmentsLogForwardingDestinations
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_sort'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_limit'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_offset'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations/df4c5428-8d2e-453d-9edf-e412647449b1
address: example.com:1234
consumer: sumologic
credentials:
certificate:
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
expires_at: '2018-07-16T16:15:33+00:00'
key: null
token: 204d892b449026f6e4ded264c8891c400df8fc8905f07beb5f70d706f6d4d5e5
environment:
id: 123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577
name: Test
flags:
certificate_expiring: false
enabled: true
health:
code: '200'
details: Destination OK
summary: OK
label: Test destination
sources:
- apache-access
- apache-error
status: active
uuid: df4c5428-8d2e-453d-9edf-e412647449b1
- _links:
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations/df4c5428-8d2e-453d-9edf-e412647449b5
address: 193.169.2.19:5678
consumer: syslog
credentials:
certificate:
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
expires_at: '2018-07-16T16:15:33+00:00'
key: 1d0789d519c0b943cf38f401d30ffbdcd2e0c4cfb7c32ebc0c872bce62aadd4d
token: 204d892b449026f6e4ded264c8891c400df8fc8905f07beb5f70d706f6d4d5e5
environment:
id: 123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577
name: Test
flags:
certificate_expiring: true
enabled: false
health:
code: '200'
details: Destination OK
summary: OK
label: Another test destination
sources:
- drupal-request
- drupal-watchdog
status: active
uuid: df4c5428-8d2e-453d-9edf-e412647449b5
_links:
parent:
href: https://cloud.acquia.com/api/environments/5-185f07c7-9c4f-407b-8968-67892ebcb38a
self:
href: https://cloud.acquia.com/api/environments/5-185f07c7-9c4f-407b-8968-67892ebcb38a/log-forwarding-destinations
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_log-forwarding-destinations'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to view the log forwarding
destinations for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns a Collection of Log Forwarding Destinations for This
Environment.
tags:
- Environments
x-cli-name: environments:log-forwarding-destination-list
post:
description: Creates a log forwarding destination.
operationId: postEnvironmentsLogForwardingDestinations
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
address: example.com:1234
consumer: syslog
credentials:
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
label: Test destination
sources:
- apache-access
- apache-error
schema:
properties:
address:
description: The URL or host name and port of the destination.
format: uri
type: string
consumer:
description: The application or provider consuming the logs.
enum:
- loggly
- splunk
- sumologic
- syslog
type: string
credentials:
description: Credential information.
properties:
certificate:
description: A public X.509 certificate in PEM format. Required
for Splunk, Sumologic, and Syslog. Not supported by Loggly.
type: string
key:
description: A certificate private key associated with the consumer.
Optional for Splunk, Sumologic, and Syslog. Not supported
by Loggly
type: string
token:
description: An API token associated with the consumer. Required
by Logly and Sumologic. Optional for Syslog. Not supported
by Splunk.
type: string
required:
- certificate
type: object
label:
description: The human-friendly identifier of the destination.
type: string
sources:
description: The list of log sources to forward.
items:
enum:
- apache-access
- apache-error
- varnish-access
- drupal-request
- drupal-watchdog
- php-error
- stdout
- stderr
type: string
type: array
required:
- label
- sources
- consumer
- credentials
type: object
required: true
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/bc17cfd2-487b-4e10-b3cf-9fe1f0c10e3f
parent:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/log-forwarding-destinations/95739829-0093-4673-9ee0-5f5bdac04d11
message: Log forwarding destination for the environment has been created.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Address invalid:
value:
error: validation_failed
message:
address: \"invalid-address\" is not a valid address.
At Log Forwarding destination maximum:
value:
error: validation_failed
message:
general: Environments may only have 2 log forwarding destinations.
Certificate expired:
value:
error: validation_failed
message:
credentials: The certificate is expired.
Certificate expiring:
value:
error: validation_failed
message:
credentials: The certificate is expiring. Certificates must
be valid for at least 30 days.
Certificate invalid:
value:
error: validation_failed
message:
credentials: The certificate is invalid.
Certificate not yet active:
value:
error: validation_failed
message:
credentials: The certificate is not yet active.
Consumer not supported:
value:
error: validation_failed
message:
consumer: \"invalid-consumer\" is not a supported consumer.
Log Forwarding not enabled:
value:
error: validation_failed
message:
general: Destinations can only be added to environments that
have log forwarding enabled.
Loggly does not support certificate auth:
value:
error: validation_failed
message:
credentials: Loggly does not support certificate authentication.
Loggly does not support custom URLs:
value:
error: validation_failed
message:
address: Loggly does not support custom URLs.
Loggly does not support private key auth:
value:
error: validation_failed
message:
credentials: Loggly does not support private key authentication.
Loggly requires API token:
value:
error: validation_failed
message:
credentials: An API token is required for Loggly.
Source not supported:
value:
error: validation_failed
message:
sources: \"invalid-source\" is not a supported source.
Splunk does not support token auth:
value:
error: validation_failed
message:
credentials: Splunk does not support API token authentication.
Splunk only accepts socket addresses:
value:
error: validation_failed
message:
address: Splunk only accepts socket addresses, consisting of
a host and port.
Splunk requires public certificate:
value:
error: validation_failed
message:
credentials: A public X.509 certificate is required for Splunk.
Sumologic only accepts socket addresses:
value:
error: validation_failed
message:
address: Sumologic only accepts socket addresses, consisting
of a host and port.
Sumologic requires public certificate:
value:
error: validation_failed
message:
credentials: A public X.509 certificate is required for Sumologic.
Sumologic requires token:
value:
error: validation_failed
message:
credentials: An API token is required for Sumologic.
Syslog only accepts socket addresses:
value:
error: validation_failed
message:
address: Syslog only accepts socket addresses, consisting of
a host and port.
Syslog requires public certificate:
value:
error: validation_failed
message:
credentials: A public X.509 certificate is required for Syslog.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to create a log forwarding
destinations for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Creates a Log Forwarding Destination.
tags:
- Environments
x-cli-name: environments:log-forwarding-destination-create
/environments/{environmentId}/log-forwarding-destinations/{logForwardingDestinationUuid}:
delete:
description: Deletes the specified log forwarding destination.
operationId: deleteEnvironmentsLogForwardingDestination
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-forwarding-destination-uuid'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/dfe6afd7-3619-4ab7-8aef-ab26fb506b3a
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations/df4c5428-8d2e-453d-9edf-e412647449b1
message: Log forwarding destination has been deleted.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Log Forwarding not enabled:
value:
error: invalid_operation
message:
general: Destinations can only be removed from environments
that have log forwarding enabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to delete the log forwarding
destination.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Log Forwarding destination not found on Environment:
value:
error: invalid_operation
message: The environment does not have a log forwarding destination
with the UUID 2c15b578-d31a-48ac-ab28-a8ef4c65f02b.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Deletes the Specified Log Forwarding Destination.
tags:
- Environments
x-cli-name: environments:log-forwarding-destination-delete
get:
description: Returns the specified log forwarding destination.
operationId: getEnvironmentsLogForwardingDestination
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-forwarding-destination-uuid'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations/df4c5428-8d2e-453d-9edf-e412647449b1
address: example.com:1234
consumer: syslog
credentials:
certificate:
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
expires_at: '2018-07-16T16:15:33+00:00'
key: 1d0789d519c0b943cf38f401d30ffbdcd2e0c4cfb7c32ebc0c872bce62aadd4d
token: 204d892b449026f6e4ded264c8891c400df8fc8905f07beb5f70d706f6d4d5e5
environment:
id: 123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577
name: Test
flags:
certificate_expiring: false
enabled: true
health:
code: '200'
details: Destination OK
summary: OK
label: Test destination
sources:
- apache-access
- apache-error
status: active
uuid: df4c5428-8d2e-453d-9edf-e412647449b1
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_log-forwarding-destination'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to view the log forwarding
destination.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Log Forwarding destination not found:
value:
error: not_found
message: The log forwarding destination you are trying to access
does not exist, or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns the Specified Log Forwarding Destination.
tags:
- Environments
x-cli-name: environments:log-forwarding-destination-find
put:
description: Updates an environment's log forwarding destination.
operationId: putEnvironmentsLogForwardingDestination
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-forwarding-destination-uuid'
requestBody:
content:
application/hal+json:
example:
address: example.com:1234
consumer: syslog
credentials:
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
label: Test destination
sources:
- apache-access
- apache-error
schema:
properties:
address:
description: The URL or host name and port of the destination.
format: uri
type: string
consumer:
description: The application or provider consuming the logs.
enum:
- loggly
- splunk
- sumologic
- syslog
type: string
credentials:
description: Credential information.
properties:
certificate:
description: A public X.509 certificate in PEM format. Required
for Splunk, Sumologic, and Syslog. Not supported by Loggly.
type: string
key:
description: A certificate private key associated with the consumer.
Optional for Splunk, Sumologic, and Syslog. Not supported
by Loggly
type: string
token:
description: An API token associated with the consumer. Required
by Logly and Sumologic. Optional for Syslog. Not supported
by Splunk.
type: string
required:
- certificate
type: object
label:
description: The human-friendly identifier of the destination.
type: string
sources:
description: The list of log sources to forward.
items:
enum:
- apache-access
- apache-error
- varnish-access
- drupal-request
- drupal-watchdog
- php-error
- stdout
- stderr
type: string
type: array
required:
- consumer
type: object
required: true
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/340bf831-5377-49b9-7b26-87014b653346
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations/cf4c5328-8d2e-353d-9edf-e412647349b1
message: Log forwarding destination has been updated.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Address invalid:
value:
error: validation_failed
message:
address: \"invalid-address\" is not a valid address.
At Log Forwarding destination maximum:
value:
error: validation_failed
message:
general: Environments may only have 2 log forwarding destinations.
Certificate expired:
value:
error: validation_failed
message:
credentials: The certificate is expired.
Certificate expiring:
value:
error: validation_failed
message:
credentials: The certificate is expiring. Certificates must
be valid for at least 30 days.
Certificate invalid:
value:
error: validation_failed
message:
credentials: The certificate is invalid.
Certificate not yet active:
value:
error: validation_failed
message:
credentials: The certificate is not yet active.
Consumer not supported:
value:
error: validation_failed
message:
consumer: \"invalid-consumer\" is not a supported consumer.
Log Forwarding not enabled:
value:
error: validation_failed
message:
general: Destinations can only be modified to environments that
have log forwarding enabled.
Loggly does not support certificate auth:
value:
error: validation_failed
message:
credentials: Loggly does not support certificate authentication.
Loggly does not support custom URLs:
value:
error: validation_failed
message:
address: Loggly does not support custom URLs.
Loggly does not support private key auth:
value:
error: validation_failed
message:
credentials: Loggly does not support private key authentication.
Loggly requires API token:
value:
error: validation_failed
message:
credentials: An API token is required for Loggly.
Source not supported:
value:
error: validation_failed
message:
sources: \"invalid-source\" is not a supported source.
Splunk does not support token auth:
value:
error: validation_failed
message:
credentials: Splunk does not support API token authentication.
Splunk only accepts socket addresses:
value:
error: validation_failed
message:
address: Splunk only accepts socket addresses, consisting of
a host and port.
Splunk requires public certificate:
value:
error: validation_failed
message:
credentials: A public X.509 certificate is required for Splunk.
Sumologic only accepts socket addresses:
value:
error: validation_failed
message:
address: Sumologic only accepts socket addresses, consisting
of a host and port.
Sumologic requires public certificate:
value:
error: validation_failed
message:
credentials: A public X.509 certificate is required for Sumologic.
Sumologic requires token:
value:
error: validation_failed
message:
credentials: An API token is required for Sumologic.
Syslog only accepts socket addresses:
value:
error: validation_failed
message:
address: Syslog only accepts socket addresses, consisting of
a host and port.
Syslog requires public certificate:
value:
error: validation_failed
message:
credentials: A public X.509 certificate is required for Syslog.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to modify the log forwarding
destination.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Log Forwarding destination not found on Environment:
value:
error: invalid_operation
message: The environment does not have a log forwarding destination
with the UUID 2c15b578-d31a-48ac-ab28-a8ef4c65f02b.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Updates an Environment's Log Forwarding Destination.
tags:
- Environments
x-cli-name: environments:log-forwarding-destination-update
/environments/{environmentId}/log-forwarding-destinations/{logForwardingDestinationUuid}/actions/disable:
post:
description: Disables the specified log forwarding destination.
operationId: postEnvironmentsDisableLogForwardingDestination
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-forwarding-destination-uuid'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/d1e9dde1-7a60-4f39-951f-295ee7fe343f
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations/df4c5428-8d2e-453d-9edf-e412647449b1
message: Log forwarding destination has been disabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Log Forwarding not enabled:
value:
error: invalid_operation
message:
general: Destinations can only be disabled on environments that
have log forwarding enabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to disable this log forwarding
destination.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Log Forwarding destination already disabled:
value:
error: invalid_operation
message: The destination is already disabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Disables the Specified Log Forwarding Destination.
tags:
- Environments
x-cli-name: environments:log-forwarding-destination-disable
/environments/{environmentId}/log-forwarding-destinations/{logForwardingDestinationUuid}/actions/enable:
post:
description: Enables the specified log forwarding destination.
operationId: postEnvironmentsEnableLogForwardingDestination
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-forwarding-destination-uuid'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/63a804eb-ad38-4f66-9644-725f0c04e87c
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/log-forwarding-destinations/df4c5428-8d2e-453d-9edf-e412647449b1
message: Log forwarding destination has been enabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Certificate expired:
value:
error: validation_failed
message:
credentials: The certificate is expired.
Certificate expiring:
value:
error: validation_failed
message:
credentials: The certificate is expiring. Certificates must
be valid for at least 30 days.
Certificate invalid:
value:
error: validation_failed
message:
credentials: The certificate is invalid.
Certificate not yet active:
value:
error: validation_failed
message:
credentials: The certificate is not yet active.
Log Forwarding not enabled:
value:
error: invalid_operation
message:
general: Destinations can only be enabled on environments that
have log forwarding enabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to enable this log forwarding
destination.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Log Forwarding destination not found on Environment:
value:
error: invalid_operation
message: The destination is already enabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Enables the Specified Log Forwarding Destination.
tags:
- Environments
x-cli-name: environments:log-forwarding-destination-enable
/environments/{environmentId}/logs:
get:
description: Returns a list of log files for this environment available for
download.
operationId: getEnvironmentsLogs
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/apache-access
flags:
available: false
label: Apache access
name: apache-access
type: apache-access
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/apache-error
flags:
available: false
label: Apache error
name: apache-error
type: apache-error
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/drupal-request
flags:
available: false
label: Drupal request
name: drupal-request
type: drupal-request
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/drupal-watchdog
flags:
available: false
label: Drupal watchdog
name: drupal-watchdog
type: drupal-watchdog
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/fpm-access
flags:
available: false
label: Fpm access
name: fpm-access
type: fpm-access
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/fpm-error
flags:
available: false
label: Fpm error
name: fpm-error
type: fpm-error
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/php-error
flags:
available: false
label: PHP error
name: php-error
type: php-error
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/cloud-hook
flags:
available: false
label: Cloud hook
name: cloud-hook
type: cloud-hook
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/cronjob
flags:
available: false
label: Cronjob
name: cronjob
type: cronjob
- _links:
download:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs/mysql-slow-query
flags:
available: true
label: MySQL slow query
name: mysql-slow-query
type: mysql-slow-query
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851
self:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logs
total: 6
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_logs'
description: OK
'404':
content:
application/hal+json:
examples:
Do not exist on non-hosted applications:
value:
error: not_found
message: Logs cannot be accessed on non-hosted environments.
Not found:
value:
error: not_found
message: The application you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns a List of Log Files for This Environment Available for
Download.
tags:
- Environments
x-cli-name: environments:log-list
/environments/{environmentId}/logs/{logType}:
get:
description: Downloads the log file.
operationId: getEnvironmentsLog
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-type'
responses:
'200':
content:
application/hal+json:
examples:
File download:
value:
expires_at: '2019-11-30T23:21:02+00:00'
url: http://appsiteenv.host.site-example.com/AH_DOWNLOAD?d=/mnt/gfs/appsiteenv/logs/log_type_log_appsiteenv_1574901901.sql&t=157492&env=fecac803549db0072661378f0f
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_file-download'
application/octet-stream:
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_file'
text/html:
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_file-download'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to download logs for this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Cannot be downloaded on non-hosted applications:
value:
error: not_found
message: Logs cannot be downloaded on non-hosted environments.
Does not exist:
value:
error: not_found
message: The file you are trying to access does not exist.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Downloads the Log File.
tags:
- Environments
x-cli-name: environments:log-download
post:
description: Creates a log file snapshot.
operationId: postEnvironmentsLog
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_log-type'
requestBody:
content:
application/hal+json:
example:
from: '2021-01-28T22:45:21+00:00'
to: '2021-01-29T23:55:21+00:00'
schema:
properties:
from:
description: An ISO-8601 formatted date retrieve results from. Date
ranges are only supported on Acquia Cloud Next.
type: string
to:
description: An ISO-8601 formatted date retrieve results to. Date
ranges are only supported on Acquia Cloud Next.
type: string
type: object
required: false
responses:
'201':
content:
application/hal+json:
examples:
Is being created:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/8b790313-8830-4810-baef-3b41b3786e9d
parent:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/logs
self:
href: https://cloud.acquia.com/api/environments/123-ea9060c5-1ed8-46ec-87d5-2ce2a0861577/logs/apache-access
message: The log file is being created.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Created
'400':
content:
application/hal+json:
examples:
Invalid range:
value:
error: validation_failed
message:
general: Log snapshots must cover no more than 24 hours and
can only be retrieved up to 30 days in the past.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to download logs for this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Cannot be accessed on non-hosted applications:
value:
error: not_found
message: Logs cannot be accessed on non-hosted environments.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Date range not supported:
value:
error: conflict
message: Date ranges for log file snapshots are not supported
on this environment.
Log snapshot not supported:
value:
error: conflict
message: Log snapshots are not supported on this environment.
Log type not supported:
value:
error: conflict
message: Log file snapshot for mysql-slow-query is not available
on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Creates a Log File Snapshot.
tags:
- Environments
x-cli-name: environments:log-create
/environments/{environmentId}/logstream:
get:
description: Returns a logstream url and metadata.
operationId: getEnvironmentsLogstream
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851
self:
href: https://cloud.acquia.com/api/environments/24-0c7e79ab-1c4a-424e-8446-76ae8be7e851/logstream
wss:
href: wss://logstream.example.com/ah_websocket/logstream/v1
logstream:
commands:
- stream-environment
- enable
- disable
params:
environment: prod
hmac: d8b940bb5a1865e57b22734d541ed981c89f952e527b0a983d0e457437a43c23
site: clouduidev:qa4
t: 1516990002
url: wss://logstream.example.com/ah_websocket/logstream/v1
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_logstream'
description: OK
'404':
content:
application/hal+json:
examples:
Do not exist on non-hosted applications:
value:
error: not_found
message: Logs cannot be accessed on non-hosted environments.
Not found:
value:
error: not_found
message: The application you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns a Logstream Url and Metadata.
tags:
- Environments
x-cli-name: environments:logstream-find
/environments/{environmentId}/metrics:
get:
description: Does not return any data. Allows traversal to metrics groups endpoints.
operationId: getEnvironmentsMetrics
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/18-185f07c7-9c4f-407b-8968-67892ebcb38a
self:
href: https://cloud.acquia.com/api/environments/18-185f07c7-9c4f-407b-8968-67892ebcb38a/metrics
stackmetrics:
href: https://cloud.acquia.com/api/environments/18-185f07c7-9c4f-407b-8968-67892ebcb38a/metrics/stackmetrics
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_metrics'
description: OK
'403':
content:
application/hal+json:
examples:
Not available on Acquia Cloud Free:
value:
error: forbidden
message: Metrics are not available to Acquia Cloud Free subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Does Not Return Any Data. Allows Traversal to Metrics Groups
Endpoints.
tags:
- Environments
x-cli-name: environments:metrics
/environments/{environmentId}/metrics/stackmetrics:
get:
description: Does not return any data. Allows traversal to StackMetrics endpoints.
operationId: getEnvironmentsStackMetrics
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
data:
href: https://cloud.acquia.com/api/environments/18-185f07c7-9c4f-407b-8968-67892ebcb38a/metrics/stackmetrics/data
parent:
href: https://cloud.acquia.com/api/environments/18-185f07c7-9c4f-407b-8968-67892ebcb38a/metrics
self:
href: https://cloud.acquia.com/api/environments/18-185f07c7-9c4f-407b-8968-67892ebcb38a/metrics/stackmetrics
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_metrics'
description: OK
'403':
content:
application/hal+json:
examples:
Not available on Acquia Cloud Free:
value:
error: forbidden
message: Metrics are not available to Acquia Cloud Free subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Does Not Return Any Data. Allows Traversal to StackMetrics Endpoints.
tags:
- Environments
x-cli-name: environments:stack-metrics-data-list
/environments/{environmentId}/metrics/stackmetrics/data:
get:
description: Returns StackMetrics data for the metrics specified by the filter
paramater (e.g., apache-access, web-cpu).
operationId: getEnvironmentsStackMetricsData
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter-stack-metrics'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_from-stack-metrics'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_to-no-default'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_resolution'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- datapoints:
- - '2.5395360194838'
- '1447876380'
- - '3.3012513318685'
- '1447876680'
- - '4.568567607842'
- '1447876980'
last_data_at: '2019-06-19T00:00:00+00:00'
metadata:
host: fsdb-1.prod.hosting.acquia.com
metric: db-cpu
- datapoints:
- - '22.1395360194838'
- '1447876380'
- - '23.7012513318685'
- '1447876680'
- - '24.168567607842'
- '1447876980'
last_data_at: '2019-06-19T00:00:00+00:00'
metadata:
host: fsdb-2.prod.hosting.acquia.com
metric: db-cpu
- datapoints:
- - '12.1395360194838'
- '1447876380'
- - '12.7012513318685'
- '1447876680'
- - '12.168567607842'
- '1447876980'
last_data_at: '2019-06-19T00:00:00+00:00'
metadata:
host: web-1.prod.hosting.acquia.com
metric: web-cpu
- datapoints:
- - '2.1395360194838'
- '1447876380'
- - '2.7012513318685'
- '1447876680'
- - '2.168567607842'
- '1447876980'
last_data_at: '2019-06-19T00:00:00+00:00'
metadata:
host: web-2.prod.hosting.acquia.com
metric: web-cpu
_links:
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/metrics/stackmetrics/data?filter=metric=db-cpu,metric=web-cpu&from=2019-06-20
total: 4
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_stack-metrics-data'
description: OK
'403':
content:
application/hal+json:
examples:
Not available on Acquia Cloud Free:
value:
error: forbidden
message: Metrics are not available to Acquia Cloud Free subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns StackMetrics Data for the Metrics Specified in the Filter
Paramater (e.g., Apache-access, Web-cpu).
tags:
- Environments
x-cli-name: environments:stack-metrics-data-find
/environments/{environmentId}/metrics/usage:
get:
description: Retrieves traversal links for an environment's usage data.
operationId: getEnvironmentsUsageLinks
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
data:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/data
parent:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics
self:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage
views:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/views
visits:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/visits
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_usage'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to view usage metrics for
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Retrieves Traversal Links for an Environment's Usage Data.
tags:
- Environments
x-cli-name: environments:usage-links
/environments/{environmentId}/metrics/usage/data:
get:
description: 'Filterable fields:
* `metric` - One of: {`views`, `visits`}
'
operationId: getEnvironmentsUsageData
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter-usage-metrics'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_resolution'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
parent:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage
self:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/views
datapoints:
- - '2019-03-13T00:00:00+00:00'
- '9'
- - '2019-03-14T00:00:00+00:00'
- '1'
last_data_at: '2019-03-14T00:00:00+00:00'
metadata:
application:
uuids:
- 1df8bff7-ffda-4571-b64a-f90f60f4dbf8
environment:
ids:
- 123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8
subscription:
uuids:
- 9567a611-4cdd-4586-8b3f-f3980a87e471
metric: views
- _links:
parent:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage
self:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/visits
datapoints:
- - '2019-03-13T00:00:00+00:00'
- '3'
- - '2019-03-14T00:00:00+00:00'
- '1'
last_data_at: '2019-03-14T00:00:00+00:00'
metadata:
application:
uuids:
- 1df8bff7-ffda-4571-b64a-f90f60f4dbf8
environment:
ids:
- 123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8
subscription:
uuids:
- 9567a611-4cdd-4586-8b3f-f3980a87e471
metric: visits
_links:
filter:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/data{?filter}
templated: true
parent:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage
self:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/data
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-usage-metrics'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to view usage metrics for
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Retrieves Usage Data for an Environment.
tags:
- Environments
x-cli-name: environments:usage-data
/environments/{environmentId}/metrics/usage/{usageMetric}:
get:
description: Retrieves usage metric data for an environment.
operationId: getEnvironmentsUsageMetricData
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_usage-metric'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter-usage-metrics'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage
self:
href: https://cloud.acquia.com/api/environments/123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8/metrics/usage/views
datapoints:
- - '2019-03-13T00:00:00+00:00'
- '9'
- - '2019-03-14T00:00:00+00:00'
- '1'
last_data_at: '2019-03-14T00:00:00+00:00'
metadata:
application:
uuids:
- 1df8bff7-ffda-4571-b64a-f90f60f4dbf8
environment:
ids:
- 123-1df8bff7-ffda-4571-b64a-f90f60f4dbf8
subscription:
uuids:
- 9567a611-4cdd-4586-8b3f-f3980a87e471
metric: views
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-usage-metric'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to view pricing metric data.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Data not found:
value:
error: not_found
message: Pricing metric data for the environment with ID @id cannot
be found, or you do not have access to it.
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Retrieves Usage Metric Data for an Environment.
tags:
- Environments
x-cli-name: environments:usage-metric-data
/environments/{environmentId}/mod-proxy:
get:
description: Returns the mod proxy status for an Environment.
operationId: getModProxyStatus
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-eba23ecc-aa7c-41b0-8aa4-9d7ef250357d
self:
href: https://cloud.acquia.com/api/environments/24-eba23ecc-aa7c-41b0-8aa4-9d7ef250357d/mod-proxy
status: active
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_mod-proxy'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not found:
value:
error: conflict
message: Mod proxy configuration is not available for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not available
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns the Mod Proxy Status for an Environment.
tags:
- Environments
x-cli-name: environments:mod-proxy-status
/environments/{environmentId}/mod-proxy/actions/disable:
post:
description: Disables mod proxy for an environment.
operationId: postDisableModProxy
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'202':
content:
application/json:
example:
_links:
self:
href: https://cloud.acquia.com/api/environments/12-5ee5d7be-ec42-4ea3-9d98-1363dcfacfd23/mod-proxy/actions/disable
message: Mod proxy is being disabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to disable mod proxy for this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/json:
examples:
No subscription or permission:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not found:
value:
error: conflict
message: Mod proxy configuration is not available for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not available
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Disables Mod Proxy for an Environment.
tags:
- Environments
x-cli-name: environments:mod-proxy-disable
/environments/{environmentId}/mod-proxy/actions/enable:
post:
description: Enables mod proxy for an environment.
operationId: postEnableModProxy
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'202':
content:
application/json:
example:
_links:
self:
href: https://cloud.acquia.com/api/environments/12-5ee5d7be-ec42-4ea3-9d98-1363dcfacfd23/mod-proxy/actions/enable
message: Mod proxy is being enabled.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to enable mod proxy for this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/json:
examples:
No subscription or permission:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not found:
value:
error: conflict
message: Mod proxy configuration is not available for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not available
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Enables Mod Proxy for an Environment.
tags:
- Environments
x-cli-name: environments:mod-proxy-enable
/environments/{environmentId}/operating-systems:
get:
description: Returns a list of operating systems.
operationId: getOperatingSystems
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93
self:
href: https://cloud.acquia.com/api/environments/24-8fc7d3c6-2a53-11e9-b210-d663bd873d93/operating-systems
versions:
- available: true
label: Ubuntu 16.04 (Xenial Xerus)
name: xenial
version: 16.0.4
- available: true
label: Ubuntu 20.04 (Focal Fossa)
name: focal
version: '20.04'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_operating-systems'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The operating systems you are trying to access do not
exist, or you do not have permission to access them.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Return a List of Operating Systems.
tags:
- Environments
x-cli-name: environments:operating-systems-list
/environments/{environmentId}/production-mode/actions/disable:
post:
description: Removes protection from a production environment, taking it out
of production mode.
operationId: postEnvironmentsDisableProductionMode
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'202':
content:
application/hal+json:
examples:
Production mode disabled:
value:
message: Production mode has been disabled for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
Only production can be unprotected:
value:
error: validation_failed
message:
productionmode: Only production environments can be unprotected.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot cannot be disabled on Node.js applications:
value:
error: forbidden
message: Production mode is not available on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to disable Production mode
for this environment.
Only available on hosted applications:
value:
error: forbidden
message: Production mode is not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not in production mode:
value:
error: conflict
message: This environment is not currently in production mode.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Disables Production Mode for an Environment.
tags:
- Environments
x-cli-name: environments:production-mode-disable
/environments/{environmentId}/production-mode/actions/enable:
post:
description: Enables production mode for an environment. While production mode
is enabled, files and databases cannot be copied to the production environment.
operationId: postEnvironmentsEnableProductionMode
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'202':
content:
application/hal+json:
examples:
Production mode enabled:
value:
message: Production mode has been enabled for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
Only production can be protected:
value:
error: validation_failed
message:
productionmode: Only production environments can be protected.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot cannot be enabled on Node.js applications:
value:
error: forbidden
message: Production mode cannot be enabled on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to enable Production mode
for this environment.
Only available on hosted applications:
value:
error: forbidden
message: Production mode is not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Already in production mode:
value:
error: conflict
message: This environment is already in production mode.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Enables Production Mode for an Environment.
tags:
- Environments
x-cli-name: environments:production-mode-enable
/environments/{environmentId}/search:
get:
description: Does not return any data. Allows traversal to search entity endpoints.
operationId: getEnvironmentSearchList
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
indexes:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_search'
description: OK
'403':
content:
application/hal+json:
examples:
Forbidden:
value:
error: forbidden
message: You do not have permission to manage search for this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns a Traversal Endpoint for Search Entities for the Environment.
tags:
- Environments
x-cli-name: environments:search:list
/environments/{environmentId}/search/indexes:
get:
description: A collection of search indexes for an environment.
operationId: getEnvironmentSearchIndexes
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _embedded:
configuration_set:
_links:
parent:
href: https://cloud.acquia.com/api/applications/3f6d06a9-9236-411e-9dcc-44f0003a5905/search/config-sets
self:
href: https://cloud.acquia.com/api/applications/3f6d06a9-9236-411e-9dcc-44f0003a5905/search/config-sets/shared-1234567891011-121
application_uuid: 3f6d06a9-9236-411e-9dcc-44f0003a5905
flags:
custom: false
id: shared-1234567891011-121
label: example-0
status: active
_links:
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/ABCDE-1234.test.example
config_set_id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
database_role: example
environment_id: 123-3f6d06a9-9236-411e-9dcc-44f0003a5905
id: ABCDE-1234.test.example
solr_version: '7'
status: active
url: https://example.com/solr/ABCDE-1234.test.example/
- _embedded:
configuration_set:
_links:
parent:
href: https://cloud.acquia.com/api/applications/3f6d06a9-9236-411e-9dcc-44f0003a5905/search/config-sets
self:
href: https://cloud.acquia.com/api/applications/3f6d06a9-9236-411e-9dcc-44f0003a5905/search/config-sets/ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
application_uuid: 3f6d06a9-9236-411e-9dcc-44f0003a5905
flags:
custom: true
id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
label: example-1
status: pending
_links:
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/ABCDE-1235.test.example
config_set_id: ABCD5-1234.12345ab6c7e8f90g12i1jk234l56mn78
database_role: example
environment_id: 123-3f6d06a9-9236-411e-9dcc-44f0003a5905
id: ABCDE-1235.test.example
solr_version: '7'
status: active
url: https://example.com/solr/ABCDE-1235.test.example/
_links:
filter:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes{?filter}
templated: true
limit:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes{?limit}
templated: true
offset:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes{?offset}
templated: true
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes
sort:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes{?sort}
templated: true
pagination:
limit: 0
offset: 0
total: 2
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_indexes'
description: OK
'403':
content:
application/hal+json:
example:
error: forbidden
message: You do not have permission to view the search indexes on
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
example:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns a Collection of Search Indexes for an Environment.
tags:
- Environments
x-cli-name: environments:search:indexes-list
post:
description: Creates a search index for an environment.
operationId: postEnvironmentSearchIndexes
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
config_set_id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
database_role: example
schema:
properties:
config_set_id:
description: A configuration set ID to assign to the index.
type: string
database_role:
description: The database role for the search index.
type: string
required:
- database_role
type: object
application/x-www-form-urlencoded:
example:
config_set_id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
database_role: example
schema:
properties:
config_set_id:
description: A configuration set ID to assign to the index.
type: string
database_role:
description: The database role for the search index.
type: string
required:
- database_role
type: object
required: true
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/5494cbe6-fe98-4cfa-877b-05bab3be3bf8
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/ABCDE-1234.test.example
message: The search index for example is being created.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
example:
error: forbidden
message: You do not have permission to create search configuration
sets on this application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Configuration set not found or not enough permission:
value:
error: not_found
message: The configuration set you are trying to access does not
exist, or you do not have permission to access it.
Environment not found or not enough permission:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Configuration set not available:
value:
error: validation_failed
message: The configuration set is not available for this environment.
Database does not exist:
value:
error: validation_failed
message: The database does not exist in this environment.
Search index already available:
value:
error: validation_failed
message: The search index is already available for this environment.
Search not available:
value:
error: validation_failed
message: Acquia Search is not available for this subscription.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Creates a Search Index for an Environment.
tags:
- Environments
x-cli-name: environments:search:index-create
/environments/{environmentId}/search/indexes/{indexId}:
delete:
description: Removes and deletes a specific search index from an environment
operationId: deleteEnvironmentSearchIndex
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_index-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/d64552a2-7e3e-46af-b2a0-b122aae26a7d
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/ABCDE-1234.test.example
message: The search index has been removed from the environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
example:
error: forbidden
message: You do not have permission to delete search indexes on this
environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
No application or not enough permissions:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Search index not available:
value:
error: not_found
message: The search index is not available to this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
example:
error: validation_failed
message: Acquia Search is not available for this subscription.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Removes and Deletes a Specific Search Index from an Environment
tags:
- Environments
x-cli-name: environments:search:index-delete
get:
description: A specific search configuration set.
operationId: getEnvironmentSearchIndex
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_index-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
configuration_set:
_links:
parent:
href: https://cloud.acquia.com/api/applications/3f6d06a9-9236-411e-9dcc-44f0003a5905/search/config-sets
self:
href: https://cloud.acquia.com/api/applications/3f6d06a9-9236-411e-9dcc-44f0003a5905/search/config-sets/ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
application_uuid: 3f6d06a9-9236-411e-9dcc-44f0003a5905
flags:
custom: true
id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
label: example-1
status: pending
_links:
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/ABCDE-1234.test.example
config_set_id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
database_role: example
environment_id: 123-3f6d06a9-9236-411e-9dcc-44f0003a5905
health:
code: OK
details: No issues.
summary: Search index active
id: ABCDE-1234.test.example
solr_version: '7'
status: active
url: https://example.com/solr/ABCDE-1234.test.example/
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_index'
description: OK
'403':
content:
application/hal+json:
example:
error: forbidden
message: You do not have permission to view the search indexes on
this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
No environment or not enough permissions:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
No index or not enough permissions:
value:
error: not_found
message: The search index you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns a Search Configuration Set for an Application
tags:
- Environments
x-cli-name: environments:search:index-find
put:
description: Updates a search index on an environment.
operationId: putEnvironmentSearchIndex
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_index-id'
requestBody:
content:
application/hal+json:
example:
config_set_id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
schema:
properties:
config_set_id:
description: The configuration set ID to update to.
type: string
type: object
application/x-www-form-urlencoded:
example:
config_set_id: ABCDE-1234.12345ab6c7e8f90g12i1jk234l56mn78
schema:
properties:
config_set_id:
description: The configuration set ID to update to.
type: string
type: object
required: true
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/a0733378-eee4-4c29-bc2d-dea85e17b1aa
parent:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/
self:
href: https://cloud.acquia.com/api/environments/123-3f6d06a9-9236-411e-9dcc-44f0003a5905/search/indexes/ABCDE-1234.test.example
message: The search index ABCDE-1234.test.example is being updated.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: OK
'403':
content:
application/hal+json:
example:
error: forbidden
message: You do not have permission to make a change in a search index
on this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
example:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Configuration set not available:
value:
error: conflict
message: The configuration set is not available for this environment.
Search not available:
value:
error: conflict
message: Acquia Search is not available for this subscription.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Updates a Search Index on an Environment.
tags:
- Environments
x-cli-name: environments:search:index-update
/environments/{environmentId}/servers:
get:
description: 'Returns a list of servers.
Filterable fields:
* `name`
* `region`
* `hostname`
* `ip`
* `status`
Sortable fields:
* `name`
* `region`
* `hostname`
* `ip`
* `status`
'
operationId: getEnvironmentsServers
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_sort'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_limit'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_offset'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/servers/6
ami_type: c1.medium
configuration:
ecu: 5
memcache: 64
memory: 1.7
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
active_bal: false
active_web: true
balancer: false
database: true
dedicated: false
elastic_ip: false
fs: false
memcache: true
primary_db: true
self_service: false
web: true
hostname: ded-6.servers.acquia.com
id: 6
ip: 10.0.0.1
name: ded-6
operating_system: xenial
region: us-west-1
roles:
- web
- db
ssh_user: user.dev
status: normal
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/servers/4
ami_type: m1.small
configuration:
ecu: 1
memcache: null
memory: 1.7
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
active_bal: false
active_web: false
balancer: true
database: false
dedicated: true
elastic_ip: false
fs: false
memcache: false
primary_db: true
self_service: false
web: false
hostname: bal-4.servers.acquia.com
id: 4
ip: 10.0.0.2
name: bal-4
operating_system: xenial
region: us-west-1
roles:
- bal
ssh_user: user.dev
status: normal
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/servers
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_servers'
description: OK
'404':
content:
application/hal+json:
examples:
Cannot be viewed for CDEs:
value:
error: not_available
message: Servers cannot be viewed for CD environments.
Cannot be viewed for managed applications:
value:
error: not_available
message: Servers cannot be viewed for Service Management-enabled
applications.
Cannot be viewed on Node.js applications:
value:
error: not_available
message: Servers cannot be viewed on Node.js applications.
Not available on non-hosted applications:
value:
error: not_found
message: Servers are not available on non-hosted applications.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns a List of Servers.
tags:
- Environments
x-cli-name: environments:servers-list
/environments/{environmentId}/servers/{serverId}:
get:
description: Return details about a specific server.
operationId: getEnvironmentsServer
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470
self:
href: https://cloud.acquia.com/api/environments/24-a47ac10b-58cc-4372-a567-0e02b2c3d470/servers/6
ami_type: c1.medium
configuration:
ecu: 5
memcache: 64
memory: 1.7
environment:
id: 24-a47ac10b-58cc-4372-a567-0e02b2c3d470
name: dev
flags:
active_bal: false
active_web: true
balancer: false
database: true
dedicated: false
elastic_ip: false
fs: false
memcache: true
primary_db: true
self_service: false
web: true
hostname: ded-6.servers.acquia.com
id: 6
ip: 10.0.0.1
name: ded-6
operating_system: xenial
region: us-west-1
roles:
- web
- db
ssh_user: user.dev
status: normal
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_server'
description: OK
'404':
content:
application/hal+json:
examples:
Cannot be viewed for CDEs:
value:
error: not_available
message: Servers cannot be viewed for CD environments.
Cannot be viewed for managed applications:
value:
error: not_available
message: Servers cannot be viewed for Service Management-enabled
applications.
Cannot be viewed on Node.js applications:
value:
error: not_available
message: Servers cannot be viewed on Node.js applications.
Not available on non-hosted applications:
value:
error: not_found
message: Servers are not available on non-hosted applications.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Return Details About a Specific Server.
tags:
- Environments
x-cli-name: environments:server-find
put:
description: Modifies configuration settings for a server.
operationId: putEnvironmentsServer
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-id'
requestBody:
content:
application/hal+json:
example:
memcache: 128
schema:
properties:
memcache:
default: 64
description: The size (in MB) of memcache on this server.
minimum: 0
type: integer
type: object
application/x-www-form-urlencoded:
example:
memcache: 128
schema:
properties:
memcache:
default: 64
description: The size (in MB) of memcache on this server.
minimum: 0
type: integer
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Server configuration being updated:
value:
message: The server configuration is being updated.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
No options set to update:
value:
error: validation_failed
message:
general: No configuration options were set to update. No action
performed.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Cannot be configured for free tier:
value:
error: forbidden
message: Configuration cannot be modified for this application.
Cannot be configured on Node.js applications:
value:
error: not_available
message: Server configuration cannot be modified on Node.js applications.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to configure this server.
Not available on non-hosted applications:
value:
error: not_found
message: Servers are not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Cannot be configured for CDEs:
value:
error: not_available
message: Servers cannot be configured for CD environments.
Cannot be configured for managed applications:
value:
error: not_available
message: Servers cannot be configured for Service Management-enabled
applications.
Not found:
value:
error: not_found
message: The application you are trying to access does not exist,
or you do not have permission to access it.
Server not found in application:
value:
error: not_found
message: The server with ID 42 does not exist in this application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Modifies Configuration Settings for a Server.
tags:
- Environments
x-cli-name: environments:server-update
/environments/{environmentId}/servers/{serverId}/actions/reboot:
post:
description: Reboots a server. This will cause all applications on this server
to be unavailable while the server reboots.
operationId: postEnvironmentsServerReboot
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-id'
responses:
'202':
content:
application/hal+json:
examples:
Server is being rebooted:
value:
message: The server is being rebooted.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
CDEs cannot be rebooted:
value:
error: validation_failed
message:
general: CD environments cannot be rebooted.
Only Acquia Cloud Professional can be rebooted:
value:
error: validation_failed
message:
general: Servers belonging to subscriptions that are not Acquia
Cloud Professional cannot be manually rebooted.
Only self-service can be rebooted:
value:
error: validation_failed
message:
general: Only self-service servers can be manually rebooted.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to reboot this server.
Not available on Node.js applications:
value:
error: not_available
message: Servers cannot be rebooted on Node.js applications.
Not available on managed applications:
value:
error: not_available
message: Servers cannot be rebooted for Service Management-enabled
applications.
Not available on non-hosted applications:
value:
error: not_found
message: Rebooting a server is not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Not available on CDEs:
value:
error: not_available
message: Servers cannot be rebooted for CD environments.
Server not found:
value:
error: not_found
message: The server you are trying to access does not exist, or
you do not have permission to access it.
Server not found in application:
value:
error: not_found
message: The server with ID 42 does not exist in this application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Reboots a Server.
tags:
- Environments
x-cli-name: environments:server-reboot
/environments/{environmentId}/servers/{serverId}/actions/relaunch:
post:
description: Relaunches a server. This will cause all applications on this server
to be unavailable while the server relaunches.
operationId: postEnvironmentsServerRelaunch
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-id'
responses:
'202':
content:
application/hal+json:
examples:
Server is being relaunched:
value:
message: The server is being relaunched.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
CDEs cannot be relaunched:
value:
error: validation_failed
message:
general: CD environments cannot be relaunched.
Only Acquia Cloud Professional can be relaunched:
value:
error: validation_failed
message:
general: Servers belonging to subscriptions that are not Acquia
Cloud Professional cannot be manually relaunched.
Only self-service can be relaunched:
value:
error: validation_failed
message:
general: Only self-service servers can be manually relaunched.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to relaunch this server.
Not available on Node.js applications:
value:
error: not_available
message: Servers cannot be relaunched on Node.js applications.
Not available on managed applications:
value:
error: not_available
message: Servers cannot be relaunched for Service Management-enabled
applications.
Not available on non-hosted applications:
value:
error: not_found
message: Relaunching servers is not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Not available on CDEs:
value:
error: not_available
message: Servers cannot be relaunched for CD environments.
Server not found:
value:
error: not_found
message: The server you are trying to access does not exist, or
you do not have permission to access it.
Server not found in application:
value:
error: not_found
message: The server with ID 42 does not exist in this application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Relaunches a Server.
tags:
- Environments
x-cli-name: environments:server-relaunch
/environments/{environmentId}/servers/{serverId}/actions/suspend:
post:
description: Suspends a server. The server will no longer respond to web requests.
operationId: postEnvironmentsServerSuspend
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-id'
responses:
'202':
content:
application/hal+json:
examples:
Server is being suspended:
value:
message: The server is being suspended.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
CDEs cannot be suspended:
value:
error: validation_failed
message:
general: CD environments cannot be suspended.
Only Acquia Cloud Professional can be suspended:
value:
error: validation_failed
message:
general: Servers belonging to subscriptions that are not Acquia
Cloud Professional cannot be manually suspended.
Only self-service can be suspended:
value:
error: validation_failed
message:
general: Only self-service servers can be manually suspended.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to suspend this server.
Not available on Node.js applications:
value:
error: not_available
message: Servers cannot be suspended on Node.js applications.
Not available on managed applications:
value:
error: not_available
message: Servers cannot be suspended for Service Management-enabled
applications.
Not available on non-hosted applications:
value:
error: not_found
message: Suspending servers is not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Not available on CDEs:
value:
error: not_available
message: Servers cannot be suspended for CD environments.
Server not found:
value:
error: not_found
message: The server you are trying to access does not exist, or
you do not have permission to access it.
Server not found in application:
value:
error: not_found
message: The server with ID 42 does not exist in this application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Suspends a Server.
tags:
- Environments
x-cli-name: environments:server-suspend
/environments/{environmentId}/servers/{serverId}/actions/upgrade:
post:
description: Upgrades a server from "precise" to "xenial".
operationId: postEnvironmentsServerUpgrade
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_server-id'
responses:
'202':
content:
application/hal+json:
examples:
Server is being upgraded:
value:
message: The server is being upgraded.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
CDEs cannot be upgraded:
value:
error: validation_failed
message:
general: CD environments cannot be upgraded.
Can only be upgraded from "precise":
value:
error: validation_failed
message:
general: Only servers running "precise" may be upgraded.
Only Acquia Cloud Professional can be upgraded:
value:
error: validation_failed
message:
general: Servers belonging to subscriptions that are not Acquia
Cloud Professional cannot be manually upgraded.
Only self-service can be upgraded:
value:
error: validation_failed
message:
general: Only self-service servers can be manually upgraded.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to upgrade this server.
Not available on Node.js applications:
value:
error: not_available
message: Servers cannot be upgraded on Node.js applications.
Not available on managed applications:
value:
error: not_available
message: Servers cannot be upgraded for Service Management-enabled
applications.
Not available on non-hosted applications:
value:
error: not_found
message: Upgrading servers is not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Not available on CDEs:
value:
error: not_available
message: Servers cannot be upgraded for CD environments.
Server not found:
value:
error: not_found
message: The server you are trying to access does not exist, or
you do not have permission to access it.
Server not found in application:
value:
error: not_found
message: The server with ID 42 does not exist in this application.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Upgrades a Server from "precise" to "xenial".
tags:
- Environments
x-cli-name: environments:server-upgrade
/environments/{environmentId}/settings:
get:
description: Provides links to environment settings.
operationId: getEnvironmentsSettings
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
apm:
href: https://cloud.acquia.com/api/environments/24-12345678-abcd-4372-a567-0e02b2c3a123/settings/apm
parent:
href: https://cloud.acquia.com/api/environments/24-12345678-abcd-4372-a567-0e02b2c3a123
self:
href: https://cloud.acquia.com/api/environments/24-12345678-abcd-4372-a567-0e02b2c3a123/settings
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-settings'
description: OK
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Provides Links to Environment Settings.
tags:
- Environments
x-cli-name: environments:settings
/environments/{environmentId}/ssl:
get:
description: Returns the SSL settings for this environment.
operationId: getSsl
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
certificates:
href: https://cloud.acquia.com/api/environments/3-110075c3-126e-6b43-c2ce-30be75fb33c2/ssl/certificates
csrs:
href: https://cloud.acquia.com/api/environments/3-110075c3-126e-6b43-c2ce-30be75fb33c2/ssl/csrs
parent:
href: https://cloud.acquia.com/api/environments/3-110075c3-126e-6b43-c2ce-30be75fb33c2
self:
href: https://cloud.acquia.com/api/environments/3-110075c3-126e-6b43-c2ce-30be75fb33c2/ssl
balancer:
hostname: example.us-east-1.elb.amazonaws.com
ips:
- 127.0.0.1
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_ssl'
description: OK
'403':
content:
application/hal+json:
examples:
Not available for free tier:
value:
error: not_found
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns the SSL Settings for This Environment.
tags:
- Environments
x-cli-name: environments:ssl-settings-find
/environments/{environmentId}/ssl/certificates:
get:
description: Returns the SSL certificates that are installed on this environment.
operationId: getCertificates
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
csr:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/csrs/7
self:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/certificates/7
ca: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
domains:
- example.com
- www.example.com
environment:
id: 5-a1a10dab-62f4-418c-bc58-ab7742078ba8
name: prod
expires_at: 2022-03-28T00:12:34-0400
flags:
active: true
csr: true
legacy: true
id: 7
label: null
private_key: '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE
KEY-----'
- _links:
self:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/certificates/3
ca: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
domains:
- example2.com
- www.example2.com
environment:
id: 5-a1a10dab-62f4-418c-bc58-ab7742078ba8
name: prod
expires_at: 2021-01-01T00:00:00-0400
flags:
active: true
csr: false
legacy: false
id: 3
label: Test Certificate 1
private_key: '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE
KEY-----'
- _links:
self:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/certificates/4
ca: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
domains:
- example3.com
- www.example3.com
environment:
id: 5-a1a10dab-62f4-418c-bc58-ab7742078ba8
name: prod
expires_at: 2021-01-01T00:00:00-0400
flags:
active: false
csr: true
legacy: false
id: 4
label: Test Certificate 2
private_key: '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE
KEY-----'
_links:
parent:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl
self:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/certificates
total: 3
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_certificates'
description: OK
'404':
content:
application/hal+json:
examples:
Non-hosted application:
value:
error: not_found
message: SSL Certificates are not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Return a List of SSL Certificates.
tags:
- Environments
x-cli-name: environments:certificate-list
post:
description: Install a new SSL certificate on this environment.
operationId: postCertificate
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
ca_certificates: '-----BEGIN CERTIFICATE-----123abc....-----END CERTIFICATE-----'
certificate: '-----BEGIN CERTIFICATE-----abc123....-----END CERTIFICATE-----'
csr_id: 123
label: My New Cert
legacy: false
private_key: '-----BEGIN RSA PRIVATE KEY-----secret....-----END RSA
PRIVATE KEY-----'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_post-certificate'
application/x-www-form-urlencoded:
example:
ca_certificates: '-----BEGIN CERTIFICATE-----123abc....-----END CERTIFICATE-----'
certificate: '-----BEGIN CERTIFICATE-----abc123....-----END CERTIFICATE-----'
csr_id: 123
label: My New Cert
legacy: false
private_key: '-----BEGIN RSA PRIVATE KEY-----secret....-----END RSA
PRIVATE KEY-----'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_post-certificate'
required: true
responses:
'202':
content:
application/hal+json:
examples:
Site is being imported:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/8fdacf25-38e4-4621-b5de-e78638fe2ceb
parent:
href: https://cloud.acquia.com/api/environments/123-4ba86d4a-e193-4282-8963-d9d24746f444/ssl
self:
href: https://cloud.acquia.com/api/environments/123-4ba86d4a-e193-4282-8963-d9d24746f444/ssl/certificates
message: Installing the certificate.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Cannot install:
value:
error: system
message: Unable to install a certificate on environment ID 5-9d46fd9d-e58b-47a3-8e9e-e8e0c2a854b4.
Site certificate CA chain certificates are out of order or contain
unused certificates.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to manage SSL certificates
on this environment.
Non-hosted application:
value:
error: forbidden
message: SSL certificates cannot be managed on non-hosted applications.
Not on Acquia Cloud Free:
value:
error: forbidden
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Invalid country code:
value:
error: validation_failed
message:
general: Invalid country code. Country codes should be alphabetic
and less than 2 characters long.
Invalid domain:
value:
error: validation_failed
message:
domain: The domain invalid does not appear to be a valid domain
name.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Install an SSL Certificate.
tags:
- Environments
x-cli-name: environments:certificate-create
/environments/{environmentId}/ssl/certificates/{certificateId}:
delete:
description: Deletes a specific certificate by its ID.
operationId: deleteCertificate
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_certificate-id'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/767cee8d-05f6-4761-a3dc-755957dfc9e6
parent:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/ssl/certificates
self:
href: https://cloud.acquia.com/api/environments/286-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/ssl/certificates/9
message: Deleting the certificate.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to delete SSL certificates
on this environment.
Non-hosted application:
value:
error: forbidden
message: SSL certificates are not available on non-hosted applications.
Not on Acquia Cloud Free:
value:
error: forbidden
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Incorrect certificate:
value:
error: not_found
message: This certificate does not belong to the environment,
and cannot be removed.
No environment or permission:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not on Acquia Cloud Free:
value:
error: validation_failed
message:
general: The currently active certificate cannot be removed.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deletes a Specific Certificate by its ID.
tags:
- Environments
x-cli-name: environments:certificate-delete
get:
description: Returns details about a specific SSL certificate.
operationId: getCertificate
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_certificate-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/5-9d46fd9d-e58b-47a3-8e9e-e8e0c2a854b4/ssl/certificates
self:
href: https://cloud.acquia.com/api/environments/5-9d46fd9d-e58b-47a3-8e9e-e8e0c2a854b4/ssl/certificates/13
ca: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
certificate: '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----'
domains:
- example.com
- www.example.com
environment:
id: 5-9d46fd9d-e58b-47a3-8e9e-e8e0c2a854b4
name: prod
expires_at: 2022-03-28T00:12:34-0400
flags:
active: true
csr: true
legacy: false
id: 13
label: Test Certificate
private_key: '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE
KEY-----'
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_certificate'
description: OK
'404':
content:
application/hal+json:
examples:
Non-hosted application:
value:
error: not_found
message: SSL certificates are not available on non-hosted applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns a Specific Certificate by Certificate Id.
tags:
- Environments
x-cli-name: environments:certificate-find
/environments/{environmentId}/ssl/certificates/{certificateId}/actions/activate:
post:
description: Activates an SSL certificate.
operationId: postActivateCertificate
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_certificate-id'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/4ee513c7-13b4-459f-af60-ba50c4f7cb5d
self:
href: https://cloud.acquia.com/api/environments/123-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/ssl/certificates/1/actions/activate
message: Activating the certificate.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Cannot be installed on CD environments:
value:
error: validation_failed
message:
general: Legacy certificates cannot be installed on CD environments.
Invalid private key:
value:
error: validation_failed
message:
private_key: The supplied private key is invalid.
Legacy cannot be installed using non-legacy:
value:
error: validation_failed
message:
csr_id: A legacy certificate cannot be installed using a non-legacy
certificate signing request.
Name already exists:
value:
error: validation_failed
message:
name: A certificate with that label already exists. Please choose
another label.
Non-legacy cannot be installed using legacy:
value:
error: validation_failed
message:
csr_id: A certificate cannot be installed using a legacy certificate
signing request.
Only installable on production:
value:
error: validation_failed
message:
general: Legacy certificates may only be installed on production
environments.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to activate SSL certificates
on this environment.
Non-hosted application:
value:
error: forbidden
message: SSL certificates cannot be activated on non-hosted applications.
Not on Acquia Cloud Free:
value:
error: forbidden
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Incorrect certificate:
value:
error: forbidden
message: This certificate does not belong to the environment,
and cannot be set to active.
Not found or no permission:
value:
error: forbidden
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Already active:
value:
error: validation_failed
message:
general: This certificate is already set as active.
Legacy certificate:
value:
error: validation_failed
message:
general: Legacy certificates cannot be set to active.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Activates an SSL Certificate.
tags:
- Environments
x-cli-name: environments:certificate-activate
/environments/{environmentId}/ssl/certificates/{certificateId}/actions/deactivate:
post:
description: Deactivates an active SSL certificate.
operationId: postDeactivateCertificate
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_certificate-id'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/cb5de18e-5721-4c26-9f67-1a7d806dd09e
self:
href: https://cloud.acquia.com/api/environments/123-a027502b-ad6c-a48e-a7e8-aa0def7d25e1/ssl/certificates/4547/actions/deactivate
message: Deactivating the certificate.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Legacy certificate:
value:
error: validation_failed
message:
general: Legacy certificates cannot be deactivated. In order
to deactivate a legacy certificate, the certificate must be
removed.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to deactivate SSL certificates
on this environment.
Non-hosted application:
value:
error: forbidden
message: SSL certificates cannot be deactivated on non-hosted
applications.
Not on Acquia Cloud Free:
value:
error: forbidden
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Incorrect certificate:
value:
error: forbidden
message: This certificate does not belong to the environment,
and cannot be deactivated.
Not found or no permission:
value:
error: forbidden
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Already active:
value:
error: validation_failed
message: This certificate is already deactivated.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deactivates an Active SSL Certificate.
tags:
- Environments
x-cli-name: environments:certificate-deactivate
/environments/{environmentId}/ssl/csrs:
get:
description: Returns the certificate signing requests for this environment.
operationId: getCertificateSigningRequests
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
certificate:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/certificates/7
self:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/csrs/7
alternate_names:
- site.example.com
- other.example.com
common_name: www.example.com
country: US
csr: '-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE
REQUEST-----'
environment:
id: 5-a1a10dab-62f4-418c-bc58-ab7742078ba8
name: prod
flags:
legacy: false
used: true
id: 7
locality: Boston
organization: Example Inc.
organizational_unit: IT
private_key: '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE
KEY-----'
state: Massachusetts
- _links:
certificate:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/certificates/8
self:
href: https://cloud.acquia.com/api/environments/5-a1a10dab-62f4-418c-bc58-ab7742078ba8/ssl/csrs/8
alternate_names: []
common_name: www.example.com
country: US
csr: '-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE
REQUEST-----'
environment:
id: 5-a1a10dab-62f4-418c-bc58-ab7742078ba8
name: prod
flags:
legacy: true
used: false
id: 8
locality: Boston
organization: Example Inc.
organizational_unit: IT
private_key: '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE
KEY-----'
state: Massachusetts
_links:
parent:
href: https://cloud.acquia.com/api/environments/5-185f07c7-9c4f-407b-8968-67892ebcb38a/ssl
self:
href: https://cloud.acquia.com/api/environments/5-185f07c7-9c4f-407b-8968-67892ebcb38a/ssl/csrs
total: 2
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_csrs'
description: OK
'404':
content:
application/hal+json:
examples:
Non-hosted application:
value:
error: not_found
message: Certificate Signing Requests are not available on non-hosted
applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns Certificate Signing Requests.
tags:
- Environments
x-cli-name: environments:csr-list
post:
description: Generates a CSR for one or more domains.
operationId: postCertificateSigningRequest
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
alternate_names:
- www2.example.com
- www3.example.com
common_name: www.example.com
country: CA
locality: Toronto
organization: Acquia
organizational_unit: Networking
state: Ontario
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_post-csr'
application/x-www-form-urlencoded:
example:
alternate_names:
- www2.example.com
- www3.example.com
common_name: www.example.com
country: CA
locality: Toronto
organization: Acquia
organizational_unit: Networking
state: Ontario
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_post-csr'
required: true
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/8fdacf25-38e4-4621-b5de-e78638fe2ceb
parent:
href: https://cloud.acquia.com/api/environments/123-4ba86d4a-e193-4282-8963-d9d24746f444/ssl
self:
href: https://cloud.acquia.com/api/environments/123-4ba86d4a-e193-4282-8963-d9d24746f444/ssl/csrs
message: A CSR is being generated for the selected domain.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to manage SSL certificates
on this environment.
Non-hosted application:
value:
error: forbidden
message: SSL certificates cannot be managed on non-hosted applications.
Not on Acquia Cloud Free:
value:
error: forbidden
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Incorrect certificate:
value:
error: forbidden
message: This certificate signing request does not belong to the
environment, and cannot be used to install a certificate.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
CD environments:
value:
error: validation_failed
message:
general: Legacy certificates may not be installed on CD environments.
Certificate expired:
value:
error: validation_failed
message:
certificate: The supplied certificate has expired.
Certificate unavailable:
value:
error: validation_failed
message:
certificate: Certificate CERTIFICATE was issued by UNKNOWN ISSUER
for which no certificate is available.
Duplicate label:
value:
error: validation_failed
message:
label: A certificate with that label already exists. Please
choose another label.
Intermediate certificate expired:
value:
error: validation_failed
message:
ca_certificates: Intermediate certificate Example Certificate
has expired.
Invalid format:
value:
error: validation_failed
message:
certificate: The certificate format is invalid.
Invalid private key:
value:
error: validation_failed
message:
private_key: The supplied private key is invalid.
Invalid public key:
value:
error: validation_failed
message:
certificate: The certificate public key is invalid.
Legacy CSR:
value:
error: validation_failed
message:
csr_id: A certificate cannot be installed using a legacy certificate
signing request.
Legacy certificate:
value:
error: validation_failed
message:
general: Legacy certificates may only be installed on production
environments.
Legacy mismatch:
value:
error: validation_failed
message:
csr_id: A legacy certificate cannot be installed using a non-legacy
certificate signing request.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Conflict
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Generates a Certificate Signing Request (CSR) for One or More
Domains.
tags:
- Environments
x-cli-name: environments:csr-create
/environments/{environmentId}/ssl/csrs/{certificateId}:
delete:
description: Deletes the certificate signing request for the certificate specified
by id.
operationId: deleteCertificateSigningRequest
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_certificate-id'
responses:
'202':
content:
application/hal+json:
example:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/87c0f979-2f84-4b88-bc5e-8c1670fd2f01
parent:
href: https://cloud.acquia.com/api/environments/5-aeb8e8a6-0eef-4a1e-8d8d-545e025b12a5/ssl/csrs
self:
href: https://cloud.acquia.com/api/environments/5-aeb8e8a6-0eef-4a1e-8d8d-545e025b12a5/ssl/csrs/7
message: Deleting the certificate signing request.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message'
description: Accepted
'400':
content:
application/hal+json:
examples:
Not on Acquia Cloud Free:
value:
error: validation_failed
message:
general: This certificate signing request is used for a certificate,
and cannot be removed.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to delete Certificate Signing
Requests on this environment.
Not on Acquia Cloud Free:
value:
error: forbidden
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Incorrect certificate signing request:
value:
error: not_found
message: This certificate signing request does not belong to the
environment, and cannot be removed.
No environment or permission:
value:
error: not_found
message: The environment you are trying to administer does not
exist, or you do not have permission to administer it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Deletes the Certificate Signing Request.
tags:
- Environments
x-cli-name: environments:csr-delete
get:
description: Returns details about a specific certificate signing request.
operationId: getCertificateSigningRequest
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_certificate-id'
responses:
'200':
content:
application/hal+json:
example:
_links:
certificate:
href: https://cloud.acquia.com/api/environments/5-aeb8e8a6-0eef-4a1e-8d8d-545e025b12a5/ssl/certificates/7
parent:
href: https://cloud.acquia.com/api/environments/5-aeb8e8a6-0eef-4a1e-8d8d-545e025b12a5/ssl/csrs
self:
href: https://cloud.acquia.com/api/environments/5-aeb8e8a6-0eef-4a1e-8d8d-545e025b12a5/ssl/csrs/7
alternate_names:
- site.example.com
- other.example.com
common_name: www.example.com
country: US
csr: '-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----'
environment:
id: 5-aeb8e8a6-0eef-4a1e-8d8d-545e025b12a5
name: prod
flags:
legacy: false
used: true
id: 7
locality: Boston
organization: Example Inc.
organizational_unit: IT
private_key: '-----BEGIN RSA PRIVATE KEY-----...-----END RSA PRIVATE
KEY-----'
state: Massachusetts
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_csr'
description: OK
'403':
content:
application/hal+json:
examples:
No permission:
value:
error: forbidden
message: You do not have permission to view Certificate Signing
Requests on this environment.
Not on Acquia Cloud Free:
value:
error: forbidden
message: SSL certificates are not available to Acquia Cloud Free
subscriptions.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
No CSR or permission:
value:
error: not_found
message: The CSR you are trying to access does not exist, or you
do not have permission to access it.
No environment or permission:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Non-hosted application:
value:
error: not_found
message: Certificate Signing Requests are not available on non-hosted
applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
security:
- Acquia_Cloud_API_Documentation_OAuth2: []
summary: Acquia Returns the Certificate Signing Request for the Certificate
Specified by Id.
tags:
- Environments
x-cli-name: environments:csr-find
/environments/{environmentId}/variables:
get:
description: 'Returns a list of environment variables associated with this environment.
Filterable fields:
* `name`
Sortable fields:
* `name`
'
operationId: getEnvironmentsVariables
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_sort'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_filter'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_limit'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_offset'
responses:
'200':
content:
application/hal+json:
example:
_embedded:
items:
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93/variables/variable_one
name: variable_one
value: Sample Value One
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93/variables/variable_two
name: variable_two
value: Sample Value Two
- _links:
self:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93/variables/variable_three
name: variable_three
value: Sample Value Three
_links:
filter:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93/variables{?filter}
templated: true
limit:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93/variables{?limit}
templated: true
parent:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93
self:
href: https://cloud.acquia.com/api/environment/24-569086da-2b1f-11e9-b210-d663bd873d93/variables
sort:
href: https://cloud.acquia.com/api/environments/24-569086da-2b1f-11e9-b210-d663bd873d93/variables{?sort}
templated: true
total: 3
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-variables'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to view environment variables
for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not available for static applications:
value:
error: not_available
message: Environment variables are not available for static applications.
Not available on Acquia Cloud Site Factory:
value:
error: not_available
message: Environment variables are not available for Acquia Cloud
Site Factory applications.
Not available on managed applications:
value:
error: not_available
message: Environment variables are not available for Service Management-enabled
applications.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Returns a List of Environment Variables Associated with This
Environment.
tags:
- Environments
x-cli-name: environments:variable-list
post:
description: Adds a new environment variable to an environment.
operationId: postEnvironmentsVariables
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
requestBody:
content:
application/hal+json:
example:
name: APP_KEY
value: aaaabbbbccccddddeee
schema:
properties:
name:
description: The name of the environment variable to add.
maxLength: 255
minLength: 1
pattern: ^(?!(ACQUIA_|AH_))[A-Za-z_][A-Za-z0-9_]*$
type: string
value:
description: The value of the environment variable to add.
maxLength: 255
minLength: 0
type: string
type: object
application/x-www-form-urlencoded:
example:
name: APP_KEY
value: aaaabbbbccccddddeee
schema:
properties:
name:
description: The name of the environment variable to add.
maxLength: 255
minLength: 1
pattern: ^(?!(ACQUIA_|AH_))[A-Za-z_][A-Za-z0-9_]*$
type: string
value:
description: The value of the environment variable to add.
maxLength: 255
minLength: 0
type: string
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Variable is being added:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/f3c2bdc1-60c1-48af-8777-996477f901d5
parent:
href: https://cloud.acquia.com/api/environments/123-c7056b9e-0fb7-44e9-a434-426a404211c1
self:
href: https://cloud.acquia.com/api/environments/123-c7056b9e-0fb7-44e9-a434-426a404211c1/variables
message: The environment variable is being added.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Invalid value:
value:
error: not_available
message:
value: 'The environment variable value is invalid: it must be
less than 256 characters long.'
Invalid variable name:
value:
error: validation_failed
message:
name: The environment variable name is invalid. It must contain
only letters, numbers, and underscores; it cannot start with
a number, AH_, or ACQUIA_; and it must be under 256 characters
long.
Variable name already exists:
value:
error: not_available
message:
name: The environment already has an environment variable with
that name.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to create environment variables
for this environment.
Not available on managed applications:
value:
error: not_available
message: Environment variables are not available for Service Management-enabled
applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Not available for static applications:
value:
error: not_available
message: Environment variables are not available for static applications.
Not available on Acquia Cloud Site Factory:
value:
error: not_available
message: Environment variables are not available for Acquia Cloud
Site Factory applications.
Not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not available:
value:
error: conflict
message: Environment variables are not available for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Adds a New Environment Variable to an Environment.
tags:
- Environments
x-cli-name: environments:variable-create
/environments/{environmentId}/variables/{environmentVariableName}:
delete:
description: Removes an environment variable from an environment.
operationId: deleteEnvironmentsVariable
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-variable-name'
responses:
'202':
content:
application/hal+json:
examples:
Variable is being removed:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/42b56cff-0b55-4bdf-a949-1fd0fca61c6c
parent:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/variables
self:
href: https://cloud.acquia.com/api/environments/12-d314739e-296f-11e9-b210-d663bd873d93/variables/EXAMPLE_VARIABLE_NAME
message: The environment variable is being removed.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Invalid value:
value:
error: validation_failed
message:
name: The environment does not have an environment variable
with that name.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Environment variable not found:
value:
error: not_found
message: The environment variable you are trying to access does
not exist, or you do not have permission to access it.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to remove environment variables
for this environment.
Not available on managed applications:
value:
error: not_available
message: Environment variables are not available for Service Management-enabled
applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not available:
value:
error: conflict
message: Environment variables are not available for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Removes an Environment Variable from an Environment.
tags:
- Environments
x-cli-name: environments:variable-delete
get:
description: Get an environment variable associated with this environment.
operationId: getEnvironmentsVariable
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-variable-name'
responses:
'200':
content:
application/hal+json:
example:
_links:
parent:
href: https://cloud.acquia.com/api/environments/24-734b7960-2b1f-11e9-b210-d663bd873d93/variables
self:
href: https://cloud.acquia.com/api/environments/24-734b7960-2b1f-11e9-b210-d663bd873d93/variables/variable_one
name: variable_one
value: Sample Value One
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_environment-variable'
description: OK
'403':
content:
application/hal+json:
examples:
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to view environment variables
for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
Environment variable not found:
value:
error: not_found
message: The environment variable you are trying to access does
not exist, or you do not have permission to access it.
Not available on Acquia Cloud Site Factory:
value:
error: not_available
message: Environment variables are not available for Acquia Cloud
Site Factory applications.
Not available on managed applications:
value:
error: not_available
message: Environment variables are not available for Service Management-enabled
applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
summary: Acquia Get an Environment Variable Associated with This Environment.
tags:
- Environments
x-cli-name: environments:variable-find
put:
description: Updates an environment variable on an environment.
operationId: putEnvironmentsVariable
parameters:
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-id'
- $ref: '#/components/parameters/Acquia_Cloud_API_Documentation_environment-variable-name'
requestBody:
content:
application/hal+json:
example:
name: APP_KEY
value: aaaabbbbccccddddeee
schema:
properties:
name:
description: The name of the environment variable to add.
maxLength: 255
minLength: 1
pattern: ^(?!(ACQUIA_|AH_))[A-Za-z_][A-Za-z0-9_]*$
type: string
value:
description: The value of the environment variable to add.
maxLength: 255
minLength: 0
type: string
required:
- name
- value
type: object
application/x-www-form-urlencoded:
example:
name: APP_KEY
value: aaaabbbbccccddddeee
schema:
properties:
name:
description: The name of the environment variable to add.
maxLength: 255
minLength: 1
pattern: ^(?!(ACQUIA_|AH_))[A-Za-z_][A-Za-z0-9_]*$
type: string
value:
description: The value of the environment variable to add.
maxLength: 255
minLength: 0
type: string
required:
- name
- value
type: object
required: true
responses:
'202':
content:
application/hal+json:
examples:
Variable is being updated:
value:
_links:
notification:
href: https://cloud.acquia.com/api/notifications/37c8646c-bbe8-423a-970b-cbeb530b981d
parent:
href: https://cloud.acquia.com/api/environments/24-734b7960-2b1f-11e9-b210-d663bd873d93/variables
self:
href: https://cloud.acquia.com/api/environments/24-734b7960-2b1f-11e9-b210-d663bd873d93/variables/name
message: The environment variable is being updated.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_message-with-links'
description: Accepted
'400':
content:
application/hal+json:
examples:
Invalid value:
value:
error: validation_failed
message:
value: 'The environment variable value is invalid: it must be
less than 5000 characters long.'
Variable name already exists:
value:
error: validation_failed
message:
name: The environment already has an environment variable with
that name.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_validation-error'
description: Bad Request
'403':
content:
application/hal+json:
examples:
Environment variable not found:
value:
error: not_found
message: The environment variable you are trying to access does
not exist, or you do not have permission to access it.
Insufficient permissions:
value:
error: forbidden
message: You do not have permission to modify environment variables
for this environment.
Not available on managed applications:
value:
error: not_available
message: Environment variables are not available for Service Management-enabled
applications.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Forbidden
'404':
content:
application/hal+json:
examples:
Environment not found:
value:
error: not_found
message: The environment you are trying to access does not exist,
or you do not have permission to access it.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Not Found
'409':
content:
application/hal+json:
examples:
Not available:
value:
error: conflict
message: Environment variables are not available for this environment.
schema:
$ref: '#/components/schemas/Acquia_Cloud_API_Documentation_error'
description: Conflict
summary: Acquia Updates an Environment Variable on an Environment.
tags:
- Environments
x-cli-name: environments:variable-update
servers: []
tags:
- name: Environments