Class: Aws::SecurityHub::Types::FindingHistoryRecord

Inherits:

Struct

• Object
• Struct
• Aws::SecurityHub::Types::FindingHistoryRecord

Defined in:

gems/aws-sdk-securityhub/lib/aws-sdk-securityhub/types.rb

Overview

A list of events that changed the specified finding during the specified time period. Each record represents a single finding change event.

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #finding_created ⇒ Boolean

  Identifies whether the event marks the creation of a new finding.

• #finding_identifier ⇒ Types::AwsSecurityFindingIdentifier

  Identifies which finding to get the finding history for.

• #next_token ⇒ String

  A token for pagination purposes.

• #update_source ⇒ Types::FindingHistoryUpdateSource

  Identifies the source of the event that changed the finding.

• #update_time ⇒ Time

  A timestamp that indicates when Security Hub processed the updated finding record.

• #updates ⇒ Array<Types::FindingHistoryUpdate>

  An array of objects that provides details about the finding change event, including the Amazon Web Services Security Finding Format (ASFF) field that changed, the value of the field before the change, and the value of the field after the change.

Instance Attribute Details

#finding_created ⇒ Boolean

Identifies whether the event marks the creation of a new finding. A value of True means that the finding is newly created. A value of False means that the finding isn’t newly created.

Returns:

• (Boolean)

# File 'gems/aws-sdk-securityhub/lib/aws-sdk-securityhub/types.rb', line 25035

class FindingHistoryRecord < Struct.new(
  :finding_identifier,
  :update_time,
  :finding_created,
  :update_source,
  :updates,
  :next_token)
  SENSITIVE = []
  include Aws::Structure
end

#finding_identifier ⇒ Types::AwsSecurityFindingIdentifier

Identifies which finding to get the finding history for.

Returns:

• (Types::AwsSecurityFindingIdentifier)

# File 'gems/aws-sdk-securityhub/lib/aws-sdk-securityhub/types.rb', line 25035

class FindingHistoryRecord < Struct.new(
  :finding_identifier,
  :update_time,
  :finding_created,
  :update_source,
  :updates,
  :next_token)
  SENSITIVE = []
  include Aws::Structure
end

#next_token ⇒ String

A token for pagination purposes. Provide this token in the subsequent request to GetFindingsHistory to get up to an additional 100 results of history for the same finding that you specified in your initial request.

Returns:

• (String)

# File 'gems/aws-sdk-securityhub/lib/aws-sdk-securityhub/types.rb', line 25035

class FindingHistoryRecord < Struct.new(
  :finding_identifier,
  :update_time,
  :finding_created,
  :update_source,
  :updates,
  :next_token)
  SENSITIVE = []
  include Aws::Structure
end

#update_source ⇒ Types::FindingHistoryUpdateSource

Identifies the source of the event that changed the finding. For example, an integrated Amazon Web Services service or third-party partner integration may call BatchImportFindings , or an Security Hub customer may call BatchUpdateFindings .

Returns:

• (Types::FindingHistoryUpdateSource)

# File 'gems/aws-sdk-securityhub/lib/aws-sdk-securityhub/types.rb', line 25035

class FindingHistoryRecord < Struct.new(
  :finding_identifier,
  :update_time,
  :finding_created,
  :update_source,
  :updates,
  :next_token)
  SENSITIVE = []
  include Aws::Structure
end

#update_time ⇒ Time

A timestamp that indicates when Security Hub processed the updated finding record.

This field accepts only the specified formats. Timestamps can end with Z or ("+" / "-") time-hour [":" time-minute]. The time-secfrac after seconds is limited to a maximum of 9 digits. The offset is bounded by +/-18:00. Here are valid timestamp formats with examples:

• YYYY-MM-DDTHH:MM:SSZ (for example, 2019-01-31T23:00:00Z)

• YYYY-MM-DDTHH:MM:SS.mmmmmmmmmZ (for example, 2019-01-31T23:00:00.123456789Z)

• YYYY-MM-DDTHH:MM:SS+HH:MM (for example, 2024-01-04T15:25:10+17:59)

• YYYY-MM-DDTHH:MM:SS-HHMM (for example, 2024-01-04T15:25:10-1759)

• YYYY-MM-DDTHH:MM:SS.mmmmmmmmm+HH:MM (for example, 2024-01-04T15:25:10.123456789+17:59)

Returns:

• (Time)

# File 'gems/aws-sdk-securityhub/lib/aws-sdk-securityhub/types.rb', line 25035

class FindingHistoryRecord < Struct.new(
  :finding_identifier,
  :update_time,
  :finding_created,
  :update_source,
  :updates,
  :next_token)
  SENSITIVE = []
  include Aws::Structure
end

#updates ⇒ Array<Types::FindingHistoryUpdate>

An array of objects that provides details about the finding change event, including the Amazon Web Services Security Finding Format (ASFF) field that changed, the value of the field before the change, and the value of the field after the change.

Returns:

• (Array<Types::FindingHistoryUpdate>)

# File 'gems/aws-sdk-securityhub/lib/aws-sdk-securityhub/types.rb', line 25035

class FindingHistoryRecord < Struct.new(
  :finding_identifier,
  :update_time,
  :finding_created,
  :update_source,
  :updates,
  :next_token)
  SENSITIVE = []
  include Aws::Structure
end