[ aws . inspector2 ]

list-findings

Description

Lists findings for your environment.

See also: AWS API Documentation

list-findings is a paginated operation. Multiple API calls may be issued in order to retrieve the entire data set of results. You can disable pagination by providing the --no-paginate argument. When using --output text and the --query argument on a paginated response, the --query argument must extract data from the results of the following query expressions: findings

Synopsis

  list-findings
[--filter-criteria <value>]
[--sort-criteria <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Options

--filter-criteria (structure)

Details on the filters to apply to your finding results.

findingArn -> (list)

Details on the finding ARNs used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

awsAccountId -> (list)

Details of the Amazon Web Services account IDs used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

findingType -> (list)

Details on the finding types used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

severity -> (list)

Details on the severity used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

firstObservedAt -> (list)

Details on the date and time a finding was first seen used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

Contains details on the time range used to filter findings.

startInclusive -> (timestamp)

A timestamp representing the start of the time period filtered on.

endInclusive -> (timestamp)

A timestamp representing the end of the time period filtered on.

lastObservedAt -> (list)

Details on the date and time a finding was last seen used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

Contains details on the time range used to filter findings.

startInclusive -> (timestamp)

A timestamp representing the start of the time period filtered on.

endInclusive -> (timestamp)

A timestamp representing the end of the time period filtered on.

updatedAt -> (list)

Details on the date and time a finding was last updated at used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

Contains details on the time range used to filter findings.

startInclusive -> (timestamp)

A timestamp representing the start of the time period filtered on.

endInclusive -> (timestamp)

A timestamp representing the end of the time period filtered on.

findingStatus -> (list)

Details on the finding status types used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

title -> (list)

Details on the finding title used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

inspectorScore -> (list)

The Amazon Inspector score to filter on.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a number filter.

upperInclusive -> (double)

The highest number to be included in the filter.

lowerInclusive -> (double)

The lowest number to be included in the filter.

resourceType -> (list)

Details on the resource types used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

resourceId -> (list)

Details on the resource IDs used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

resourceTags -> (list)

Details on the resource tags used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes details of a map filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS

key -> (string) [required]

The tag key used in the filter.

Constraints:

  • min: 1
  • max: 128

value -> (string)

The tag value used in the filter.

Constraints:

  • min: 0
  • max: 256

ec2InstanceImageId -> (list)

Details of the Amazon EC2 instance image IDs used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ec2InstanceVpcId -> (list)

Details of the Amazon EC2 instance VPC IDs used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ec2InstanceSubnetId -> (list)

Details of the Amazon EC2 instance subnet IDs used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ecrImagePushedAt -> (list)

Details on the Amazon ECR image push date and time used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

Contains details on the time range used to filter findings.

startInclusive -> (timestamp)

A timestamp representing the start of the time period filtered on.

endInclusive -> (timestamp)

A timestamp representing the end of the time period filtered on.

ecrImageArchitecture -> (list)

Details of the Amazon ECR image architecture types used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ecrImageRegistry -> (list)

Details on the Amazon ECR registry used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ecrImageRepositoryName -> (list)

Details on the name of the Amazon ECR repository used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ecrImageTags -> (list)

The tags attached to the Amazon ECR container image.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ecrImageHash -> (list)

Details of the Amazon ECR image hashes used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

ecrImageLastInUseAt -> (list)

Filter criteria indicating when an Amazon ECR image was last used in an Amazon ECS cluster task or Amazon EKS cluster pod.

Constraints:

  • min: 1
  • max: 10

(structure)

Contains details on the time range used to filter findings.

startInclusive -> (timestamp)

A timestamp representing the start of the time period filtered on.

endInclusive -> (timestamp)

A timestamp representing the end of the time period filtered on.

ecrImageInUseCount -> (list)

Filter criteria indicating when details for an Amazon ECR image include when an Amazon ECR image is in use.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a number filter.

upperInclusive -> (double)

The highest number to be included in the filter.

lowerInclusive -> (double)

The lowest number to be included in the filter.

portRange -> (list)

Details on the port ranges used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a port range filter.

beginInclusive -> (integer)

The port number the port range begins at.

Constraints:

  • min: 0
  • max: 65535

endInclusive -> (integer)

The port number the port range ends at.

Constraints:

  • min: 0
  • max: 65535

networkProtocol -> (list)

Details on network protocol used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

componentId -> (list)

Details of the component IDs used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

componentType -> (list)

Details of the component types used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

vulnerabilityId -> (list)

Details on the vulnerability ID used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

vulnerabilitySource -> (list)

Details on the vulnerability type used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

vendorSeverity -> (list)

Details on the vendor severity used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

vulnerablePackages -> (list)

Details on the vulnerable packages used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

Contains information on the details of a package filter.

name -> (structure)

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.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

version -> (structure)

The package version to filter on.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

epoch -> (structure)

An object that contains details on the package epoch to filter on.

upperInclusive -> (double)

The highest number to be included in the filter.

lowerInclusive -> (double)

The lowest number to be included in the filter.

release -> (structure)

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.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

architecture -> (structure)

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.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

sourceLayerHash -> (structure)

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.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

sourceLambdaLayerArn -> (structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

filePath -> (structure)

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.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

relatedVulnerabilities -> (list)

Details on the related vulnerabilities used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

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.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

lambdaFunctionName -> (list)

Filters the list of Amazon Web Services Lambda functions by the name of the function.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

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.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

lambdaFunctionRuntime -> (list)

Filters the list of Amazon Web Services Lambda functions by the runtime environment for the Lambda function.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

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

Constraints:

  • min: 1
  • max: 10

(structure)

Contains details on the time range used to filter findings.

startInclusive -> (timestamp)

A timestamp representing the start of the time period filtered on.

endInclusive -> (timestamp)

A timestamp representing the end of the time period filtered on.

lambdaFunctionExecutionRoleArn -> (list)

Filters the list of Amazon Web Services Lambda functions by execution role.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

exploitAvailable -> (list)

Filters the list of Amazon Web Services Lambda findings by the availability of exploits.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

codeVulnerabilityDetectorName -> (list)

The name of the detector used to identify a code vulnerability in a Lambda function used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

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 .

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

codeVulnerabilityFilePath -> (list)

The file path to the file in a Lambda function that contains a code vulnerability used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

epssScore -> (list)

The EPSS score used to filter findings.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a number filter.

upperInclusive -> (double)

The highest number to be included in the filter.

lowerInclusive -> (double)

The lowest number to be included in the filter.

codeRepositoryProjectName -> (list)

Filter criteria for findings based on the project name in a code repository.

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

codeRepositoryProviderType -> (list)

Filter criteria for findings based on the repository provider type (such as GitHub, GitLab, etc.).

Constraints:

  • min: 1
  • max: 10

(structure)

An object that describes the details of a string filter.

comparison -> (string) [required]

The operator to use when comparing values in the filter.

Possible values:

  • EQUALS
  • PREFIX
  • NOT_EQUALS

value -> (string) [required]

The value to filter on.

Constraints:

  • min: 1
  • max: 1024

JSON Syntax:

{
  "findingArn": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "awsAccountId": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "findingType": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "severity": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "firstObservedAt": [
    {
      "startInclusive": timestamp,
      "endInclusive": timestamp
    }
    ...
  ],
  "lastObservedAt": [
    {
      "startInclusive": timestamp,
      "endInclusive": timestamp
    }
    ...
  ],
  "updatedAt": [
    {
      "startInclusive": timestamp,
      "endInclusive": timestamp
    }
    ...
  ],
  "findingStatus": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "title": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "inspectorScore": [
    {
      "upperInclusive": double,
      "lowerInclusive": double
    }
    ...
  ],
  "resourceType": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "resourceId": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "resourceTags": [
    {
      "comparison": "EQUALS",
      "key": "string",
      "value": "string"
    }
    ...
  ],
  "ec2InstanceImageId": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ec2InstanceVpcId": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ec2InstanceSubnetId": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ecrImagePushedAt": [
    {
      "startInclusive": timestamp,
      "endInclusive": timestamp
    }
    ...
  ],
  "ecrImageArchitecture": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ecrImageRegistry": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ecrImageRepositoryName": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ecrImageTags": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ecrImageHash": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "ecrImageLastInUseAt": [
    {
      "startInclusive": timestamp,
      "endInclusive": timestamp
    }
    ...
  ],
  "ecrImageInUseCount": [
    {
      "upperInclusive": double,
      "lowerInclusive": double
    }
    ...
  ],
  "portRange": [
    {
      "beginInclusive": integer,
      "endInclusive": integer
    }
    ...
  ],
  "networkProtocol": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "componentId": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "componentType": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "vulnerabilityId": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "vulnerabilitySource": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "vendorSeverity": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "vulnerablePackages": [
    {
      "name": {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      },
      "version": {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      },
      "epoch": {
        "upperInclusive": double,
        "lowerInclusive": double
      },
      "release": {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      },
      "architecture": {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      },
      "sourceLayerHash": {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      },
      "sourceLambdaLayerArn": {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      },
      "filePath": {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
    }
    ...
  ],
  "relatedVulnerabilities": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "fixAvailable": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "lambdaFunctionName": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "lambdaFunctionLayers": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "lambdaFunctionRuntime": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "lambdaFunctionLastModifiedAt": [
    {
      "startInclusive": timestamp,
      "endInclusive": timestamp
    }
    ...
  ],
  "lambdaFunctionExecutionRoleArn": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "exploitAvailable": [
    {
      "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"
    }
    ...
  ],
  "epssScore": [
    {
      "upperInclusive": double,
      "lowerInclusive": double
    }
    ...
  ],
  "codeRepositoryProjectName": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ],
  "codeRepositoryProviderType": [
    {
      "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
      "value": "string"
    }
    ...
  ]
}

--sort-criteria (structure)

Details on the sort criteria to apply to your finding results.

field -> (string) [required]

The finding detail field by which results are sorted.

Possible values:

  • 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 -> (string) [required]

The order by which findings are sorted.

Possible values:

  • ASC
  • DESC

Shorthand Syntax:

field=string,sortOrder=string

JSON Syntax:

{
  "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"
}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--starting-token (string)

A token to specify where to start paginating. This is the NextToken from a previously truncated response.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--page-size (integer)

The size of each page to get in the AWS service call. This does not affect the number of items returned in the command’s output. Setting a smaller page size results in more calls to the AWS service, retrieving fewer items in each call. This can help prevent the AWS service calls from timing out.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--max-items (integer)

The total number of items to return in the command’s output. If the total number of items available is more than the value specified, a NextToken is provided in the command’s output. To resume pagination, provide the NextToken value in the starting-token argument of a subsequent command. Do not use the NextToken response element directly outside of the AWS CLI.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and there are no backwards compatibility guarantees in the JSON skeleton generated.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command’s default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.

--output (string)

The formatting style for command output.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on
  • off
  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

--cli-binary-format (string)

The formatting style to be used for binary blobs. The default format is base64. The base64 format expects binary blobs to be provided as a base64 encoded string. The raw-in-base64-out format preserves compatibility with AWS CLI V1 behavior and binary values must be passed literally. When providing contents from a file that map to a binary blob fileb:// will always be treated as binary and use the file contents directly regardless of the cli-binary-format setting. When using file:// the file contents will need to properly formatted for the configured cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Disable cli pager for output.

--cli-auto-prompt (boolean)

Automatically prompt for CLI input parameters.

--no-cli-auto-prompt (boolean)

Disable automatically prompt for CLI input parameters.

Output

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.

Constraints:

  • min: 0
  • max: 1000000

findings -> (list)

Contains details on the findings in your environment.

Constraints:

  • min: 0
  • max: 25

(structure)

Details about an Amazon Inspector finding.

findingArn -> (string) [required]

The Amazon Resource Number (ARN) of the finding.

Constraints:

  • min: 1
  • max: 100
  • pattern: arn:(aws[a-zA-Z-]*)?:inspector2:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:finding/[a-f0-9]{32}

awsAccountId -> (string) [required]

The Amazon Web Services account ID associated with the finding.

Constraints:

  • min: 12
  • max: 12
  • pattern: \d{12}

type -> (string) [required]

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.

Possible values:

  • NETWORK_REACHABILITY
  • PACKAGE_VULNERABILITY
  • CODE_VULNERABILITY

description -> (string) [required]

The description of the finding.

Constraints:

  • min: 1
  • max: 1024

title -> (string)

The title of the finding.

Constraints:

  • min: 1
  • max: 1024

remediation -> (structure) [required]

An object that contains the details about how to remediate a finding.

recommendation -> (structure)

An object that contains information about the recommended course of action to remediate the finding.

text -> (string)

The recommended course of action to remediate the finding.

Constraints:

  • min: 1

Url -> (string)

The URL address to the CVE remediation recommendations.

Constraints:

  • min: 1

severity -> (string) [required]

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.

Possible values:

  • INFORMATIONAL
  • LOW
  • MEDIUM
  • HIGH
  • CRITICAL
  • UNTRIAGED

firstObservedAt -> (timestamp) [required]

The date and time that the finding was first observed.

lastObservedAt -> (timestamp) [required]

The date and time the finding was last observed. This timestamp for this field remains unchanged until a finding is updated.

updatedAt -> (timestamp)

The date and time the finding was last updated at.

status -> (string) [required]

The status of the finding.

Possible values:

  • ACTIVE
  • SUPPRESSED
  • CLOSED

resources -> (list) [required]

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.

Constraints:

  • min: 1
  • max: 10

(structure)

Details about the resource involved in a finding.

type -> (string) [required]

The type of resource.

Possible values:

  • AWS_EC2_INSTANCE
  • AWS_ECR_CONTAINER_IMAGE
  • AWS_ECR_REPOSITORY
  • AWS_LAMBDA_FUNCTION
  • CODE_REPOSITORY

id -> (string) [required]

The ID of the resource.

Constraints:

  • min: 1

partition -> (string)

The partition of the resource.

Constraints:

  • min: 1

region -> (string)

The Amazon Web Services Region the impacted resource is located in.

Constraints:

  • min: 1

tags -> (map)

The tags attached to the resource.

key -> (string)

Constraints:

  • min: 1
  • max: 128

value -> (string)

Constraints:

  • min: 0
  • max: 256

details -> (structure)

An object that contains details about the resource involved in a finding.

awsEc2Instance -> (structure)

An object that contains details about the Amazon EC2 instance involved in the finding.

type -> (string)

The type of the Amazon EC2 instance.

Constraints:

  • min: 1

imageId -> (string)

The image ID of the Amazon EC2 instance.

Constraints:

  • min: 1

ipV4Addresses -> (list)

The IPv4 addresses of the Amazon EC2 instance.

(string)

Constraints:

  • min: 7
  • max: 15
  • pattern: (([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])

ipV6Addresses -> (list)

The IPv6 addresses of the Amazon EC2 instance.

(string)

Constraints:

  • min: 1
  • max: 47

keyName -> (string)

The name of the key pair used to launch the Amazon EC2 instance.

Constraints:

  • min: 1

iamInstanceProfileArn -> (string)

The IAM instance profile ARN of the Amazon EC2 instance.

Constraints:

  • min: 1

vpcId -> (string)

The VPC ID of the Amazon EC2 instance.

Constraints:

  • min: 1

subnetId -> (string)

The subnet ID of the Amazon EC2 instance.

Constraints:

  • min: 1

launchedAt -> (timestamp)

The date and time the Amazon EC2 instance was launched at.

platform -> (string)

The platform of the Amazon EC2 instance.

Constraints:

  • min: 1
  • max: 1024

awsEcrContainerImage -> (structure)

An object that contains details about the Amazon ECR container image involved in the finding.

repositoryName -> (string) [required]

The name of the repository the Amazon ECR container image resides in.

Constraints:

  • min: 1

imageTags -> (list)

The image tags attached to the Amazon ECR container image.

(string)

Constraints:

  • min: 1

pushedAt -> (timestamp)

The date and time the Amazon ECR container image was pushed.

author -> (string)

The image author of the Amazon ECR container image.

architecture -> (string)

The architecture of the Amazon ECR container image.

Constraints:

  • min: 1

imageHash -> (string) [required]

The image hash of the Amazon ECR container image.

Constraints:

  • min: 71
  • max: 71
  • pattern: sha256:[a-z0-9]{64}

registry -> (string) [required]

The registry for the Amazon ECR container image.

Constraints:

  • min: 1

platform -> (string)

The platform of the Amazon ECR container image.

Constraints:

  • min: 1
  • max: 1024

lastInUseAt -> (timestamp)

The last time an Amazon ECR image was used in an Amazon ECS task or Amazon EKS pod.

inUseCount -> (long)

The number of Amazon ECS tasks or Amazon EKS pods where the Amazon ECR container image is in use.

awsLambdaFunction -> (structure)

A summary of the information about an Amazon Web Services Lambda function affected by a finding.

functionName -> (string) [required]

The name of the Amazon Web Services Lambda function.

Constraints:

  • pattern: [a-zA-Z0-9-_\.]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

runtime -> (string) [required]

The runtime environment for the Amazon Web Services Lambda function.

Possible values:

  • 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

codeSha256 -> (string) [required]

The SHA256 hash of the Amazon Web Services Lambda function’s deployment package.

Constraints:

  • min: 1

version -> (string) [required]

The version of the Amazon Web Services Lambda function.

Constraints:

  • pattern: \$LATEST|[0-9]+

executionRoleArn -> (string) [required]

The Amazon Web Services Lambda function’s execution role.

Constraints:

  • pattern: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

layers -> (list)

The Amazon Web Services Lambda function’s layers . A Lambda function can have up to five layers.

Constraints:

  • min: 1
  • max: 5

(string)

Constraints:

  • pattern: arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+

vpcConfig -> (structure)

The Amazon Web Services Lambda function’s networking configuration.

subnetIds -> (list)

A list of VPC subnet IDs.

Constraints:

  • min: 0
  • max: 16

(string)

Constraints:

  • pattern: subnet-([a-z0-9]{8}|[a-z0-9]{17}|\*)

securityGroupIds -> (list)

The VPC security groups and subnets that are attached to an Amazon Web Services Lambda function. For more information, see VPC Settings .

Constraints:

  • min: 0
  • max: 5

(string)

Constraints:

  • pattern: sg-([a-z0-9]{8}|[a-z0-9]{17}|\*)

vpcId -> (string)

The ID of the VPC.

Constraints:

  • pattern: vpc-([a-z0-9]{8}|[a-z0-9]{17}|\*)

packageType -> (string)

The type of deployment package. Set to Image for container image and set Zip for .zip file archive.

Possible values:

  • IMAGE
  • ZIP

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 .

Constraints:

  • min: 1
  • max: 1

(string)

Possible values:

  • X86_64
  • ARM64

lastModifiedAt -> (timestamp)

The date and time that a user last updated the configuration, in ISO 8601 format

codeRepository -> (structure)

Contains details about a code repository resource associated with a finding.

projectName -> (string)

The name of the project in the code repository.

Constraints:

  • min: 1
  • max: 512

integrationArn -> (string)

The Amazon Resource Name (ARN) of the code security integration associated with the repository.

Constraints:

  • pattern: arn:(aws[a-zA-Z-]*)?:inspector2:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:codesecurity-integration\/[a-f0-9-]{36}

providerType -> (string)

The type of repository provider (such as GitHub, GitLab, etc.).

Possible values:

  • GITHUB
  • GITLAB_SELF_MANAGED

inspectorScore -> (double)

The Amazon Inspector score given to the finding.

inspectorScoreDetails -> (structure)

An object that contains details of the Amazon Inspector score.

adjustedCvss -> (structure)

An object that contains details about the CVSS score given to a finding.

scoreSource -> (string) [required]

The source for the CVSS score.

Constraints:

  • min: 1

cvssSource -> (string)

The source of the CVSS data.

Constraints:

  • min: 1

version -> (string) [required]

The CVSS version used in scoring.

Constraints:

  • min: 1

score -> (double) [required]

The CVSS score.

scoringVector -> (string) [required]

The vector for the CVSS score.

Constraints:

  • min: 1

adjustments -> (list)

An object that contains details about adjustment Amazon Inspector made to the CVSS score.

(structure)

Details on adjustments Amazon Inspector made to the CVSS score for a finding.

metric -> (string) [required]

The metric used to adjust the CVSS score.

Constraints:

  • min: 1

reason -> (string) [required]

The reason the CVSS score has been adjustment.

Constraints:

  • min: 1

networkReachabilityDetails -> (structure)

An object that contains the details of a network reachability finding.

openPortRange -> (structure) [required]

An object that contains details about the open port range associated with a finding.

begin -> (integer) [required]

The beginning port in a port range.

Constraints:

  • min: 0
  • max: 65535

end -> (integer) [required]

The ending port in a port range.

Constraints:

  • min: 0
  • max: 65535

protocol -> (string) [required]

The protocol associated with a finding.

Possible values:

  • TCP
  • UDP

networkPath -> (structure) [required]

An object that contains details about a network path associated with a finding.

steps -> (list)

The details on the steps in the network path.

Constraints:

  • min: 1
  • max: 30

(structure)

Details about the step associated with a finding.

componentId -> (string) [required]

The component ID.

componentType -> (string) [required]

The component type.

componentArn -> (string)

The component ARN. The ARN can be null and is not displayed in the Amazon Web Services console.

packageVulnerabilityDetails -> (structure)

An object that contains the details of a package vulnerability finding.

vulnerabilityId -> (string) [required]

The ID given to this vulnerability.

Constraints:

  • min: 1
  • max: 128

vulnerablePackages -> (list)

The packages impacted by this vulnerability.

(structure)

Information on the vulnerable package identified by a finding.

name -> (string) [required]

The name of the vulnerable package.

Constraints:

  • min: 1
  • max: 1024

version -> (string) [required]

The version of the vulnerable package.

Constraints:

  • min: 1
  • max: 1024

sourceLayerHash -> (string)

The source layer hash of the vulnerable package.

Constraints:

  • min: 71
  • max: 71
  • pattern: sha256:[a-z0-9]{64}

epoch -> (integer)

The epoch of the vulnerable package.

release -> (string)

The release of the vulnerable package.

Constraints:

  • min: 1
  • max: 1024

arch -> (string)

The architecture of the vulnerable package.

Constraints:

  • min: 1
  • max: 64

packageManager -> (string)

The package manager of the vulnerable package.

Possible values:

  • BUNDLER
  • CARGO
  • COMPOSER
  • NPM
  • NUGET
  • PIPENV
  • POETRY
  • YARN
  • GOBINARY
  • GOMOD
  • JAR
  • OS
  • PIP
  • PYTHONPKG
  • NODEPKG
  • POM
  • GEMSPEC
  • DOTNET_CORE

filePath -> (string)

The file path of the vulnerable package.

Constraints:

  • min: 1
  • max: 1024

fixedInVersion -> (string)

The version of the package that contains the vulnerability fix.

Constraints:

  • min: 1
  • max: 1024

remediation -> (string)

The code to run in your environment to update packages with a fix available.

Constraints:

  • min: 1
  • max: 1024

sourceLambdaLayerArn -> (string)

The Amazon Resource Number (ARN) of the Amazon Web Services Lambda function affected by a finding.

Constraints:

  • pattern: arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+

source -> (string) [required]

The source of the vulnerability information.

Constraints:

  • min: 1

cvss -> (list)

An object that contains details about the CVSS score of a finding.

(structure)

The CVSS score for a finding.

baseScore -> (double) [required]

The base CVSS score used for the finding.

scoringVector -> (string) [required]

The vector string of the CVSS score.

Constraints:

  • min: 1

version -> (string) [required]

The version of CVSS used for the score.

Constraints:

  • min: 1

source -> (string) [required]

The source of the CVSS score.

Constraints:

  • min: 1

relatedVulnerabilities -> (list)

One or more vulnerabilities related to the one identified in this finding.

(string)

Constraints:

  • min: 1
  • max: 128

sourceUrl -> (string)

A URL to the source of the vulnerability information.

Constraints:

  • min: 1

vendorSeverity -> (string)

The severity the vendor has given to this vulnerability type.

Constraints:

  • min: 1

vendorCreatedAt -> (timestamp)

The date and time that this vulnerability was first added to the vendor’s database.

vendorUpdatedAt -> (timestamp)

The date and time the vendor last updated this vulnerability in their database.

referenceUrls -> (list)

One or more URLs that contain details about this vulnerability type.

(string)

Constraints:

  • min: 1

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.

Possible values:

  • YES
  • NO
  • PARTIAL

exploitAvailable -> (string)

If a finding discovered in your environment has an exploit available.

Possible values:

  • YES
  • NO

exploitabilityDetails -> (structure)

The details of an exploit available for a finding discovered in your environment.

lastKnownExploitAt -> (timestamp)

The date and time of the last exploit associated with a finding discovered in your environment.

codeVulnerabilityDetails -> (structure)

Details about the code vulnerability identified in a Lambda function used to filter findings.

filePath -> (structure) [required]

Contains information on where the code vulnerability is located in your code.

fileName -> (string) [required]

The name of the file the code vulnerability was found in.

Constraints:

  • min: 1

filePath -> (string) [required]

The file path to the code that a vulnerability was found in.

Constraints:

  • min: 1

startLine -> (integer) [required]

The line number of the first line of code that a vulnerability was found in.

endLine -> (integer) [required]

The line number of the last line of code that a vulnerability was found in.

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 .

Constraints:

  • min: 1
  • max: 10

(string)

Constraints:

  • min: 1

referenceUrls -> (list)

A URL containing supporting documentation about the code vulnerability detected.

Constraints:

  • min: 1
  • max: 10

(string)

Constraints:

  • min: 1

ruleId -> (string)

The identifier for a rule that was used to detect the code vulnerability.

Constraints:

  • min: 1

sourceLambdaLayerArn -> (string)

The Amazon Resource Name (ARN) of the Lambda layer that the code vulnerability was detected in.

Constraints:

  • pattern: arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+

detectorId -> (string) [required]

The ID for the Amazon CodeGuru detector associated with the finding. For more information on detectors see Amazon CodeGuru Detector Library .

Constraints:

  • min: 1

detectorName -> (string) [required]

The name of the detector used to identify the code vulnerability. For more information on detectors see CodeGuru Detector Library .

Constraints:

  • min: 1

cwes -> (list) [required]

The Common Weakness Enumeration (CWE) item associated with the detected vulnerability.

Constraints:

  • min: 1
  • max: 10

(string)

Constraints:

  • min: 1

epss -> (structure)

The finding’s EPSS score.

score -> (double)

The EPSS score.

Constraints:

  • min: 0.0
  • max: 1.0