AWS Cost Explorer Service

2024/03/26 - AWS Cost Explorer Service - 2 new api methods

Changes  Adds support for backfill of cost allocation tags, with new StartCostAllocationTagBackfill and ListCostAllocationTagBackfillHistory API.

ListCostAllocationTagBackfillHistory (new) Link ¶

Retrieves a list of your historical cost allocation tag backfill requests.

See also: AWS API Documentation

Request Syntax

client.list_cost_allocation_tag_backfill_history(
    NextToken='string',
    MaxResults=123
)
type NextToken:

string

param NextToken:

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

type MaxResults:

integer

param MaxResults:

The maximum number of objects that are returned for this request.

rtype:

dict

returns:

Response Syntax

{
    'BackfillRequests': [
        {
            'BackfillFrom': 'string',
            'RequestedAt': 'string',
            'CompletedAt': 'string',
            'BackfillStatus': 'SUCCEEDED'|'PROCESSING'|'FAILED',
            'LastUpdatedAt': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • BackfillRequests (list) --

      The list of historical cost allocation tag backfill requests.

      • (dict) --

        The cost allocation tag backfill request structure that contains metadata and details of a certain backfill.

        • BackfillFrom (string) --

          The date the backfill starts from.

        • RequestedAt (string) --

          The time when the backfill was requested.

        • CompletedAt (string) --

          The backfill completion time.

        • BackfillStatus (string) --

          The status of the cost allocation tag backfill request.

        • LastUpdatedAt (string) --

          The time when the backfill status was last updated.

    • NextToken (string) --

      The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

StartCostAllocationTagBackfill (new) Link ¶

Request a cost allocation tag backfill. This will backfill the activation status (either active or inactive) for all tag keys from para:BackfillFrom up to the when this request is made.

You can request a backfill once every 24 hours.

See also: AWS API Documentation

Request Syntax

client.start_cost_allocation_tag_backfill(
    BackfillFrom='string'
)
type BackfillFrom:

string

param BackfillFrom:

[REQUIRED]

The date you want the backfill to start from. The date can only be a first day of the month (a billing start date). Dates can't precede the previous twelve months, or in the future.

rtype:

dict

returns:

Response Syntax

{
    'BackfillRequest': {
        'BackfillFrom': 'string',
        'RequestedAt': 'string',
        'CompletedAt': 'string',
        'BackfillStatus': 'SUCCEEDED'|'PROCESSING'|'FAILED',
        'LastUpdatedAt': 'string'
    }
}

Response Structure

  • (dict) --

    • BackfillRequest (dict) --

      An object containing detailed metadata of your new backfill request.

      • BackfillFrom (string) --

        The date the backfill starts from.

      • RequestedAt (string) --

        The time when the backfill was requested.

      • CompletedAt (string) --

        The backfill completion time.

      • BackfillStatus (string) --

        The status of the cost allocation tag backfill request.

      • LastUpdatedAt (string) --

        The time when the backfill status was last updated.