ListCoverageStatistics¶

class Inspector2.Paginator.ListCoverageStatistics¶

paginator = client.get_paginator('list_coverage_statistics')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from Inspector2.Client.list_coverage_statistics().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    filterCriteria={
        'accountId': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'ec2InstanceTags': [
            {
                'comparison': 'EQUALS',
                'key': 'string',
                'value': 'string'
            },
        ],
        'ecrImageTags': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'ecrRepositoryName': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'lambdaFunctionName': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'lambdaFunctionRuntime': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'lambdaFunctionTags': [
            {
                'comparison': 'EQUALS',
                'key': 'string',
                'value': 'string'
            },
        ],
        'resourceId': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'resourceType': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'scanStatusCode': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'scanStatusReason': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ],
        'scanType': [
            {
                'comparison': 'EQUALS'|'NOT_EQUALS',
                'value': 'string'
            },
        ]
    },
    groupBy='SCAN_STATUS_CODE'|'SCAN_STATUS_REASON'|'ACCOUNT_ID'|'RESOURCE_TYPE'|'ECR_REPOSITORY_NAME',
    PaginationConfig={
        'MaxItems': 123,
        'StartingToken': 'string'
    }
)

Parameters

filterCriteria (dict) --
An object that contains details on the filters to apply to the coverage data for your environment.
- accountId (list) --
  An array of Amazon Web Services account IDs to return coverage statistics for.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- ec2InstanceTags (list) --
  The Amazon EC2 instance tags to filter on.
  - (dict) --
    Contains details of a coverage map filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare coverage on.
    - key (string) -- [REQUIRED]
      The tag key associated with the coverage map filter.
    - value (string) --
      The tag value associated with the coverage map filter.
- ecrImageTags (list) --
  The Amazon ECR image tags to filter on.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- ecrRepositoryName (list) --
  The Amazon ECR repository name to filter on.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- lambdaFunctionName (list) --
  Returns coverage statistics for AWS Lambda functions filtered by function names.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- lambdaFunctionRuntime (list) --
  Returns coverage statistics for AWS Lambda functions filtered by runtime.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- lambdaFunctionTags (list) --
  Returns coverage statistics for AWS Lambda functions filtered by tag.
  - (dict) --
    Contains details of a coverage map filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare coverage on.
    - key (string) -- [REQUIRED]
      The tag key associated with the coverage map filter.
    - value (string) --
      The tag value associated with the coverage map filter.
- resourceId (list) --
  An array of Amazon Web Services resource IDs to return coverage statistics for.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- resourceType (list) --
  An array of Amazon Web Services resource types to return coverage statistics for. The values can be AWS_EC2_INSTANCE or AWS_ECR_REPOSITORY .
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- scanStatusCode (list) --
  The scan status code to filter on.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- scanStatusReason (list) --
  The scan status reason to filter on.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
- scanType (list) --
  An array of Amazon Inspector scan types to return coverage statistics for.
  - (dict) --
    Contains details of a coverage string filter.
    - comparison (string) -- [REQUIRED]
      The operator to compare strings on.
    - value (string) -- [REQUIRED]
      The value to compare strings on.
groupBy (string) -- The value to group the results by.
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.
- StartingToken (string) --
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'countsByGroup': [
        {
            'count': 123,
            'groupKey': 'SCAN_STATUS_CODE'|'SCAN_STATUS_REASON'|'ACCOUNT_ID'|'RESOURCE_TYPE'|'ECR_REPOSITORY_NAME'
        },
    ],
    'totalCounts': 123,
    'NextToken': 'string'
}

Response Structure

(dict) --
- countsByGroup (list) --
  
  An array with the number for each group.
  - (dict) --
    
    a structure that contains information on the count of resources within a group.
    - count (integer) --
      
      The number of resources.
    - groupKey (string) --
      
      The key associated with this group
- totalCounts (integer) --
  
  The total number for all groups.
- NextToken (string) --
  
  A token to resume pagination.

Table Of Contents

ListCoverageStatistics¶