Billing / Client / list_business_support_account_charges

list_business_support_account_charges

Billing.Client.list_business_support_account_charges(**kwargs)

Returns Business Support charges broken down at the linked account level for a given billing month.

See also: AWS API Documentation

Request Syntax

response = client.list_business_support_account_charges(
    billingMonth='string',
    accountId='string',
    maxResults=123,
    nextToken='string'
)

Parameters:

• billingMonth (string) –

  [REQUIRED]

  The billing month to retrieve Business Support charges for, in YYYY-MM format. You can request the current month (charges will be estimated) or a past month (charges will be finalized).

• accountId (string) – The linked account ID to filter results to a specific account. If you don’t specify a value, the response includes charges for all linked accounts.

• maxResults (integer) – The maximum number of results to return per page. Default is 100.

• nextToken (string) – The pagination token for the next page of results.

Return type:

dict

Returns:

Response Syntax

{
    'billingMonth': 'string',
    'isEstimated': True|False,
    'totalSupportCharge': 'string',
    'totalSupportEligibleSpend': 'string',
    'accountCount': 123,
    'accountCharges': [
        {
            'accountId': 'string',
            'supportPlanName': 'string',
            'totalCharge': 'string',
            'totalUsageBasis': 'string',
            'tierCharges': [
                {
                    'tierDescription': 'string',
                    'tierRate': 'string',
                    'usageSlice': 'string',
                    'tierCharge': 'string',
                    'chargePeriodStartDate': datetime(2015, 1, 1),
                    'chargePeriodEndDate': datetime(2015, 1, 1)
                },
            ],
            'supportDiscount': {
                'discountAmount': 'string',
                'discountPercentage': 'string',
                'discountType': 'string',
                'discountSource': 'string'
            },
            'supportEligibleSpendByService': [
                {
                    'contributingService': 'string',
                    'itemType': 'string',
                    'description': 'string',
                    'chargeAmount': 'string',
                    'currency': 'string'
                },
            ]
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) –

  Contains the Business Support charges broken down by linked account for the specified billing month, along with account and spend totals.

  • billingMonth (string) –

    The billing month for the returned charges, in YYYY-MM format.

  • isEstimated (boolean) –

    Specifies whether the Support charge amount is estimated. When false, the charge amount is finalized.

  • totalSupportCharge (string) –

    The total Business Support charge amount for all accounts in the billing month.

  • totalSupportEligibleSpend (string) –

    The total Support-eligible spend from all accounts in the billing month. This includes eligible spend from usage of Amazon Web Services.

  • accountCount (integer) –

    The total number of linked accounts with Business Support charges in the billing month.

  • accountCharges (list) –

    The list of Business Support charges per linked account.

    • (dict) –

      Business Support charges for a linked account.

      • accountId (string) –

        The linked account ID.

      • supportPlanName (string) –

        The Support plan name for this account. Valid values: AWSSupportBusiness (Business Support plan), AWSSupportDeveloper (Developer Support plan), AWSSupportEssential (Basic Support plan).

      • totalCharge (string) –

        The total Business Support charge amount for this account in the billing month.

      • totalUsageBasis (string) –

        The total Support-eligible spend used as the basis for calculating the Business Support charge for this account.

      • tierCharges (list) –

        The tier-level charges that make up the total Business Support charge for this account. Each tier represents a spend range with its own rate.

        • (dict) –

          A tier-level charge within a Business Support pricing plan. Business Support uses tiered pricing where different percentage rates apply to different ranges of Support-eligible spend.

          • tierDescription (string) –

            A human-readable description of the pricing tier, including the spend range and percentage rate applied.

          • tierRate (string) –

            The percentage rate applied to Support-eligible spend within this pricing tier.

          • usageSlice (string) –

            The amount of Support-eligible spend that falls within this pricing tier.

          • tierCharge (string) –

            The Business Support charge amount calculated for this pricing tier.

          • chargePeriodStartDate (datetime) –

            The start date of the charge period for this tier charge.

          • chargePeriodEndDate (datetime) –

            The end date of the charge period for this tier charge.

      • supportDiscount (dict) –

        The discount applied to the Business Support charge for this account, if any. This field is absent when no discount applies.

        • discountAmount (string) –

          The discount amount applied to the Business Support charge. This value is negative, representing a reduction in the charge.

        • discountPercentage (string) –

          The discount percentage applied to the Business Support charge, expressed as a decimal (for example, 0.12 for a 12% discount).

        • discountType (string) –

          The type of discount applied. Valid values: Distributor_Discount (a discount applied through a distributor arrangement), SPP_Discount (a discount applied through the Solution Provider Program).

        • discountSource (string) –

          The source or program through which the discount was applied.

      • supportEligibleSpendByService (list) –

        The Support-eligible spend broken down by contributing service for this account.

        • (dict) –

          A service-level spend entry contributing to Business Support eligible spend.

          • contributingService (string) –

            The name of the Amazon Web Services service contributing to the Support-eligible spend.

          • itemType (string) –

            The type of the line item. Valid values: Usage.

          • description (string) –

            A human-readable description of the service spend entry.

          • chargeAmount (string) –

            The Support-eligible spend amount for this service.

          • currency (string) –

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

  • nextToken (string) –

    The pagination token for the next page of results.

Exceptions

• Billing.Client.exceptions.ThrottlingException

• Billing.Client.exceptions.ResourceNotFoundException

• Billing.Client.exceptions.AccessDeniedException

• Billing.Client.exceptions.ValidationException

• Billing.Client.exceptions.InternalServerException