AWS Billing

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

See also: AWS API Documentation

Request Syntax

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

type billingMonth:

string

param billingMonth:

[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).

type accountId:

string

param accountId:

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.

type maxResults:

integer

param maxResults:

The maximum number of results to return per page. Default is 100.

type nextToken:

string

param nextToken:

The pagination token for the next page of results.

rtype:

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.

Returns the history of Business Support subscription contracts across accounts.

See also: AWS API Documentation

Request Syntax

client.list_business_support_subscription_history(
    billingMonth='string',
    accountId='string',
    startDate=datetime(2015, 1, 1),
    endDate=datetime(2015, 1, 1),
    maxResults=123,
    nextToken='string'
)

type billingMonth:

string

param billingMonth:

The billing month to retrieve subscription contracts for, in YYYY-MM format. If you don't specify a value, defaults to the current month.

type accountId:

string

param accountId:

The account ID to filter results to a specific account. If you don't specify a value, the response includes subscription history for all accounts.

type startDate:

datetime

param startDate:

The start date to filter subscription contracts from.

type endDate:

datetime

param endDate:

The end date to filter subscription contracts to.

type maxResults:

integer

param maxResults:

The maximum number of results to return per page. Default is 100.

type nextToken:

string

param nextToken:

The pagination token for the next page of results.

rtype:

dict

returns:

Response Syntax

{
    'subscriptionContracts': [
        {
            'accountId': 'string',
            'planName': 'string',
            'contractStartDate': datetime(2015, 1, 1),
            'contractEndDate': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) --

  Contains the list of Business Support subscription contracts that match the request filters.

  • subscriptionContracts (list) --

    The list of Business Support subscription contracts.

    • (dict) --

      A Business Support subscription contract for an account.

      • accountId (string) --

        The account ID associated with this subscription contract.

      • planName (string) --

        The name of the Support plan for this subscription contract. Valid values: AWSSupportBusiness (Business Support plan), AWSSupportDeveloper (Developer Support plan), AWSSupportEssential (Basic Support plan).

      • contractStartDate (datetime) --

        The start date of the subscription contract.

      • contractEndDate (datetime) --

        The end date of the subscription contract.

  • nextToken (string) --

    The pagination token for the next page of results.