Usage v2

List Usage by Host

Lists aggregated usage information for all hosts during a time period.

get/v2/usage/hosts

Query parameters

fromstring required

Start time. A date-time string as defined by the ISO 8601 date format. This date-time will be used to calculate the starting day; the exact time will not be used.

tostring required

End time. A date-time string as defined by the ISO 8601 date format. This date-time will be used to calculate the ending day; the exact time will not be used.

limitinteger

Maximum amount of hosts to retrieve.

retentionstring

Limit report to hosts that contribute to a variable retention pool. Value must be a string indicating the retention pool duration, e.g. 7d for a seven day retention pool.

Response

OK

fromstring

The calculated starting time (exclusive) used internally.

tostring

The calculated ending time (exclusive) used internally.

Changes

No recorded changes to this endpoint across all 1 revision of this API.