StartCostAllocationTagBackfill - AWS Billing and Cost Management


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.

Request Syntax

{ "BackfillFrom": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


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.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 25.

Pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(([+-]\d\d:\d\d)|Z)$

Required: Yes

Response Syntax

{ "BackfillRequest": { "BackfillFrom": "string", "BackfillStatus": "string", "CompletedAt": "string", "LastUpdatedAt": "string", "RequestedAt": "string" } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


An object containing detailed metadata of your new backfill request.

Type: CostAllocationTagBackfillRequest object


For information about the errors that are common to all actions, see Common Errors.


A request to backfill is already in progress. Once the previous request is complete, you can create another request.

HTTP Status Code: 400


You made too many calls in a short period of time. Try again later.

HTTP Status Code: 400


The following are sample requests and responses of the StartCostAllocationTagBackfill operations.

Example 1: Successfully request a cost allocation tag backfill

This example illustrates one usage of StartCostAllocationTagBackfill.

Sample Request

{ "BackfillFrom": "2024-02-01T00:00:00Z" }

Sample Response

{ "BackfillRequest": { "BackfillFrom":"2024-02-01T00:00:00Z", "BackfillStatus":"PROCESSING", "RequestedAt":"2024-03-01T09:16:23Z", "LastUpdatedAt":"2024-03-01T09:16:23Z" } }

Example 2: The backfill is skipped because there is no tag status change since the last backfill

The latest successful backfill request is returned instead.

Sample Request

{ "BackfillFrom": "2024-02-01T00:00:00Z" }

Sample Response

{ "BackfillRequest": { "BackfillFrom":"2024-02-01T00:00:00Z", "BackfillStatus":"SUCCEEDED", "RequestedAt":"2024-03-01T09:16:23Z", "LastUpdatedAt":"2024-03-02T06:45:00Z", "CompletedAt":"2024-03-02T06:45:00Z" } }

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: