2024/11/11 - Inspector2 - 7 updated api methods
Changes Adds support for filePath filter.
{'filterCriteria': {'vulnerablePackages': {'filePath': {'comparison': 'EQUALS '
'| '
'PREFIX '
'| '
'NOT_EQUALS',
'value': 'string'}}}}
Creates a filter resource using specified filter criteria. When the filter action is set to SUPPRESS this action creates a suppression rule.
See also: AWS API Documentation
Request Syntax
client.create_filter(
action='NONE'|'SUPPRESS',
description='string',
filterCriteria={
'awsAccountId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityFilePath': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceImageId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceSubnetId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceVpcId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageArchitecture': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageHash': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImagePushedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'ecrImageRegistry': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageRepositoryName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'epssScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'exploitAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingStatus': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'firstObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'fixAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'inspectorScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'lambdaFunctionExecutionRoleArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionLastModifiedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'lambdaFunctionLayers': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionRuntime': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lastObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'networkProtocol': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'portRange': [
{
'beginInclusive': 123,
'endInclusive': 123
},
],
'relatedVulnerabilities': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceTags': [
{
'comparison': 'EQUALS',
'key': 'string',
'value': 'string'
},
],
'resourceType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'severity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'title': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'updatedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'vendorSeverity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilityId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilitySource': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerablePackages': [
{
'architecture': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'epoch': {
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
'filePath': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'name': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'release': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLambdaLayerArn': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLayerHash': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'version': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
}
},
]
},
name='string',
reason='string',
tags={
'string': 'string'
}
)
string
[REQUIRED]
Defines the action that is to be applied to the findings that match the filter.
string
A description of the filter.
dict
[REQUIRED]
Defines the criteria to be used in the filter for querying findings.
awsAccountId (list) --
Details of the Amazon Web Services account IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorName (list) --
The name of the detector used to identify a code vulnerability in a Lambda function used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorTags (list) --
The detector type tag associated with the vulnerability used to filter findings. Detector tags group related vulnerabilities by common themes or tactics. For a list of available tags by programming language, see Java tags, or Python tags.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityFilePath (list) --
The file path to the file in a Lambda function that contains a code vulnerability used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentId (list) --
Details of the component IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentType (list) --
Details of the component types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceImageId (list) --
Details of the Amazon EC2 instance image IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceSubnetId (list) --
Details of the Amazon EC2 instance subnet IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceVpcId (list) --
Details of the Amazon EC2 instance VPC IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageArchitecture (list) --
Details of the Amazon ECR image architecture types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageHash (list) --
Details of the Amazon ECR image hashes used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImagePushedAt (list) --
Details on the Amazon ECR image push date and time used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
ecrImageRegistry (list) --
Details on the Amazon ECR registry used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageRepositoryName (list) --
Details on the name of the Amazon ECR repository used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageTags (list) --
The tags attached to the Amazon ECR container image.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epssScore (list) --
The EPSS score used to filter findings.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
exploitAvailable (list) --
Filters the list of Amazon Web Services Lambda findings by the availability of exploits.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingArn (list) --
Details on the finding ARNs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingStatus (list) --
Details on the finding status types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingType (list) --
Details on the finding types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
firstObservedAt (list) --
Details on the date and time a finding was first seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
fixAvailable (list) --
Details on whether a fix is available through a version update. This value can be YES, NO, or PARTIAL. A PARTIAL fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
inspectorScore (list) --
The Amazon Inspector score to filter on.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
lambdaFunctionExecutionRoleArn (list) --
Filters the list of Amazon Web Services Lambda functions by execution role.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionLastModifiedAt (list) --
Filters the list of Amazon Web Services Lambda functions by the date and time that a user last updated the configuration, in ISO 8601 format
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
lambdaFunctionLayers (list) --
Filters the list of Amazon Web Services Lambda functions by the function's layers. A Lambda function can have up to five layers.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionName (list) --
Filters the list of Amazon Web Services Lambda functions by the name of the function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionRuntime (list) --
Filters the list of Amazon Web Services Lambda functions by the runtime environment for the Lambda function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lastObservedAt (list) --
Details on the date and time a finding was last seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
networkProtocol (list) --
Details on network protocol used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
portRange (list) --
Details on the port ranges used to filter findings.
(dict) --
An object that describes the details of a port range filter.
beginInclusive (integer) --
The port number the port range begins at.
endInclusive (integer) --
The port number the port range ends at.
relatedVulnerabilities (list) --
Details on the related vulnerabilities used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceId (list) --
Details on the resource IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceTags (list) --
Details on the resource tags used to filter findings.
(dict) --
An object that describes details of a map filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
key (string) -- [REQUIRED]
The tag key used in the filter.
value (string) --
The tag value used in the filter.
resourceType (list) --
Details on the resource types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
severity (list) --
Details on the severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
title (list) --
Details on the finding title used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
updatedAt (list) --
Details on the date and time a finding was last updated at used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
vendorSeverity (list) --
Details on the vendor severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilityId (list) --
Details on the vulnerability ID used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilitySource (list) --
Details on the vulnerability type used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerablePackages (list) --
Details on the vulnerable packages used to filter findings.
(dict) --
Contains information on the details of a package filter.
architecture (dict) --
An object that contains details on the package architecture type to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epoch (dict) --
An object that contains details on the package epoch to filter on.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
filePath (dict) --
An object that contains details on the package file path to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
name (dict) --
An object that contains details on the name of the package to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
release (dict) --
An object that contains details on the package release to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLambdaLayerArn (dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLayerHash (dict) --
An object that contains details on the source layer hash to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
version (dict) --
The package version to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
string
[REQUIRED]
The name of the filter. Minimum length of 3. Maximum length of 64. Valid characters include alphanumeric characters, dot (.), underscore (_), and dash (-). Spaces are not allowed.
string
The reason for creating the filter.
dict
A list of tags for the filter.
(string) --
(string) --
dict
Response Syntax
{
'arn': 'string'
}
Response Structure
(dict) --
arn (string) --
The Amazon Resource Number (ARN) of the successfully created filter.
{'filterCriteria': {'vulnerablePackages': {'filePath': {'comparison': 'EQUALS '
'| '
'PREFIX '
'| '
'NOT_EQUALS',
'value': 'string'}}}}
Creates a finding report. By default only ACTIVE findings are returned in the report. To see SUPRESSED or CLOSED findings you must specify a value for the findingStatus filter criteria.
See also: AWS API Documentation
Request Syntax
client.create_findings_report(
filterCriteria={
'awsAccountId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityFilePath': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceImageId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceSubnetId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceVpcId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageArchitecture': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageHash': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImagePushedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'ecrImageRegistry': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageRepositoryName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'epssScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'exploitAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingStatus': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'firstObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'fixAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'inspectorScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'lambdaFunctionExecutionRoleArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionLastModifiedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'lambdaFunctionLayers': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionRuntime': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lastObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'networkProtocol': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'portRange': [
{
'beginInclusive': 123,
'endInclusive': 123
},
],
'relatedVulnerabilities': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceTags': [
{
'comparison': 'EQUALS',
'key': 'string',
'value': 'string'
},
],
'resourceType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'severity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'title': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'updatedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'vendorSeverity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilityId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilitySource': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerablePackages': [
{
'architecture': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'epoch': {
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
'filePath': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'name': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'release': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLambdaLayerArn': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLayerHash': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'version': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
}
},
]
},
reportFormat='CSV'|'JSON',
s3Destination={
'bucketName': 'string',
'keyPrefix': 'string',
'kmsKeyArn': 'string'
}
)
dict
The filter criteria to apply to the results of the finding report.
awsAccountId (list) --
Details of the Amazon Web Services account IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorName (list) --
The name of the detector used to identify a code vulnerability in a Lambda function used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorTags (list) --
The detector type tag associated with the vulnerability used to filter findings. Detector tags group related vulnerabilities by common themes or tactics. For a list of available tags by programming language, see Java tags, or Python tags.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityFilePath (list) --
The file path to the file in a Lambda function that contains a code vulnerability used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentId (list) --
Details of the component IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentType (list) --
Details of the component types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceImageId (list) --
Details of the Amazon EC2 instance image IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceSubnetId (list) --
Details of the Amazon EC2 instance subnet IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceVpcId (list) --
Details of the Amazon EC2 instance VPC IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageArchitecture (list) --
Details of the Amazon ECR image architecture types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageHash (list) --
Details of the Amazon ECR image hashes used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImagePushedAt (list) --
Details on the Amazon ECR image push date and time used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
ecrImageRegistry (list) --
Details on the Amazon ECR registry used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageRepositoryName (list) --
Details on the name of the Amazon ECR repository used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageTags (list) --
The tags attached to the Amazon ECR container image.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epssScore (list) --
The EPSS score used to filter findings.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
exploitAvailable (list) --
Filters the list of Amazon Web Services Lambda findings by the availability of exploits.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingArn (list) --
Details on the finding ARNs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingStatus (list) --
Details on the finding status types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingType (list) --
Details on the finding types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
firstObservedAt (list) --
Details on the date and time a finding was first seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
fixAvailable (list) --
Details on whether a fix is available through a version update. This value can be YES, NO, or PARTIAL. A PARTIAL fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
inspectorScore (list) --
The Amazon Inspector score to filter on.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
lambdaFunctionExecutionRoleArn (list) --
Filters the list of Amazon Web Services Lambda functions by execution role.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionLastModifiedAt (list) --
Filters the list of Amazon Web Services Lambda functions by the date and time that a user last updated the configuration, in ISO 8601 format
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
lambdaFunctionLayers (list) --
Filters the list of Amazon Web Services Lambda functions by the function's layers. A Lambda function can have up to five layers.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionName (list) --
Filters the list of Amazon Web Services Lambda functions by the name of the function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionRuntime (list) --
Filters the list of Amazon Web Services Lambda functions by the runtime environment for the Lambda function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lastObservedAt (list) --
Details on the date and time a finding was last seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
networkProtocol (list) --
Details on network protocol used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
portRange (list) --
Details on the port ranges used to filter findings.
(dict) --
An object that describes the details of a port range filter.
beginInclusive (integer) --
The port number the port range begins at.
endInclusive (integer) --
The port number the port range ends at.
relatedVulnerabilities (list) --
Details on the related vulnerabilities used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceId (list) --
Details on the resource IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceTags (list) --
Details on the resource tags used to filter findings.
(dict) --
An object that describes details of a map filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
key (string) -- [REQUIRED]
The tag key used in the filter.
value (string) --
The tag value used in the filter.
resourceType (list) --
Details on the resource types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
severity (list) --
Details on the severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
title (list) --
Details on the finding title used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
updatedAt (list) --
Details on the date and time a finding was last updated at used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
vendorSeverity (list) --
Details on the vendor severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilityId (list) --
Details on the vulnerability ID used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilitySource (list) --
Details on the vulnerability type used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerablePackages (list) --
Details on the vulnerable packages used to filter findings.
(dict) --
Contains information on the details of a package filter.
architecture (dict) --
An object that contains details on the package architecture type to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epoch (dict) --
An object that contains details on the package epoch to filter on.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
filePath (dict) --
An object that contains details on the package file path to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
name (dict) --
An object that contains details on the name of the package to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
release (dict) --
An object that contains details on the package release to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLambdaLayerArn (dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLayerHash (dict) --
An object that contains details on the source layer hash to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
version (dict) --
The package version to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
string
[REQUIRED]
The format to generate the report in.
dict
[REQUIRED]
The Amazon S3 export destination for the report.
bucketName (string) -- [REQUIRED]
The name of the Amazon S3 bucket to export findings to.
keyPrefix (string) --
The prefix that the findings will be written under.
kmsKeyArn (string) -- [REQUIRED]
The ARN of the KMS key used to encrypt data when exporting findings.
dict
Response Syntax
{
'reportId': 'string'
}
Response Structure
(dict) --
reportId (string) --
The ID of the report.
{'filterCriteria': {'vulnerablePackages': {'filePath': {'comparison': 'EQUALS '
'| '
'PREFIX '
'| '
'NOT_EQUALS',
'value': 'string'}}}}
Gets the status of a findings report.
See also: AWS API Documentation
Request Syntax
client.get_findings_report_status(
reportId='string'
)
string
The ID of the report to retrieve the status of.
dict
Response Syntax
{
'destination': {
'bucketName': 'string',
'keyPrefix': 'string',
'kmsKeyArn': 'string'
},
'errorCode': 'INTERNAL_ERROR'|'INVALID_PERMISSIONS'|'NO_FINDINGS_FOUND'|'BUCKET_NOT_FOUND'|'INCOMPATIBLE_BUCKET_REGION'|'MALFORMED_KMS_KEY',
'errorMessage': 'string',
'filterCriteria': {
'awsAccountId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityFilePath': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceImageId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceSubnetId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceVpcId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageArchitecture': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageHash': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImagePushedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'ecrImageRegistry': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageRepositoryName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'epssScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'exploitAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingStatus': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'firstObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'fixAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'inspectorScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'lambdaFunctionExecutionRoleArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionLastModifiedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'lambdaFunctionLayers': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionRuntime': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lastObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'networkProtocol': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'portRange': [
{
'beginInclusive': 123,
'endInclusive': 123
},
],
'relatedVulnerabilities': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceTags': [
{
'comparison': 'EQUALS',
'key': 'string',
'value': 'string'
},
],
'resourceType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'severity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'title': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'updatedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'vendorSeverity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilityId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilitySource': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerablePackages': [
{
'architecture': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'epoch': {
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
'filePath': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'name': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'release': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLambdaLayerArn': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLayerHash': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'version': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
}
},
]
},
'reportId': 'string',
'status': 'SUCCEEDED'|'IN_PROGRESS'|'CANCELLED'|'FAILED'
}
Response Structure
(dict) --
destination (dict) --
The destination of the report.
bucketName (string) --
The name of the Amazon S3 bucket to export findings to.
keyPrefix (string) --
The prefix that the findings will be written under.
kmsKeyArn (string) --
The ARN of the KMS key used to encrypt data when exporting findings.
errorCode (string) --
The error code of the report.
errorMessage (string) --
The error message of the report.
filterCriteria (dict) --
The filter criteria associated with the report.
awsAccountId (list) --
Details of the Amazon Web Services account IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
codeVulnerabilityDetectorName (list) --
The name of the detector used to identify a code vulnerability in a Lambda function used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
codeVulnerabilityDetectorTags (list) --
The detector type tag associated with the vulnerability used to filter findings. Detector tags group related vulnerabilities by common themes or tactics. For a list of available tags by programming language, see Java tags, or Python tags.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
codeVulnerabilityFilePath (list) --
The file path to the file in a Lambda function that contains a code vulnerability used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
componentId (list) --
Details of the component IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
componentType (list) --
Details of the component types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ec2InstanceImageId (list) --
Details of the Amazon EC2 instance image IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ec2InstanceSubnetId (list) --
Details of the Amazon EC2 instance subnet IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ec2InstanceVpcId (list) --
Details of the Amazon EC2 instance VPC IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageArchitecture (list) --
Details of the Amazon ECR image architecture types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageHash (list) --
Details of the Amazon ECR image hashes used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImagePushedAt (list) --
Details on the Amazon ECR image push date and time used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
ecrImageRegistry (list) --
Details on the Amazon ECR registry used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageRepositoryName (list) --
Details on the name of the Amazon ECR repository used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageTags (list) --
The tags attached to the Amazon ECR container image.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
epssScore (list) --
The EPSS score used to filter findings.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
exploitAvailable (list) --
Filters the list of Amazon Web Services Lambda findings by the availability of exploits.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
findingArn (list) --
Details on the finding ARNs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
findingStatus (list) --
Details on the finding status types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
findingType (list) --
Details on the finding types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
firstObservedAt (list) --
Details on the date and time a finding was first seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
fixAvailable (list) --
Details on whether a fix is available through a version update. This value can be YES, NO, or PARTIAL. A PARTIAL fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
inspectorScore (list) --
The Amazon Inspector score to filter on.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
lambdaFunctionExecutionRoleArn (list) --
Filters the list of Amazon Web Services Lambda functions by execution role.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lambdaFunctionLastModifiedAt (list) --
Filters the list of Amazon Web Services Lambda functions by the date and time that a user last updated the configuration, in ISO 8601 format
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
lambdaFunctionLayers (list) --
Filters the list of Amazon Web Services Lambda functions by the function's layers. A Lambda function can have up to five layers.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lambdaFunctionName (list) --
Filters the list of Amazon Web Services Lambda functions by the name of the function.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lambdaFunctionRuntime (list) --
Filters the list of Amazon Web Services Lambda functions by the runtime environment for the Lambda function.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lastObservedAt (list) --
Details on the date and time a finding was last seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
networkProtocol (list) --
Details on network protocol used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
portRange (list) --
Details on the port ranges used to filter findings.
(dict) --
An object that describes the details of a port range filter.
beginInclusive (integer) --
The port number the port range begins at.
endInclusive (integer) --
The port number the port range ends at.
relatedVulnerabilities (list) --
Details on the related vulnerabilities used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
resourceId (list) --
Details on the resource IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
resourceTags (list) --
Details on the resource tags used to filter findings.
(dict) --
An object that describes details of a map filter.
comparison (string) --
The operator to use when comparing values in the filter.
key (string) --
The tag key used in the filter.
value (string) --
The tag value used in the filter.
resourceType (list) --
Details on the resource types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
severity (list) --
Details on the severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
title (list) --
Details on the finding title used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
updatedAt (list) --
Details on the date and time a finding was last updated at used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
vendorSeverity (list) --
Details on the vendor severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
vulnerabilityId (list) --
Details on the vulnerability ID used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
vulnerabilitySource (list) --
Details on the vulnerability type used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
vulnerablePackages (list) --
Details on the vulnerable packages used to filter findings.
(dict) --
Contains information on the details of a package filter.
architecture (dict) --
An object that contains details on the package architecture type to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
epoch (dict) --
An object that contains details on the package epoch to filter on.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
filePath (dict) --
An object that contains details on the package file path to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
name (dict) --
An object that contains details on the name of the package to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
release (dict) --
An object that contains details on the package release to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
sourceLambdaLayerArn (dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
sourceLayerHash (dict) --
An object that contains details on the source layer hash to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
version (dict) --
The package version to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
reportId (string) --
The ID of the report.
status (string) --
The status of the report.
{'coveredResources': {'resourceMetadata': {'lambdaFunction': {'runtime': {'DOTNETCORE_3_1',
'DOTNET_6',
'DOTNET_7',
'PYTHON_3_11',
'RUBY_2_7',
'RUBY_3_2'}}}}}
Lists coverage details for your environment.
See also: AWS API Documentation
Request Syntax
client.list_coverage(
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'
},
],
'imagePulledAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'lambdaFunctionName': [
{
'comparison': 'EQUALS'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionRuntime': [
{
'comparison': 'EQUALS'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionTags': [
{
'comparison': 'EQUALS',
'key': 'string',
'value': 'string'
},
],
'lastScannedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'resourceId': [
{
'comparison': 'EQUALS'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceType': [
{
'comparison': 'EQUALS'|'NOT_EQUALS',
'value': 'string'
},
],
'scanMode': [
{
'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'
},
]
},
maxResults=123,
nextToken='string'
)
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.
imagePulledAt (list) --
The date an image was last pulled at.
(dict) --
Contains details of a coverage date filter.
endInclusive (datetime) --
A timestamp representing the end of the time period to filter results by.
startInclusive (datetime) --
A timestamp representing the start of the time period to filter results by.
lambdaFunctionName (list) --
Returns coverage statistics for Amazon Web Services 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 Amazon Web Services 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 Amazon Web Services 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.
lastScannedAt (list) --
Filters Amazon Web Services resources based on whether Amazon Inspector has checked them for vulnerabilities within the specified time range.
(dict) --
Contains details of a coverage date filter.
endInclusive (datetime) --
A timestamp representing the end of the time period to filter results by.
startInclusive (datetime) --
A timestamp representing the start of the time period to filter results by.
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, AWS_LAMBDA_FUNCTION, AWS_ECR_CONTAINER_IMAGE, AWS_ECR_REPOSITORY or AWS_ACCOUNT.
(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.
scanMode (list) --
The filter to search for Amazon EC2 instance coverage by scan mode. Valid values are EC2_SSM_AGENT_BASED and EC2_AGENTLESS.
(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. Valid values are: ValidationException, InternalServerException, ResourceNotFoundException, BadRequestException, and ThrottlingException.
(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.
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.
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.
dict
Response Syntax
{
'coveredResources': [
{
'accountId': 'string',
'lastScannedAt': datetime(2015, 1, 1),
'resourceId': 'string',
'resourceMetadata': {
'ec2': {
'amiId': 'string',
'platform': 'WINDOWS'|'LINUX'|'UNKNOWN'|'MACOS',
'tags': {
'string': 'string'
}
},
'ecrImage': {
'imagePulledAt': datetime(2015, 1, 1),
'tags': [
'string',
]
},
'ecrRepository': {
'name': 'string',
'scanFrequency': 'MANUAL'|'SCAN_ON_PUSH'|'CONTINUOUS_SCAN'
},
'lambdaFunction': {
'functionName': 'string',
'functionTags': {
'string': 'string'
},
'layers': [
'string',
],
'runtime': 'NODEJS'|'NODEJS_12_X'|'NODEJS_14_X'|'NODEJS_16_X'|'JAVA_8'|'JAVA_8_AL2'|'JAVA_11'|'PYTHON_3_7'|'PYTHON_3_8'|'PYTHON_3_9'|'UNSUPPORTED'|'NODEJS_18_X'|'GO_1_X'|'JAVA_17'|'PYTHON_3_10'|'PYTHON_3_11'|'DOTNETCORE_3_1'|'DOTNET_6'|'DOTNET_7'|'RUBY_2_7'|'RUBY_3_2'
}
},
'resourceType': 'AWS_EC2_INSTANCE'|'AWS_ECR_CONTAINER_IMAGE'|'AWS_ECR_REPOSITORY'|'AWS_LAMBDA_FUNCTION',
'scanMode': 'EC2_SSM_AGENT_BASED'|'EC2_AGENTLESS',
'scanStatus': {
'reason': 'PENDING_INITIAL_SCAN'|'ACCESS_DENIED'|'INTERNAL_ERROR'|'UNMANAGED_EC2_INSTANCE'|'UNSUPPORTED_OS'|'SCAN_ELIGIBILITY_EXPIRED'|'RESOURCE_TERMINATED'|'SUCCESSFUL'|'NO_RESOURCES_FOUND'|'IMAGE_SIZE_EXCEEDED'|'SCAN_FREQUENCY_MANUAL'|'SCAN_FREQUENCY_SCAN_ON_PUSH'|'EC2_INSTANCE_STOPPED'|'PENDING_DISABLE'|'NO_INVENTORY'|'STALE_INVENTORY'|'EXCLUDED_BY_TAG'|'UNSUPPORTED_RUNTIME'|'UNSUPPORTED_MEDIA_TYPE'|'UNSUPPORTED_CONFIG_FILE'|'DEEP_INSPECTION_PACKAGE_COLLECTION_LIMIT_EXCEEDED'|'DEEP_INSPECTION_DAILY_SSM_INVENTORY_LIMIT_EXCEEDED'|'DEEP_INSPECTION_COLLECTION_TIME_LIMIT_EXCEEDED'|'DEEP_INSPECTION_NO_INVENTORY'|'AGENTLESS_INSTANCE_STORAGE_LIMIT_EXCEEDED'|'AGENTLESS_INSTANCE_COLLECTION_TIME_LIMIT_EXCEEDED',
'statusCode': 'ACTIVE'|'INACTIVE'
},
'scanType': 'NETWORK'|'PACKAGE'|'CODE'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
coveredResources (list) --
An object that contains details on the covered resources in your environment.
(dict) --
An object that contains details about a resource covered by Amazon Inspector.
accountId (string) --
The Amazon Web Services account ID of the covered resource.
lastScannedAt (datetime) --
The date and time the resource was last checked for vulnerabilities.
resourceId (string) --
The ID of the covered resource.
resourceMetadata (dict) --
An object that contains details about the metadata.
ec2 (dict) --
An object that contains metadata details for an Amazon EC2 instance.
amiId (string) --
The ID of the Amazon Machine Image (AMI) used to launch the instance.
platform (string) --
The platform of the instance.
tags (dict) --
The tags attached to the instance.
(string) --
(string) --
ecrImage (dict) --
An object that contains details about the container metadata for an Amazon ECR image.
imagePulledAt (datetime) --
The date an image was last pulled at.
tags (list) --
Tags associated with the Amazon ECR image metadata.
(string) --
ecrRepository (dict) --
An object that contains details about the repository an Amazon ECR image resides in.
name (string) --
The name of the Amazon ECR repository.
scanFrequency (string) --
The frequency of scans.
lambdaFunction (dict) --
An object that contains metadata details for an Amazon Web Services Lambda function.
functionName (string) --
The name of a function.
functionTags (dict) --
The resource tags on an Amazon Web Services Lambda function.
(string) --
(string) --
layers (list) --
The layers for an Amazon Web Services Lambda function. A Lambda function can have up to five layers.
(string) --
runtime (string) --
An Amazon Web Services Lambda function's runtime.
resourceType (string) --
The type of the covered resource.
scanMode (string) --
The scan method that is applied to the instance.
scanStatus (dict) --
The status of the scan covering the resource.
reason (string) --
The scan status. Possible return values and descriptions are:
PENDING_INITIAL_SCAN - This resource has been identified for scanning, results will be available soon.
ACCESS_DENIED - Resource access policy restricting Amazon Inspector access. Please update the IAM policy.
INTERNAL_ERROR - Amazon Inspector has encountered an internal error for this resource. Amazon Inspector service will automatically resolve the issue and resume the scanning. No action required from the user.
UNMANAGED_EC2_INSTANCE - The EC2 instance is not managed by SSM, please use the following SSM automation to remediate the issue: https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-managed-instance.html. Once the instance becomes managed by SSM, Inspector will automatically begin scanning this instance.
UNSUPPORTED_OS - Amazon Inspector does not support this OS, architecture, or image manifest type at this time. To see a complete list of supported operating systems see: https://docs.aws.amazon.com/inspector/latest/user/supported.html.
SCAN_ELIGIBILITY_EXPIRED - The configured scan duration has lapsed for this image.
RESOURCE_TERMINATED - This resource has been terminated. The findings and coverage associated with this resource are in the process of being cleaned up.
SUCCESSFUL - The scan was successful.
NO_RESOURCES_FOUND - Reserved for future use.
IMAGE_SIZE_EXCEEDED - Reserved for future use.
SCAN_FREQUENCY_MANUAL - This image will not be covered by Amazon Inspector due to the repository scan frequency configuration.
``SCAN_FREQUENCY_SCAN_ON_PUSH ``- This image will be scanned one time and will not new findings because of the scan frequency configuration.
EC2_INSTANCE_STOPPED - This EC2 instance is in a stopped state, therefore, Amazon Inspector will pause scanning. The existing findings will continue to exist until the instance is terminated. Once the instance is re-started, Inspector will automatically start scanning the instance again. Please note that you will not be charged for this instance while it’s in a stopped state.
PENDING_DISABLE - This resource is pending cleanup during disablement. The customer will not be billed while a resource is in the pending disable status.
NO INVENTORY - Amazon Inspector couldn’t find software application inventory to scan for vulnerabilities. This might be caused due to required Amazon Inspector associations being deleted or failing to run on your resource. Please verify the status of InspectorInventoryCollection-do-not-delete association in the SSM console for the resource. Additionally, you can verify the instance’s inventory in the SSM Fleet Manager console.
STALE_INVENTORY - Amazon Inspector wasn’t able to collect an updated software application inventory in the last 7 days. Please confirm the required Amazon Inspector associations still exist and you can still see an updated inventory in the SSM console.
EXCLUDED_BY_TAG - This resource was not scanned because it has been excluded by a tag.
UNSUPPORTED_RUNTIME - The function was not scanned because it has an unsupported runtime. To see a complete list of supported runtimes see: https://docs.aws.amazon.com/inspector/latest/user/supported.html.
``UNSUPPORTED_MEDIA_TYPE ``- The ECR image has an unsupported media type.
UNSUPPORTED_CONFIG_FILE - Reserved for future use.
DEEP_INSPECTION_PACKAGE_COLLECTION_LIMIT_EXCEEDED - The instance has exceeded the 5000 package limit for Amazon Inspector Deep inspection. To resume Deep inspection for this instance you can try to adjust the custom paths associated with the account.
DEEP_INSPECTION_DAILY_SSM_INVENTORY_LIMIT_EXCEEDED - The SSM agent couldn't send inventory to Amazon Inspector because the SSM quota for Inventory data collected per instance per day has already been reached for this instance.
DEEP_INSPECTION_COLLECTION_TIME_LIMIT_EXCEEDED - Amazon Inspector failed to extract the package inventory because the package collection time exceeding the maximum threshold of 15 minutes.
DEEP_INSPECTION_NO_INVENTORY The Amazon Inspector plugin hasn't yet been able to collect an inventory of packages for this instance. This is usually the result of a pending scan, however, if this status persists after 6 hours, use SSM to ensure that the required Amazon Inspector associations exist and are running for the instance.
statusCode (string) --
The status code of the scan.
scanType (string) --
The Amazon Inspector scan type covering the resource.
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. For subsequent calls, use the NextToken value returned from the previous request to continue listing results after the first page.
{'filters': {'criteria': {'vulnerablePackages': {'filePath': {'comparison': 'EQUALS '
'| '
'PREFIX '
'| '
'NOT_EQUALS',
'value': 'string'}}}}}
Lists the filters associated with your account.
See also: AWS API Documentation
Request Syntax
client.list_filters(
action='NONE'|'SUPPRESS',
arns=[
'string',
],
maxResults=123,
nextToken='string'
)
string
The action the filter applies to matched findings.
list
The Amazon resource number (ARN) of the filter.
(string) --
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.
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.
dict
Response Syntax
{
'filters': [
{
'action': 'NONE'|'SUPPRESS',
'arn': 'string',
'createdAt': datetime(2015, 1, 1),
'criteria': {
'awsAccountId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityFilePath': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceImageId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceSubnetId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceVpcId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageArchitecture': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageHash': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImagePushedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'ecrImageRegistry': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageRepositoryName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'epssScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'exploitAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingStatus': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'firstObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'fixAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'inspectorScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'lambdaFunctionExecutionRoleArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionLastModifiedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'lambdaFunctionLayers': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionRuntime': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lastObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'networkProtocol': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'portRange': [
{
'beginInclusive': 123,
'endInclusive': 123
},
],
'relatedVulnerabilities': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceTags': [
{
'comparison': 'EQUALS',
'key': 'string',
'value': 'string'
},
],
'resourceType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'severity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'title': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'updatedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'vendorSeverity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilityId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilitySource': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerablePackages': [
{
'architecture': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'epoch': {
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
'filePath': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'name': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'release': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLambdaLayerArn': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLayerHash': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'version': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
}
},
]
},
'description': 'string',
'name': 'string',
'ownerId': 'string',
'reason': 'string',
'tags': {
'string': 'string'
},
'updatedAt': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
filters (list) --
Contains details on the filters associated with your account.
(dict) --
Details about a filter.
action (string) --
The action that is to be applied to the findings that match the filter.
arn (string) --
The Amazon Resource Number (ARN) associated with this filter.
createdAt (datetime) --
The date and time this filter was created at.
criteria (dict) --
Details on the filter criteria associated with this filter.
awsAccountId (list) --
Details of the Amazon Web Services account IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
codeVulnerabilityDetectorName (list) --
The name of the detector used to identify a code vulnerability in a Lambda function used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
codeVulnerabilityDetectorTags (list) --
The detector type tag associated with the vulnerability used to filter findings. Detector tags group related vulnerabilities by common themes or tactics. For a list of available tags by programming language, see Java tags, or Python tags.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
codeVulnerabilityFilePath (list) --
The file path to the file in a Lambda function that contains a code vulnerability used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
componentId (list) --
Details of the component IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
componentType (list) --
Details of the component types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ec2InstanceImageId (list) --
Details of the Amazon EC2 instance image IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ec2InstanceSubnetId (list) --
Details of the Amazon EC2 instance subnet IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ec2InstanceVpcId (list) --
Details of the Amazon EC2 instance VPC IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageArchitecture (list) --
Details of the Amazon ECR image architecture types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageHash (list) --
Details of the Amazon ECR image hashes used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImagePushedAt (list) --
Details on the Amazon ECR image push date and time used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
ecrImageRegistry (list) --
Details on the Amazon ECR registry used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageRepositoryName (list) --
Details on the name of the Amazon ECR repository used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
ecrImageTags (list) --
The tags attached to the Amazon ECR container image.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
epssScore (list) --
The EPSS score used to filter findings.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
exploitAvailable (list) --
Filters the list of Amazon Web Services Lambda findings by the availability of exploits.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
findingArn (list) --
Details on the finding ARNs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
findingStatus (list) --
Details on the finding status types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
findingType (list) --
Details on the finding types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
firstObservedAt (list) --
Details on the date and time a finding was first seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
fixAvailable (list) --
Details on whether a fix is available through a version update. This value can be YES, NO, or PARTIAL. A PARTIAL fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
inspectorScore (list) --
The Amazon Inspector score to filter on.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
lambdaFunctionExecutionRoleArn (list) --
Filters the list of Amazon Web Services Lambda functions by execution role.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lambdaFunctionLastModifiedAt (list) --
Filters the list of Amazon Web Services Lambda functions by the date and time that a user last updated the configuration, in ISO 8601 format
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
lambdaFunctionLayers (list) --
Filters the list of Amazon Web Services Lambda functions by the function's layers. A Lambda function can have up to five layers.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lambdaFunctionName (list) --
Filters the list of Amazon Web Services Lambda functions by the name of the function.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lambdaFunctionRuntime (list) --
Filters the list of Amazon Web Services Lambda functions by the runtime environment for the Lambda function.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
lastObservedAt (list) --
Details on the date and time a finding was last seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
networkProtocol (list) --
Details on network protocol used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
portRange (list) --
Details on the port ranges used to filter findings.
(dict) --
An object that describes the details of a port range filter.
beginInclusive (integer) --
The port number the port range begins at.
endInclusive (integer) --
The port number the port range ends at.
relatedVulnerabilities (list) --
Details on the related vulnerabilities used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
resourceId (list) --
Details on the resource IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
resourceTags (list) --
Details on the resource tags used to filter findings.
(dict) --
An object that describes details of a map filter.
comparison (string) --
The operator to use when comparing values in the filter.
key (string) --
The tag key used in the filter.
value (string) --
The tag value used in the filter.
resourceType (list) --
Details on the resource types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
severity (list) --
Details on the severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
title (list) --
Details on the finding title used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
updatedAt (list) --
Details on the date and time a finding was last updated at used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
vendorSeverity (list) --
Details on the vendor severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
vulnerabilityId (list) --
Details on the vulnerability ID used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
vulnerabilitySource (list) --
Details on the vulnerability type used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
vulnerablePackages (list) --
Details on the vulnerable packages used to filter findings.
(dict) --
Contains information on the details of a package filter.
architecture (dict) --
An object that contains details on the package architecture type to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
epoch (dict) --
An object that contains details on the package epoch to filter on.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
filePath (dict) --
An object that contains details on the package file path to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
name (dict) --
An object that contains details on the name of the package to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
release (dict) --
An object that contains details on the package release to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
sourceLambdaLayerArn (dict) --
An object that describes the details of a string filter.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
sourceLayerHash (dict) --
An object that contains details on the source layer hash to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
version (dict) --
The package version to filter on.
comparison (string) --
The operator to use when comparing values in the filter.
value (string) --
The value to filter on.
description (string) --
A description of the filter.
name (string) --
The name of the filter.
ownerId (string) --
The Amazon Web Services account ID of the account that created the filter.
reason (string) --
The reason for the filter.
tags (dict) --
The tags attached to the filter.
(string) --
(string) --
updatedAt (datetime) --
The date and time the filter was last updated at.
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. For subsequent calls, use the NextToken value returned from the previous request to continue listing results after the first page.
{'filterCriteria': {'vulnerablePackages': {'filePath': {'comparison': 'EQUALS '
'| '
'PREFIX '
'| '
'NOT_EQUALS',
'value': 'string'}}}}
Response {'findings': {'packageVulnerabilityDetails': {'vulnerablePackages': {'packageManager': {'DOTNET_CORE'}}},
'resources': {'details': {'awsLambdaFunction': {'runtime': {'DOTNETCORE_3_1',
'DOTNET_6',
'DOTNET_7',
'PYTHON_3_11',
'RUBY_2_7',
'RUBY_3_2'}}}}}}
Lists findings for your environment.
See also: AWS API Documentation
Request Syntax
client.list_findings(
filterCriteria={
'awsAccountId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityFilePath': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceImageId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceSubnetId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceVpcId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageArchitecture': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageHash': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImagePushedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'ecrImageRegistry': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageRepositoryName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'epssScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'exploitAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingStatus': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'firstObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'fixAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'inspectorScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'lambdaFunctionExecutionRoleArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionLastModifiedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'lambdaFunctionLayers': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionRuntime': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lastObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'networkProtocol': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'portRange': [
{
'beginInclusive': 123,
'endInclusive': 123
},
],
'relatedVulnerabilities': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceTags': [
{
'comparison': 'EQUALS',
'key': 'string',
'value': 'string'
},
],
'resourceType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'severity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'title': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'updatedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'vendorSeverity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilityId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilitySource': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerablePackages': [
{
'architecture': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'epoch': {
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
'filePath': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'name': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'release': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLambdaLayerArn': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLayerHash': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'version': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
}
},
]
},
maxResults=123,
nextToken='string',
sortCriteria={
'field': 'AWS_ACCOUNT_ID'|'FINDING_TYPE'|'SEVERITY'|'FIRST_OBSERVED_AT'|'LAST_OBSERVED_AT'|'FINDING_STATUS'|'RESOURCE_TYPE'|'ECR_IMAGE_PUSHED_AT'|'ECR_IMAGE_REPOSITORY_NAME'|'ECR_IMAGE_REGISTRY'|'NETWORK_PROTOCOL'|'COMPONENT_TYPE'|'VULNERABILITY_ID'|'VULNERABILITY_SOURCE'|'INSPECTOR_SCORE'|'VENDOR_SEVERITY'|'EPSS_SCORE',
'sortOrder': 'ASC'|'DESC'
}
)
dict
Details on the filters to apply to your finding results.
awsAccountId (list) --
Details of the Amazon Web Services account IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorName (list) --
The name of the detector used to identify a code vulnerability in a Lambda function used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorTags (list) --
The detector type tag associated with the vulnerability used to filter findings. Detector tags group related vulnerabilities by common themes or tactics. For a list of available tags by programming language, see Java tags, or Python tags.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityFilePath (list) --
The file path to the file in a Lambda function that contains a code vulnerability used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentId (list) --
Details of the component IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentType (list) --
Details of the component types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceImageId (list) --
Details of the Amazon EC2 instance image IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceSubnetId (list) --
Details of the Amazon EC2 instance subnet IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceVpcId (list) --
Details of the Amazon EC2 instance VPC IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageArchitecture (list) --
Details of the Amazon ECR image architecture types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageHash (list) --
Details of the Amazon ECR image hashes used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImagePushedAt (list) --
Details on the Amazon ECR image push date and time used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
ecrImageRegistry (list) --
Details on the Amazon ECR registry used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageRepositoryName (list) --
Details on the name of the Amazon ECR repository used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageTags (list) --
The tags attached to the Amazon ECR container image.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epssScore (list) --
The EPSS score used to filter findings.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
exploitAvailable (list) --
Filters the list of Amazon Web Services Lambda findings by the availability of exploits.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingArn (list) --
Details on the finding ARNs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingStatus (list) --
Details on the finding status types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingType (list) --
Details on the finding types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
firstObservedAt (list) --
Details on the date and time a finding was first seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
fixAvailable (list) --
Details on whether a fix is available through a version update. This value can be YES, NO, or PARTIAL. A PARTIAL fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
inspectorScore (list) --
The Amazon Inspector score to filter on.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
lambdaFunctionExecutionRoleArn (list) --
Filters the list of Amazon Web Services Lambda functions by execution role.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionLastModifiedAt (list) --
Filters the list of Amazon Web Services Lambda functions by the date and time that a user last updated the configuration, in ISO 8601 format
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
lambdaFunctionLayers (list) --
Filters the list of Amazon Web Services Lambda functions by the function's layers. A Lambda function can have up to five layers.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionName (list) --
Filters the list of Amazon Web Services Lambda functions by the name of the function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionRuntime (list) --
Filters the list of Amazon Web Services Lambda functions by the runtime environment for the Lambda function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lastObservedAt (list) --
Details on the date and time a finding was last seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
networkProtocol (list) --
Details on network protocol used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
portRange (list) --
Details on the port ranges used to filter findings.
(dict) --
An object that describes the details of a port range filter.
beginInclusive (integer) --
The port number the port range begins at.
endInclusive (integer) --
The port number the port range ends at.
relatedVulnerabilities (list) --
Details on the related vulnerabilities used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceId (list) --
Details on the resource IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceTags (list) --
Details on the resource tags used to filter findings.
(dict) --
An object that describes details of a map filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
key (string) -- [REQUIRED]
The tag key used in the filter.
value (string) --
The tag value used in the filter.
resourceType (list) --
Details on the resource types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
severity (list) --
Details on the severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
title (list) --
Details on the finding title used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
updatedAt (list) --
Details on the date and time a finding was last updated at used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
vendorSeverity (list) --
Details on the vendor severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilityId (list) --
Details on the vulnerability ID used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilitySource (list) --
Details on the vulnerability type used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerablePackages (list) --
Details on the vulnerable packages used to filter findings.
(dict) --
Contains information on the details of a package filter.
architecture (dict) --
An object that contains details on the package architecture type to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epoch (dict) --
An object that contains details on the package epoch to filter on.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
filePath (dict) --
An object that contains details on the package file path to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
name (dict) --
An object that contains details on the name of the package to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
release (dict) --
An object that contains details on the package release to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLambdaLayerArn (dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLayerHash (dict) --
An object that contains details on the source layer hash to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
version (dict) --
The package version to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
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.
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.
dict
Details on the sort criteria to apply to your finding results.
field (string) -- [REQUIRED]
The finding detail field by which results are sorted.
sortOrder (string) -- [REQUIRED]
The order by which findings are sorted.
dict
Response Syntax
{
'findings': [
{
'awsAccountId': 'string',
'codeVulnerabilityDetails': {
'cwes': [
'string',
],
'detectorId': 'string',
'detectorName': 'string',
'detectorTags': [
'string',
],
'filePath': {
'endLine': 123,
'fileName': 'string',
'filePath': 'string',
'startLine': 123
},
'referenceUrls': [
'string',
],
'ruleId': 'string',
'sourceLambdaLayerArn': 'string'
},
'description': 'string',
'epss': {
'score': 123.0
},
'exploitAvailable': 'YES'|'NO',
'exploitabilityDetails': {
'lastKnownExploitAt': datetime(2015, 1, 1)
},
'findingArn': 'string',
'firstObservedAt': datetime(2015, 1, 1),
'fixAvailable': 'YES'|'NO'|'PARTIAL',
'inspectorScore': 123.0,
'inspectorScoreDetails': {
'adjustedCvss': {
'adjustments': [
{
'metric': 'string',
'reason': 'string'
},
],
'cvssSource': 'string',
'score': 123.0,
'scoreSource': 'string',
'scoringVector': 'string',
'version': 'string'
}
},
'lastObservedAt': datetime(2015, 1, 1),
'networkReachabilityDetails': {
'networkPath': {
'steps': [
{
'componentId': 'string',
'componentType': 'string'
},
]
},
'openPortRange': {
'begin': 123,
'end': 123
},
'protocol': 'TCP'|'UDP'
},
'packageVulnerabilityDetails': {
'cvss': [
{
'baseScore': 123.0,
'scoringVector': 'string',
'source': 'string',
'version': 'string'
},
],
'referenceUrls': [
'string',
],
'relatedVulnerabilities': [
'string',
],
'source': 'string',
'sourceUrl': 'string',
'vendorCreatedAt': datetime(2015, 1, 1),
'vendorSeverity': 'string',
'vendorUpdatedAt': datetime(2015, 1, 1),
'vulnerabilityId': 'string',
'vulnerablePackages': [
{
'arch': 'string',
'epoch': 123,
'filePath': 'string',
'fixedInVersion': 'string',
'name': 'string',
'packageManager': 'BUNDLER'|'CARGO'|'COMPOSER'|'NPM'|'NUGET'|'PIPENV'|'POETRY'|'YARN'|'GOBINARY'|'GOMOD'|'JAR'|'OS'|'PIP'|'PYTHONPKG'|'NODEPKG'|'POM'|'GEMSPEC'|'DOTNET_CORE',
'release': 'string',
'remediation': 'string',
'sourceLambdaLayerArn': 'string',
'sourceLayerHash': 'string',
'version': 'string'
},
]
},
'remediation': {
'recommendation': {
'Url': 'string',
'text': 'string'
}
},
'resources': [
{
'details': {
'awsEc2Instance': {
'iamInstanceProfileArn': 'string',
'imageId': 'string',
'ipV4Addresses': [
'string',
],
'ipV6Addresses': [
'string',
],
'keyName': 'string',
'launchedAt': datetime(2015, 1, 1),
'platform': 'string',
'subnetId': 'string',
'type': 'string',
'vpcId': 'string'
},
'awsEcrContainerImage': {
'architecture': 'string',
'author': 'string',
'imageHash': 'string',
'imageTags': [
'string',
],
'platform': 'string',
'pushedAt': datetime(2015, 1, 1),
'registry': 'string',
'repositoryName': 'string'
},
'awsLambdaFunction': {
'architectures': [
'X86_64'|'ARM64',
],
'codeSha256': 'string',
'executionRoleArn': 'string',
'functionName': 'string',
'lastModifiedAt': datetime(2015, 1, 1),
'layers': [
'string',
],
'packageType': 'IMAGE'|'ZIP',
'runtime': 'NODEJS'|'NODEJS_12_X'|'NODEJS_14_X'|'NODEJS_16_X'|'JAVA_8'|'JAVA_8_AL2'|'JAVA_11'|'PYTHON_3_7'|'PYTHON_3_8'|'PYTHON_3_9'|'UNSUPPORTED'|'NODEJS_18_X'|'GO_1_X'|'JAVA_17'|'PYTHON_3_10'|'PYTHON_3_11'|'DOTNETCORE_3_1'|'DOTNET_6'|'DOTNET_7'|'RUBY_2_7'|'RUBY_3_2',
'version': 'string',
'vpcConfig': {
'securityGroupIds': [
'string',
],
'subnetIds': [
'string',
],
'vpcId': 'string'
}
}
},
'id': 'string',
'partition': 'string',
'region': 'string',
'tags': {
'string': 'string'
},
'type': 'AWS_EC2_INSTANCE'|'AWS_ECR_CONTAINER_IMAGE'|'AWS_ECR_REPOSITORY'|'AWS_LAMBDA_FUNCTION'
},
],
'severity': 'INFORMATIONAL'|'LOW'|'MEDIUM'|'HIGH'|'CRITICAL'|'UNTRIAGED',
'status': 'ACTIVE'|'SUPPRESSED'|'CLOSED',
'title': 'string',
'type': 'NETWORK_REACHABILITY'|'PACKAGE_VULNERABILITY'|'CODE_VULNERABILITY',
'updatedAt': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
findings (list) --
Contains details on the findings in your environment.
(dict) --
Details about an Amazon Inspector finding.
awsAccountId (string) --
The Amazon Web Services account ID associated with the finding.
codeVulnerabilityDetails (dict) --
Details about the code vulnerability identified in a Lambda function used to filter findings.
cwes (list) --
The Common Weakness Enumeration (CWE) item associated with the detected vulnerability.
(string) --
detectorId (string) --
The ID for the Amazon CodeGuru detector associated with the finding. For more information on detectors see Amazon CodeGuru Detector Library.
detectorName (string) --
The name of the detector used to identify the code vulnerability. For more information on detectors see CodeGuru Detector Library.
detectorTags (list) --
The detector tag associated with the vulnerability. Detector tags group related vulnerabilities by common themes or tactics. For a list of available tags by programming language, see Java tags, or Python tags.
(string) --
filePath (dict) --
Contains information on where the code vulnerability is located in your code.
endLine (integer) --
The line number of the last line of code that a vulnerability was found in.
fileName (string) --
The name of the file the code vulnerability was found in.
filePath (string) --
The file path to the code that a vulnerability was found in.
startLine (integer) --
The line number of the first line of code that a vulnerability was found in.
referenceUrls (list) --
A URL containing supporting documentation about the code vulnerability detected.
(string) --
ruleId (string) --
The identifier for a rule that was used to detect the code vulnerability.
sourceLambdaLayerArn (string) --
The Amazon Resource Name (ARN) of the Lambda layer that the code vulnerability was detected in.
description (string) --
The description of the finding.
epss (dict) --
The finding's EPSS score.
score (float) --
The EPSS score.
exploitAvailable (string) --
If a finding discovered in your environment has an exploit available.
exploitabilityDetails (dict) --
The details of an exploit available for a finding discovered in your environment.
lastKnownExploitAt (datetime) --
The date and time of the last exploit associated with a finding discovered in your environment.
findingArn (string) --
The Amazon Resource Number (ARN) of the finding.
firstObservedAt (datetime) --
The date and time that the finding was first observed.
fixAvailable (string) --
Details on whether a fix is available through a version update. This value can be YES, NO, or PARTIAL. A PARTIAL fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.
inspectorScore (float) --
The Amazon Inspector score given to the finding.
inspectorScoreDetails (dict) --
An object that contains details of the Amazon Inspector score.
adjustedCvss (dict) --
An object that contains details about the CVSS score given to a finding.
adjustments (list) --
An object that contains details about adjustment Amazon Inspector made to the CVSS score.
(dict) --
Details on adjustments Amazon Inspector made to the CVSS score for a finding.
metric (string) --
The metric used to adjust the CVSS score.
reason (string) --
The reason the CVSS score has been adjustment.
cvssSource (string) --
The source of the CVSS data.
score (float) --
The CVSS score.
scoreSource (string) --
The source for the CVSS score.
scoringVector (string) --
The vector for the CVSS score.
version (string) --
The CVSS version used in scoring.
lastObservedAt (datetime) --
The date and time the finding was last observed. This timestamp for this field remains unchanged until a finding is updated.
networkReachabilityDetails (dict) --
An object that contains the details of a network reachability finding.
networkPath (dict) --
An object that contains details about a network path associated with a finding.
steps (list) --
The details on the steps in the network path.
(dict) --
Details about the step associated with a finding.
componentId (string) --
The component ID.
componentType (string) --
The component type.
openPortRange (dict) --
An object that contains details about the open port range associated with a finding.
begin (integer) --
The beginning port in a port range.
end (integer) --
The ending port in a port range.
protocol (string) --
The protocol associated with a finding.
packageVulnerabilityDetails (dict) --
An object that contains the details of a package vulnerability finding.
cvss (list) --
An object that contains details about the CVSS score of a finding.
(dict) --
The CVSS score for a finding.
baseScore (float) --
The base CVSS score used for the finding.
scoringVector (string) --
The vector string of the CVSS score.
source (string) --
The source of the CVSS score.
version (string) --
The version of CVSS used for the score.
referenceUrls (list) --
One or more URLs that contain details about this vulnerability type.
(string) --
relatedVulnerabilities (list) --
One or more vulnerabilities related to the one identified in this finding.
(string) --
source (string) --
The source of the vulnerability information.
sourceUrl (string) --
A URL to the source of the vulnerability information.
vendorCreatedAt (datetime) --
The date and time that this vulnerability was first added to the vendor's database.
vendorSeverity (string) --
The severity the vendor has given to this vulnerability type.
vendorUpdatedAt (datetime) --
The date and time the vendor last updated this vulnerability in their database.
vulnerabilityId (string) --
The ID given to this vulnerability.
vulnerablePackages (list) --
The packages impacted by this vulnerability.
(dict) --
Information on the vulnerable package identified by a finding.
arch (string) --
The architecture of the vulnerable package.
epoch (integer) --
The epoch of the vulnerable package.
filePath (string) --
The file path of the vulnerable package.
fixedInVersion (string) --
The version of the package that contains the vulnerability fix.
name (string) --
The name of the vulnerable package.
packageManager (string) --
The package manager of the vulnerable package.
release (string) --
The release of the vulnerable package.
remediation (string) --
The code to run in your environment to update packages with a fix available.
sourceLambdaLayerArn (string) --
The Amazon Resource Number (ARN) of the Amazon Web Services Lambda function affected by a finding.
sourceLayerHash (string) --
The source layer hash of the vulnerable package.
version (string) --
The version of the vulnerable package.
remediation (dict) --
An object that contains the details about how to remediate a finding.
recommendation (dict) --
An object that contains information about the recommended course of action to remediate the finding.
Url (string) --
The URL address to the CVE remediation recommendations.
text (string) --
The recommended course of action to remediate the finding.
resources (list) --
Contains information on the resources involved in a finding. The resource value determines the valid values for type in your request. For more information, see Finding types in the Amazon Inspector user guide.
(dict) --
Details about the resource involved in a finding.
details (dict) --
An object that contains details about the resource involved in a finding.
awsEc2Instance (dict) --
An object that contains details about the Amazon EC2 instance involved in the finding.
iamInstanceProfileArn (string) --
The IAM instance profile ARN of the Amazon EC2 instance.
imageId (string) --
The image ID of the Amazon EC2 instance.
ipV4Addresses (list) --
The IPv4 addresses of the Amazon EC2 instance.
(string) --
ipV6Addresses (list) --
The IPv6 addresses of the Amazon EC2 instance.
(string) --
keyName (string) --
The name of the key pair used to launch the Amazon EC2 instance.
launchedAt (datetime) --
The date and time the Amazon EC2 instance was launched at.
platform (string) --
The platform of the Amazon EC2 instance.
subnetId (string) --
The subnet ID of the Amazon EC2 instance.
type (string) --
The type of the Amazon EC2 instance.
vpcId (string) --
The VPC ID of the Amazon EC2 instance.
awsEcrContainerImage (dict) --
An object that contains details about the Amazon ECR container image involved in the finding.
architecture (string) --
The architecture of the Amazon ECR container image.
author (string) --
The image author of the Amazon ECR container image.
imageHash (string) --
The image hash of the Amazon ECR container image.
imageTags (list) --
The image tags attached to the Amazon ECR container image.
(string) --
platform (string) --
The platform of the Amazon ECR container image.
pushedAt (datetime) --
The date and time the Amazon ECR container image was pushed.
registry (string) --
The registry for the Amazon ECR container image.
repositoryName (string) --
The name of the repository the Amazon ECR container image resides in.
awsLambdaFunction (dict) --
A summary of the information about an Amazon Web Services Lambda function affected by a finding.
architectures (list) --
The instruction set architecture that the Amazon Web Services Lambda function supports. Architecture is a string array with one of the valid values. The default architecture value is x86_64.
(string) --
codeSha256 (string) --
The SHA256 hash of the Amazon Web Services Lambda function's deployment package.
executionRoleArn (string) --
The Amazon Web Services Lambda function's execution role.
functionName (string) --
The name of the Amazon Web Services Lambda function.
lastModifiedAt (datetime) --
The date and time that a user last updated the configuration, in ISO 8601 format
layers (list) --
The Amazon Web Services Lambda function's layers. A Lambda function can have up to five layers.
(string) --
packageType (string) --
The type of deployment package. Set to Image for container image and set Zip for .zip file archive.
runtime (string) --
The runtime environment for the Amazon Web Services Lambda function.
version (string) --
The version of the Amazon Web Services Lambda function.
vpcConfig (dict) --
The Amazon Web Services Lambda function's networking configuration.
securityGroupIds (list) --
The VPC security groups and subnets that are attached to an Amazon Web Services Lambda function. For more information, see VPC Settings.
(string) --
subnetIds (list) --
A list of VPC subnet IDs.
(string) --
vpcId (string) --
The ID of the VPC.
id (string) --
The ID of the resource.
partition (string) --
The partition of the resource.
region (string) --
The Amazon Web Services Region the impacted resource is located in.
tags (dict) --
The tags attached to the resource.
(string) --
(string) --
type (string) --
The type of resource.
severity (string) --
The severity of the finding. UNTRIAGED applies to PACKAGE_VULNERABILITY type findings that the vendor has not assigned a severity yet. For more information, see Severity levels for findings in the Amazon Inspector user guide.
status (string) --
The status of the finding.
title (string) --
The title of the finding.
type (string) --
The type of the finding. The type value determines the valid values for resource in your request. For more information, see Finding types in the Amazon Inspector user guide.
updatedAt (datetime) --
The date and time the finding was last updated at.
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. For subsequent calls, use the NextToken value returned from the previous request to continue listing results after the first page.
{'filterCriteria': {'vulnerablePackages': {'filePath': {'comparison': 'EQUALS '
'| '
'PREFIX '
'| '
'NOT_EQUALS',
'value': 'string'}}}}
Specifies the action that is to be applied to the findings that match the filter.
See also: AWS API Documentation
Request Syntax
client.update_filter(
action='NONE'|'SUPPRESS',
description='string',
filterArn='string',
filterCriteria={
'awsAccountId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityDetectorTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'codeVulnerabilityFilePath': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'componentType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceImageId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceSubnetId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ec2InstanceVpcId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageArchitecture': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageHash': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImagePushedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'ecrImageRegistry': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageRepositoryName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'ecrImageTags': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'epssScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'exploitAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingStatus': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'findingType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'firstObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'fixAvailable': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'inspectorScore': [
{
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
],
'lambdaFunctionExecutionRoleArn': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionLastModifiedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'lambdaFunctionLayers': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionName': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lambdaFunctionRuntime': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'lastObservedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'networkProtocol': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'portRange': [
{
'beginInclusive': 123,
'endInclusive': 123
},
],
'relatedVulnerabilities': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'resourceTags': [
{
'comparison': 'EQUALS',
'key': 'string',
'value': 'string'
},
],
'resourceType': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'severity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'title': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'updatedAt': [
{
'endInclusive': datetime(2015, 1, 1),
'startInclusive': datetime(2015, 1, 1)
},
],
'vendorSeverity': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilityId': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerabilitySource': [
{
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
],
'vulnerablePackages': [
{
'architecture': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'epoch': {
'lowerInclusive': 123.0,
'upperInclusive': 123.0
},
'filePath': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'name': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'release': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLambdaLayerArn': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'sourceLayerHash': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
},
'version': {
'comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS',
'value': 'string'
}
},
]
},
name='string',
reason='string'
)
string
Specifies the action that is to be applied to the findings that match the filter.
string
A description of the filter.
string
[REQUIRED]
The Amazon Resource Number (ARN) of the filter to update.
dict
Defines the criteria to be update in the filter.
awsAccountId (list) --
Details of the Amazon Web Services account IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorName (list) --
The name of the detector used to identify a code vulnerability in a Lambda function used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityDetectorTags (list) --
The detector type tag associated with the vulnerability used to filter findings. Detector tags group related vulnerabilities by common themes or tactics. For a list of available tags by programming language, see Java tags, or Python tags.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
codeVulnerabilityFilePath (list) --
The file path to the file in a Lambda function that contains a code vulnerability used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentId (list) --
Details of the component IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
componentType (list) --
Details of the component types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceImageId (list) --
Details of the Amazon EC2 instance image IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceSubnetId (list) --
Details of the Amazon EC2 instance subnet IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ec2InstanceVpcId (list) --
Details of the Amazon EC2 instance VPC IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageArchitecture (list) --
Details of the Amazon ECR image architecture types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageHash (list) --
Details of the Amazon ECR image hashes used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImagePushedAt (list) --
Details on the Amazon ECR image push date and time used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
ecrImageRegistry (list) --
Details on the Amazon ECR registry used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageRepositoryName (list) --
Details on the name of the Amazon ECR repository used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
ecrImageTags (list) --
The tags attached to the Amazon ECR container image.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epssScore (list) --
The EPSS score used to filter findings.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
exploitAvailable (list) --
Filters the list of Amazon Web Services Lambda findings by the availability of exploits.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingArn (list) --
Details on the finding ARNs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingStatus (list) --
Details on the finding status types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
findingType (list) --
Details on the finding types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
firstObservedAt (list) --
Details on the date and time a finding was first seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
fixAvailable (list) --
Details on whether a fix is available through a version update. This value can be YES, NO, or PARTIAL. A PARTIAL fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
inspectorScore (list) --
The Amazon Inspector score to filter on.
(dict) --
An object that describes the details of a number filter.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
lambdaFunctionExecutionRoleArn (list) --
Filters the list of Amazon Web Services Lambda functions by execution role.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionLastModifiedAt (list) --
Filters the list of Amazon Web Services Lambda functions by the date and time that a user last updated the configuration, in ISO 8601 format
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
lambdaFunctionLayers (list) --
Filters the list of Amazon Web Services Lambda functions by the function's layers. A Lambda function can have up to five layers.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionName (list) --
Filters the list of Amazon Web Services Lambda functions by the name of the function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lambdaFunctionRuntime (list) --
Filters the list of Amazon Web Services Lambda functions by the runtime environment for the Lambda function.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
lastObservedAt (list) --
Details on the date and time a finding was last seen used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
networkProtocol (list) --
Details on network protocol used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
portRange (list) --
Details on the port ranges used to filter findings.
(dict) --
An object that describes the details of a port range filter.
beginInclusive (integer) --
The port number the port range begins at.
endInclusive (integer) --
The port number the port range ends at.
relatedVulnerabilities (list) --
Details on the related vulnerabilities used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceId (list) --
Details on the resource IDs used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
resourceTags (list) --
Details on the resource tags used to filter findings.
(dict) --
An object that describes details of a map filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
key (string) -- [REQUIRED]
The tag key used in the filter.
value (string) --
The tag value used in the filter.
resourceType (list) --
Details on the resource types used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
severity (list) --
Details on the severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
title (list) --
Details on the finding title used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
updatedAt (list) --
Details on the date and time a finding was last updated at used to filter findings.
(dict) --
Contains details on the time range used to filter findings.
endInclusive (datetime) --
A timestamp representing the end of the time period filtered on.
startInclusive (datetime) --
A timestamp representing the start of the time period filtered on.
vendorSeverity (list) --
Details on the vendor severity used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilityId (list) --
Details on the vulnerability ID used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerabilitySource (list) --
Details on the vulnerability type used to filter findings.
(dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
vulnerablePackages (list) --
Details on the vulnerable packages used to filter findings.
(dict) --
Contains information on the details of a package filter.
architecture (dict) --
An object that contains details on the package architecture type to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
epoch (dict) --
An object that contains details on the package epoch to filter on.
lowerInclusive (float) --
The lowest number to be included in the filter.
upperInclusive (float) --
The highest number to be included in the filter.
filePath (dict) --
An object that contains details on the package file path to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
name (dict) --
An object that contains details on the name of the package to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
release (dict) --
An object that contains details on the package release to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLambdaLayerArn (dict) --
An object that describes the details of a string filter.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
sourceLayerHash (dict) --
An object that contains details on the source layer hash to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
version (dict) --
The package version to filter on.
comparison (string) -- [REQUIRED]
The operator to use when comparing values in the filter.
value (string) -- [REQUIRED]
The value to filter on.
string
The name of the filter.
string
The reason the filter was updated.
dict
Response Syntax
{
'arn': 'string'
}
Response Structure
(dict) --
arn (string) --
The Amazon Resource Number (ARN) of the successfully updated filter.