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

*****************************
get_approximate_usage_records
*****************************



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

  

  Retrieves estimated usage records for hourly granularity or resource-level data at daily granularity.

  

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


  **Request Syntax**
  ::

    response = client.get_approximate_usage_records(
        Granularity='DAILY'|'MONTHLY'|'HOURLY',
        Services=[
            'string',
        ],
        ApproximationDimension='SERVICE'|'RESOURCE'
    )
    
  :type Granularity: string
  :param Granularity: **[REQUIRED]** 

    How granular you want the data to be. You can enable data at hourly or daily granularity.

    

  
  :type Services: list
  :param Services: 

    The service metadata for the service or services you want to query. If not specified, all elements are returned.

    

  
    - *(string) --* 

    

  :type ApproximationDimension: string
  :param ApproximationDimension: **[REQUIRED]** 

    The service to evaluate for the usage records. You can choose resource-level data at daily granularity, or hourly granularity with or without resource-level data.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'Services': {
              'string': 123
          },
          'TotalRecords': 123,
          'LookbackPeriod': {
              'Start': 'string',
              'End': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Services** *(dict) --* 

        The service metadata for the service or services in the response.

        
        

        - *(string) --* 
          

          - *(integer) --* 
    
  
      

      - **TotalRecords** *(integer) --* 

        The total number of usage records for all services in the services list.

        
      

      - **LookbackPeriod** *(dict) --* 

        The lookback period that's used for the estimation.

        
        

        - **Start** *(string) --* 

          The beginning of the time period. The start date is inclusive. For example, if ``start`` is ``2017-01-01``, Amazon Web Services retrieves cost and usage data starting at ``2017-01-01`` up to the end date. The start date must be equal to or no later than the current date to avoid a validation error.

          
        

        - **End** *(string) --* 

          The end of the time period. The end date is exclusive. For example, if ``end`` is ``2017-05-01``, Amazon Web Services retrieves cost and usage data from the start date up to, but not including, ``2017-05-01``.

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

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

  