EC2 / Paginator / GetImageFindings

GetImageFindings¶

class EC2.Paginator.GetImageFindings¶

paginator = client.get_paginator('get_image_findings')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from EC2.Client.get_image_findings().

Request Syntax

response_iterator = paginator.paginate(
    ImageId='string',
    DryRun=True|False,
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

ImageId (string) –
[REQUIRED]

The ID of the AMI.
DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
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

{
    'ImageFindings': [
        {
            'FixAvailable': True|False,
            'Score': 123.0,
            'FirstObservedAt': datetime(2015, 1, 1),
            'UpdatedAt': datetime(2015, 1, 1),
            'Title': 'string',
            'Paths': [
                'string',
            ],
            'SeverityLabel': 'informational'|'low'|'medium'|'high'|'critical',
            'SnapshotId': 'string'
        },
    ],

}

Response Structure

(dict) –
- ImageFindings (list) –
  
  The Amazon Inspector findings for the AMI.
  - (dict) –
    
    Describes an Amazon Inspector vulnerability finding for an AMI.
    - FixAvailable (boolean) –
      
      Specifies whether a fix is available for the finding. This value is true when Amazon Inspector reports a full or partial fix for the finding.
    - Score (float) –
      
      The Amazon Inspector score for the finding.
    - FirstObservedAt (datetime) –
      
      The date and time, in the ISO 8601 format in the UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ), when Amazon Inspector first observed the finding.
    - UpdatedAt (datetime) –
      
      The date and time, in the ISO 8601 format in the UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ), when Amazon Inspector last updated the finding.
    - Title (string) –
      
      The title of the finding.
    - Paths (list) –
      
      The file paths in the AMI that are affected by the finding. Amazon EC2 returns up to 10 file paths for each finding.
      - (string) –
    - SeverityLabel (string) –
      
      The severity of the finding.
      
      The valid values are the following Amazon Inspector severity levels, which correspond to CVSS score ranges:
      - informational - CVSS score of 0.
      - low - CVSS score of 0.1 to 3.9.
      - medium - CVSS score of 4.0 to 6.9.
      - high - CVSS score of 7.0 to 8.9.
      - critical - CVSS score of 9.0 to 10.0.
      For more information, see Software package vulnerability severity in the Amazon Inspector User Guide.
    - SnapshotId (string) –
      
      The ID of the Amazon EBS snapshot of the AMI in which the finding was detected.