Skip to content

AnalysisRecord

Structure Class

AnalysisRecord dataclass

Bases: _SerdeShape

Contains an assessment that GuardDuty derived from the data during an investigation, such as a threat assessment, a comparison against normal behavior, or a process lineage. The record contains at most one of the payload members, the one that corresponds to AnalysisType. Indicators can accompany any analysis type.

Attributes

account_analysis class-attribute instance-attribute
account_analysis: InvestigationAccountAnalysis | None = ...

An analysis of the findings in an account over time. Set when AnalysisType is TREND or BASELINE.

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

The kind of analysis. The value identifies the payload member that can be set: REPUTATION, THREAT_ASSESSMENT, and RDS_THREAT_ASSESSMENT (ThreatAssessment); KUBERNETES_POLICY_VIOLATION (KubernetesPolicyViolation); S3_EXPOSURE, S3_ACTOR_CONTEXT, and S3_PEN_TEST (S3Analysis); PROCESS_LINEAGE (Processes); and TREND and BASELINE (AccountAnalysis).

indicators class-attribute instance-attribute
indicators: list[InvestigationIndicator] | None = ...

The threat indicators associated with the analysis, such as an IP address, a domain, or a file hash.

kubernetes_policy_violation class-attribute instance-attribute
kubernetes_policy_violation: KubernetesPolicyViolation | None = ...

An assessment of a Kubernetes policy violation. Set when AnalysisType is KUBERNETES_POLICY_VIOLATION.

processes class-attribute instance-attribute
processes: list[Process] | None = ...

The processes in a process lineage. Set when AnalysisType is PROCESS_LINEAGE.

s3_analysis class-attribute instance-attribute
s3_analysis: S3Analysis | None = ...

An analysis of Amazon S3 activity or exposure. Set when AnalysisType is S3_EXPOSURE, S3_ACTOR_CONTEXT, or S3_PEN_TEST.

threat_assessment class-attribute instance-attribute
threat_assessment: InvestigationThreatAssessment | None = ...

A threat assessment. Set when AnalysisType is REPUTATION, THREAT_ASSESSMENT, or RDS_THREAT_ASSESSMENT.