AWS Cost Explorer Service

Retrieves estimated usage records for hourly granularity or resource-level data at daily granularity.

See also: AWS API Documentation

Request Syntax

client.get_approximate_usage_records(
    Granularity='DAILY'|'MONTHLY'|'HOURLY',
    Services=[
        'string',
    ],
    ApproximationDimension='SERVICE'|'RESOURCE'
)

type Granularity:

string

param Granularity:

[REQUIRED]

How granular you want the data to be. You can enable data at hourly or daily granularity.

type Services:

list

param Services:

The service metadata for the service or services you want to query. If not specified, all elements are returned.

• (string) --

type ApproximationDimension:

string

param ApproximationDimension:

[REQUIRED]

The service to evaluate for the usage records. You can choose resource-level data at daily granularity, or hourly granularity with or without resource-level data.

rtype:

dict

returns:

Response Syntax

{
    'Services': {
        'string': 123
    },
    'TotalRecords': 123,
    'LookbackPeriod': {
        'Start': 'string',
        'End': 'string'
    }
}

Response Structure

• (dict) --

  • Services (dict) --

    The service metadata for the service or services in the response.

    • (string) --

      • (integer) --

  • TotalRecords (integer) --

    The total number of usage records for all services in the services list.

  • LookbackPeriod (dict) --

    The lookback period that's used for the estimation.

    • Start (string) --

      The beginning of the time period. The start date is inclusive. For example, if start is 2017-01-01, Amazon Web Services retrieves cost and usage data starting at 2017-01-01 up to the end date. The start date must be equal to or no later than the current date to avoid a validation error.

    • End (string) --

      The end of the time period. The end date is exclusive. For example, if end is 2017-05-01, Amazon Web Services retrieves cost and usage data from the start date up to, but not including, 2017-05-01.