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.