BillingConductor / Client / list_billing_group_cost_reports

list_billing_group_cost_reports

BillingConductor.Client.list_billing_group_cost_reports(**kwargs)

A paginated call to retrieve a summary report of actual Amazon Web Services charges and the calculated Amazon Web Services charges based on the associated pricing plan of a billing group.

See also: AWS API Documentation

Request Syntax

response = client.list_billing_group_cost_reports(
    BillingPeriod='string',
    MaxResults=123,
    NextToken='string',
    Filters={
        'BillingGroupArns': [
            'string',
        ]
    }
)

Parameters:

• BillingPeriod (string) – The preferred billing period for your report.

• MaxResults (integer) – The maximum number of reports to retrieve.

• NextToken (string) – The pagination token that’s used on subsequent calls to get reports.

• Filters (dict) –

  A ListBillingGroupCostReportsFilter to specify billing groups to retrieve reports from.

  • BillingGroupArns (list) –

    The list of Amazon Resource Names (ARNs) used to filter billing groups to retrieve reports.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'BillingGroupCostReports': [
        {
            'Arn': 'string',
            'AWSCost': 'string',
            'ProformaCost': 'string',
            'Margin': 'string',
            'MarginPercentage': 'string',
            'Currency': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • BillingGroupCostReports (list) –

    A list of BillingGroupCostReportElement retrieved.

    • (dict) –

      A summary report of actual Amazon Web Services charges and calculated Amazon Web Services charges, based on the associated pricing plan of a billing group.

      • Arn (string) –

        The Amazon Resource Name (ARN) of a billing group.

      • AWSCost (string) –

        The actual Amazon Web Services charges for the billing group.

      • ProformaCost (string) –

        The hypothetical Amazon Web Services charges based on the associated pricing plan of a billing group.

      • Margin (string) –

        The billing group margin.

      • MarginPercentage (string) –

        The percentage of billing group margin.

      • Currency (string) –

        The displayed currency.

  • NextToken (string) –

    The pagination token that’s used on subsequent calls to get reports.

Exceptions

• BillingConductor.Client.exceptions.ThrottlingException

• BillingConductor.Client.exceptions.AccessDeniedException

• BillingConductor.Client.exceptions.ValidationException

• BillingConductor.Client.exceptions.InternalServerException

• BillingConductor.Client.exceptions.ResourceNotFoundException