Skip to content

InvestigationRecord

Structure Class

InvestigationRecord dataclass

Bases: _SerdeShape

Contains information about one step in the reasoning that GuardDuty followed during an investigation.

Attributes

created_at class-attribute instance-attribute
created_at: datetime | None = ...

The timestamp at which GuardDuty created the record.

narrative class-attribute instance-attribute
narrative: str | None = ...

A plain-text explanation of the step. A narrative can span several paragraphs. Not every record includes a narrative.

record_id class-attribute instance-attribute
record_id: str | None = ...

The unique identifier of the record.

supporting_data class-attribute instance-attribute
supporting_data: SupportingData | None = ...

The structured details for the step. The member that is set matches the record type. UPDATE records never include supporting data, and records of other types don't always include it.

title class-attribute instance-attribute
title: str | None = ...

A short title that describes the step.

type class-attribute instance-attribute
type: str | None = ...

The type of the record. Possible values:

  • UPDATE -- A progress milestone, such as the request that started the investigation or a response from GuardDuty.

  • FETCH -- Data that GuardDuty retrieved for the investigation, such as a finding, a detector configuration, or a list of your member accounts. The record includes what GuardDuty requested and what it received.

  • OBSERVATION -- A fact that GuardDuty noted about your environment, such as the affected resource, the activity on that resource, or your detection coverage.

  • ANALYSIS -- An assessment that GuardDuty derived from the data, such as a threat assessment, a comparison against normal behavior, or a process lineage.

  • METADATA -- Operational details about the investigation itself, such as how long the investigation took.