api:environments:usage-data
Retrieves usage data for an environment.
For more help, see https://cloudapi-docs.acquia.com/ or https://dev.acquia.com/api-documentation/acquia-cloud-site-factory-api for acsf commands.
Usage
acli api:environments:usage-data [--from FROM] [--to TO] [--filter FILTER] [--resolution RESOLUTION] [--] <environmentId>
acli api:environments:usage-data 12-d314739e-296f-11e9-b210-d663bd873d93 --from="-7d" --to="-1d"
acli api:environments:usage-data myapp.dev --from="-7d" --to="-1d"
Arguments
environmentId
Required
The environment identifier. The identifier is a compound key consisting of the internal database ID of the environment and the application UUID. You may also use an environment alias or UUID.
Options
--from
Required
Specifies relative or absolute time period to retrieve results from. (Default value -7d)
--to
Required
Optionally specifies relative or absolute time period to retrieve results until.
--filter
Required
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`)
--resolution
Required
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
--help | -h
Optional
Display help for the given command. When no command is given display help for the `list` command
Defaults to
false--quiet | -q
Optional
Do not output any message
Defaults to
false--verbose | -v|-vv|-vvv
Optional
Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Defaults to
false--version | -V
Optional
Display this application version
Defaults to
false--ansi
Optional
Force (or disable --no-ansi) ANSI output
--no-ansi
Optional
Negate the "--ansi" option
Defaults to
false--no-interaction | -n
Optional
Do not ask any interactive question
Defaults to
false