Get costs for cost report or VQL filter
Return all Costs for a CostReport or VQL filter.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
The CostReport token.
The VQL filter to apply to the costs. If this is supplied you do not need cost_report_token.
The token of the Workspace to query costs from. Ignored if 'cost_report_token' is set. Required if the API token is associated with multiple Workspaces.
First date you would like to filter costs from. ISO 8601 formatted.
Last date you would like to filter costs to. ISO 8601 formatted.
Group the results by specific field(s). Defaults to provider, service, account_id. Valid groupings: account_id, billing_account_id, charge_type, cost_category, cost_subcategory, provider, region, resource_id, service, tagged, usage_unit, tag:<tag_value>. If providing multiple groupings, join as comma separated values: groupings=provider,service,region
Whether to order costs by date in an ascending or descending manner.
asc, desc The amount of results to return. The maximum is 5000.
The page of results to return.
The date bin of the costs. Defaults to the report's default or day.
day, week, month, quarter, hour Results will include credits.
Results will include refunds.
Results will include discounts.
Results will include tax.
Results will amortize.
Results will show unallocated costs.
Results will aggregate by cost, usage, or count.
cost, usage, count Results will show previous period cost, usage, or count comparison.
Response
Costs model
The sum of all usage for the CostReport for the requested period, rounded to 2 decimal places, grouped by usage unit.
The sum of the date-binned counts. Present when settings.aggregate_by is 'count'.
Distinct Group By permutation counts for the full requested period, unaffected by page and limit. Bins without cost are omitted. Present when settings.aggregate_by is 'count'.