Inspector2 / Client / list_usage_totals

list_usage_totals

Inspector2.Client.list_usage_totals(**kwargs)

Lists the Amazon Inspector usage totals over the last 30 days.

See also: AWS API Documentation

Request Syntax

response = client.list_usage_totals(
    accountIds=[
        'string',
    ],
    maxResults=123,
    nextToken='string'
)

Parameters:

• accountIds (list) –

  The Amazon Web Services account IDs to retrieve usage totals for.

  • (string) –

• maxResults (integer) – The maximum number of results the response can return. If your request would return more than the maximum the response will return a nextToken value, use this value when you call the action again to get the remaining results.

• nextToken (string) – A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. If your response returns more than the maxResults maximum value it will also return a nextToken value. For subsequent calls, use the nextToken value returned from the previous request to continue listing results after the first page.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'totals': [
        {
            'accountId': 'string',
            'usage': [
                {
                    'currency': 'USD',
                    'estimatedMonthlyCost': 123.0,
                    'total': 123.0,
                    'type': 'EC2_INSTANCE_HOURS'|'ECR_INITIAL_SCAN'|'ECR_RESCAN'|'LAMBDA_FUNCTION_HOURS'|'LAMBDA_FUNCTION_CODE_HOURS'
                },
            ]
        },
    ]
}

Response Structure

• (dict) –

  • nextToken (string) –

    The pagination parameter to be used on the next list operation to retrieve more items.

  • totals (list) –

    An object with details on the total usage for the requested account.

    • (dict) –

      The total of usage for an account ID.

      • accountId (string) –

        The account ID of the account that usage data was retrieved for.

      • usage (list) –

        An object representing the total usage for an account.

        • (dict) –

          Contains usage information about the cost of Amazon Inspector operation.

          • currency (string) –

            The currency type used when calculating usage data.

          • estimatedMonthlyCost (float) –

            The estimated monthly cost of Amazon Inspector.

          • total (float) –

            The total of usage.

          • type (string) –

            The type scan.

Exceptions

• Inspector2.Client.exceptions.ValidationException

• Inspector2.Client.exceptions.AccessDeniedException

• Inspector2.Client.exceptions.ThrottlingException

• Inspector2.Client.exceptions.InternalServerException