Amazon Inspector
API Reference (API Version 2016-02-16)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Finding

Contains information about an Amazon Inspector finding. This data type is used as the response element in the DescribeFindings action.

Contents

arn

The ARN that specifies the finding.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 300.

Required: Yes

assetAttributes

A collection of attributes of the host from which the finding is generated.

Type: AssetAttributes object

Required: No

assetType

The type of the host from which the finding is generated.

Type: String

Valid Values: ec2-instance

Required: No

attributes

The system-defined attributes for the finding.

Type: Array of Attribute objects

Array Members: Minimum number of 0 items. Maximum number of 50 items.

Required: Yes

confidence

This data element is currently not used.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 10.

Required: No

createdAt

The time when the finding was generated.

Type: Timestamp

Required: Yes

description

The description of the finding.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 20000.

Required: No

id

The ID of the finding.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 128.

Required: No

indicatorOfCompromise

This data element is currently not used.

Type: Boolean

Required: No

numericSeverity

The numeric value of the finding severity.

Type: Double

Valid Range: Minimum value of 0.0. Maximum value of 10.0.

Required: No

recommendation

The recommendation for the finding.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 20000.

Required: No

schemaVersion

The schema version of this data type.

Type: Integer

Valid Range: Minimum value of 0.

Required: No

service

The data element is set to "Inspector".

Type: String

Length Constraints: Minimum length of 0. Maximum length of 128.

Required: No

serviceAttributes

This data type is used in the Finding data type.

Type: InspectorServiceAttributes object

Required: No

severity

The finding severity. Values can be set to High, Medium, Low, and Informational.

Type: String

Valid Values: Low | Medium | High | Informational | Undefined

Required: No

title

The name of the finding.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 20000.

Required: No

updatedAt

The time when AddAttributesToFindings is called.

Type: Timestamp

Required: Yes

userAttributes

The user-defined attributes that are assigned to the finding.

Type: Array of Attribute objects

Array Members: Minimum number of 0 items. Maximum number of 10 items.

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: