:doc:`CostExplorer <../../ce>` / Client / start_cost_allocation_tag_backfill

**********************************
start_cost_allocation_tag_backfill
**********************************



.. py:method:: CostExplorer.Client.start_cost_allocation_tag_backfill(**kwargs)

  

  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.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/StartCostAllocationTagBackfill>`_  


  **Request Syntax**
  ::

    response = 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.

          
    
  
  **Exceptions**
  
  *   :py:class:`CostExplorer.Client.exceptions.LimitExceededException`

  
  *   :py:class:`CostExplorer.Client.exceptions.BackfillLimitExceededException`

  