Billing / Paginator / GetCreditAllocationHistory

GetCreditAllocationHistory

class Billing.Paginator.GetCreditAllocationHistory

paginator = client.get_paginator('get_credit_allocation_history')

paginate(**kwargs)

Creates an iterator that will paginate through responses from Billing.Client.get_credit_allocation_history().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    accountId='string',
    creditId=123,
    startDate=datetime(2015, 1, 1),
    endDate=datetime(2015, 1, 1),
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• accountId (string) –

  [REQUIRED]

  The Amazon Web Services account ID whose allocation history to retrieve. Must be a 12-digit numeric string.

• creditId (integer) – Filters the result to a single credit. When omitted, returns allocation entries for all credits.

• startDate (datetime) –

  [REQUIRED]

  Inclusive start date as Unix epoch seconds. Must be on or before endDate. The range from startDate to endDate cannot exceed 24 billing months.

• endDate (datetime) –

  [REQUIRED]

  Inclusive end date as Unix epoch seconds.

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'creditAllocationHistoryList': [
        {
            'creditId': 'string',
            'creditAmount': {
                'currencyCode': 'string',
                'currencyAmount': 'string'
            },
            'description': 'string',
            'accountId': 'string',
            'appliedServiceName': 'string',
            'billingMonth': 'string',
            'isEstimatedBill': True|False
        },
    ],
    'partialResults': True|False,
    'failedMonths': [
        'string',
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • creditAllocationHistoryList (list) –

    Allocation entries sorted by billingMonth in descending order.

    • (dict) –

      A single entry in the credit allocation history, representing how a credit was applied to a specific service during a billing month.

      • creditId (string) –

        The identifier of the credit that was applied.

      • creditAmount (dict) –

        The amount of credit applied. Negative values represent credits that reduced the bill.

        • currencyCode (string) –

          The ISO 4217 currency code for the amount (for example, USD).

        • currencyAmount (string) –

          The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.

      • description (string) –

        A human-readable description of the credit allocation.

      • accountId (string) –

        The Amazon Web Services account the credit was applied to.

      • appliedServiceName (string) –

        The Amazon Web Services service the credit was applied to.

      • billingMonth (string) –

        The billing month of the application in YYYY-MM format.

      • isEstimatedBill (boolean) –

        true when the entry was applied to an in-flight bill that has not yet been finalized.

  • partialResults (boolean) –

    true when data could not be retrieved for one or more billing months. The failedMonths field lists which months are missing.

  • failedMonths (list) –

    Billing months in YYYY-MM format that failed to return data. Non-empty only when partialResults is true.

    • (string) –

  • NextToken (string) –

    A token to resume pagination.