Skip to content

Finding

Source code in docs_src/capo_inspector2/types/finding.py
class Finding(TypedDict, closed=True):
    finding_arn: "capo_inspector2.types.finding_arn.FindingArn"
    """<p>The Amazon Resource Number (ARN) of the finding.</p>"""
    aws_account_id: "capo_inspector2.types.account_id.AccountId"
    """<p>The Amazon Web Services account ID associated with the finding.</p>"""
    type: "capo_inspector2.types.finding_type.FindingType"
    """<p>The type of the finding. The <code>type</code> value determines the valid values for <code>resource</code> in your request. For more information, see <a href="https://docs.aws.amazon.com/inspector/latest/user/findings-types.html">Finding types</a> in the Amazon Inspector user guide.</p>"""
    description: "capo_inspector2.types.finding_description.FindingDescription"
    """<p>The description of the finding.</p>"""
    title: NotRequired["capo_inspector2.types.finding_title.FindingTitle"]
    """<p>The title of the finding.</p>"""
    remediation: "capo_inspector2.types.remediation.Remediation"
    """<p>An object that contains the details about how to remediate a finding.</p>"""
    severity: "capo_inspector2.types.severity.Severity"
    """<p>The severity of the finding. <code>UNTRIAGED</code> applies to <code>PACKAGE_VULNERABILITY</code> type findings that the vendor has not assigned a severity yet. For more information, see <a href="https://docs.aws.amazon.com/inspector/latest/user/findings-understanding-severity.html">Severity levels for findings</a> in the Amazon Inspector user guide.</p>"""
    first_observed_at: "capo_inspector2.types.date_time_timestamp.DateTimeTimestamp"
    """<p>The date and time that the finding was first observed.</p>"""
    last_observed_at: "capo_inspector2.types.date_time_timestamp.DateTimeTimestamp"
    """<p> The date and time the finding was last observed. This timestamp for this field remains unchanged until a finding is updated. </p>"""
    updated_at: NotRequired[
        "capo_inspector2.types.date_time_timestamp.DateTimeTimestamp"
    ]
    """<p>The date and time the finding was last updated at.</p>"""
    status: "capo_inspector2.types.finding_status.FindingStatus"
    """<p>The status of the finding.</p>"""
    resources: "capo_inspector2.types.resource_list.ResourceList"
    """<p>Contains information on the resources involved in a finding. The <code>resource</code> value determines the valid values for <code>type</code> in your request. For more information, see <a href="https://docs.aws.amazon.com/inspector/latest/user/findings-types.html">Finding types</a> in the Amazon Inspector user guide.</p>"""
    inspector_score: NotRequired["float"]
    """<p>The Amazon Inspector score given to the finding.</p>"""
    inspector_score_details: NotRequired[
        "capo_inspector2.types.inspector_score_details.InspectorScoreDetails"
    ]
    """<p>An object that contains details of the Amazon Inspector score.</p>"""
    network_reachability_details: NotRequired[
        "capo_inspector2.types.network_reachability_details.NetworkReachabilityDetails"
    ]
    """<p>An object that contains the details of a network reachability finding.</p>"""
    package_vulnerability_details: NotRequired[
        "capo_inspector2.types.package_vulnerability_details.PackageVulnerabilityDetails"
    ]
    """<p>An object that contains the details of a package vulnerability finding.</p>"""
    fix_available: NotRequired["capo_inspector2.types.fix_available.FixAvailable"]
    """<p>Details on whether a fix is available through a version update. This value can be <code>YES</code>, <code>NO</code>, or <code>PARTIAL</code>. A <code>PARTIAL</code> fix means that some, but not all, of the packages identified in the finding have fixes available through updated versions.</p>"""
    exploit_available: NotRequired[
        "capo_inspector2.types.exploit_available.ExploitAvailable"
    ]
    """<p>If a finding discovered in your environment has an exploit available.</p>"""
    exploitability_details: NotRequired[
        "capo_inspector2.types.exploitability_details.ExploitabilityDetails"
    ]
    """<p>The details of an exploit available for a finding discovered in your environment.</p>"""
    code_vulnerability_details: NotRequired[
        "capo_inspector2.types.code_vulnerability_details.CodeVulnerabilityDetails"
    ]
    """<p>Details about the code vulnerability identified in a Lambda function used to filter findings.</p>"""
    epss: NotRequired["capo_inspector2.types.epss_details.EpssDetails"]
    """<p>The finding's EPSS score.</p>"""

aws_account_id instance-attribute

aws_account_id: AccountId

The Amazon Web Services account ID associated with the finding.

code_vulnerability_details instance-attribute

code_vulnerability_details: NotRequired[CodeVulnerabilityDetails]

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

description instance-attribute

description: FindingDescription

The description of the finding.

epss instance-attribute

epss: NotRequired[EpssDetails]

The finding's EPSS score.

exploit_available instance-attribute

exploit_available: NotRequired[ExploitAvailable]

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

exploitability_details instance-attribute

exploitability_details: NotRequired[ExploitabilityDetails]

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

finding_arn instance-attribute

finding_arn: FindingArn

The Amazon Resource Number (ARN) of the finding.

first_observed_at instance-attribute

first_observed_at: DateTimeTimestamp

The date and time that the finding was first observed.

fix_available instance-attribute

fix_available: NotRequired[FixAvailable]

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.

inspector_score instance-attribute

inspector_score: NotRequired[float]

The Amazon Inspector score given to the finding.

inspector_score_details instance-attribute

inspector_score_details: NotRequired[InspectorScoreDetails]

An object that contains details of the Amazon Inspector score.

last_observed_at instance-attribute

last_observed_at: DateTimeTimestamp

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

network_reachability_details instance-attribute

network_reachability_details: NotRequired[NetworkReachabilityDetails]

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

package_vulnerability_details instance-attribute

package_vulnerability_details: NotRequired[PackageVulnerabilityDetails]

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

remediation instance-attribute

remediation: Remediation

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

resources instance-attribute

resources: ResourceList

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.

severity instance-attribute

severity: Severity

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.

status instance-attribute

status: FindingStatus

The status of the finding.

title instance-attribute

title: NotRequired[FindingTitle]

The title of the finding.

type instance-attribute

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.

updated_at instance-attribute

updated_at: NotRequired[DateTimeTimestamp]

The date and time the finding was last updated at.