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 time 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.
- BackfillFrom
-
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.
- BackfillRequest
-
An object containing detailed metadata of your new backfill request.
Type: CostAllocationTagBackfillRequest object
Errors
For information about the errors that are common to all actions, see Common Errors.
- BackfillLimitExceededException
-
A request to backfill is already in progress. Once the previous request is complete, you can create another request.
HTTP Status Code: 400
- LimitExceededException
-
You made too many calls in a short period of time. Try again later.
HTTP Status Code: 400
Examples
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:
