Inspector / Paginator / ListFindings

ListFindings#

class Inspector.Paginator.ListFindings#
paginator = client.get_paginator('list_findings')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from Inspector.Client.list_findings().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    assessmentRunArns=[
        'string',
    ],
    filter={
        'agentIds': [
            'string',
        ],
        'autoScalingGroups': [
            'string',
        ],
        'ruleNames': [
            'string',
        ],
        'severities': [
            'Low'|'Medium'|'High'|'Informational'|'Undefined',
        ],
        'rulesPackageArns': [
            'string',
        ],
        'attributes': [
            {
                'key': 'string',
                'value': 'string'
            },
        ],
        'userAttributes': [
            {
                'key': 'string',
                'value': 'string'
            },
        ],
        'creationTimeRange': {
            'beginDate': datetime(2015, 1, 1),
            'endDate': datetime(2015, 1, 1)
        }
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • assessmentRunArns (list) –

    The ARNs of the assessment runs that generate the findings that you want to list.

    • (string) –

  • filter (dict) –

    You can use this parameter to specify a subset of data to be included in the action’s response.

    For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

    • agentIds (list) –

      For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the agentId property of the Finding data type.

      • (string) –

    • autoScalingGroups (list) –

      For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the autoScalingGroup property of the Finding data type.

      • (string) –

    • ruleNames (list) –

      For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the ruleName property of the Finding data type.

      • (string) –

    • severities (list) –

      For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the severity property of the Finding data type.

      • (string) –

    • rulesPackageArns (list) –

      For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the rulesPackageArn property of the Finding data type.

      • (string) –

    • attributes (list) –

      For a record to match a filter, the list of values that are specified for this data type property must be contained in the list of values of the attributes property of the Finding data type.

      • (dict) –

        This data type is used as a request parameter in the AddAttributesToFindings and CreateAssessmentTemplate actions.

        • key (string) – [REQUIRED]

          The attribute key.

        • value (string) –

          The value assigned to the attribute key.

    • userAttributes (list) –

      For a record to match a filter, the value that is specified for this data type property must be contained in the list of values of the userAttributes property of the Finding data type.

      • (dict) –

        This data type is used as a request parameter in the AddAttributesToFindings and CreateAssessmentTemplate actions.

        • key (string) – [REQUIRED]

          The attribute key.

        • value (string) –

          The value assigned to the attribute key.

    • creationTimeRange (dict) –

      The time range during which the finding is generated.

      • beginDate (datetime) –

        The minimum value of the timestamp range.

      • endDate (datetime) –

        The maximum value of the timestamp range.

  • 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

{
    'findingArns': [
        'string',
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • findingArns (list) –

      A list of ARNs that specifies the findings returned by the action.

      • (string) –

    • NextToken (string) –

      A token to resume pagination.