检索 Macie 查找的敏感数据样本

在 Amazon Macie 控制台上执行以下步骤，确定是否有敏感数据样本可用于调查发现。

要以编程方式确定敏感数据样本是否可用于查找，请使用 Ama API zon Macie 的GetSensitiveDataOccurrencesAvailability操作。提交请求时，使用 findingId 参数指定调查发现的唯一标识符。要获取此标识符，您可以使用ListFindings操作。

如果你使用的是 AWS Command Line Interface (AWS CLI)，运行 get-sensitive-data-occurrences-avail ability 命令并使用finding-id参数指定查找结果的唯一标识符。要获取此标识符，可以运行 list-findings 命令。

如果您的请求成功并且有样本可用于调查发现，则您将收到类似于以下内容的输出：

{
    "code": "AVAILABLE",
    "reasons": []
}

如果您的请求成功并且没有样本可用于调查发现，则该 code 字段的值为 UNAVAILABLE，reasons 数组会指定原因。例如：

{
    "code": "UNAVAILABLE",
    "reasons": [
        "UNSUPPORTED_OBJECT_TYPE"
    ]
}

如果调查发现的敏感数据发现结果存在问题，则该调查发现的 classificationDetails.detailedResultsLocation 字段中的信息有助于您调查问题。此字段指定了发现结果在 Amazon S3 中的原始路径。要调查角色的问题，请确保该IAM角色的策略符合 Macie 担任该角色的所有要求。有关详细信息，请参阅 配置IAM角色以访问受影响的 S3 对象。

按照以下步骤使用 Amazon Macie 控制台检索和显示敏感数据样本以用于调查发现。

要以编程方式检索和显示查找结果的敏感数据样本，请使用 Ama API zon Macie 的GetSensitiveDataOccurrences操作。提交请求时，使用 findingId 参数指定调查发现的唯一标识符。要获取此标识符，您可以使用ListFindings操作。

要检索和显示敏感数据样本，请使用 AWS Command Line Interface (AWS CLI)，运行get-sensitive-data-occurrences命令并使用finding-id参数指定查找结果的唯一标识符。例如：

C:\> aws macie2 get-sensitive-data-occurrences --finding-id "1f1c2d74db5d8caa76859ec52example"

位置 1f1c2d74db5d8caa76859ec52example 是发现的唯一标识符。要获取此标识符，请使用 AWS CLI，你可以运行 list-findings 命令。

如果您的请求成功，Macie 将开始处理您的请求，您将收到类似于以下内容的输出：

{
    "status": "PROCESSING"
}

处理您的申请可能需要几分钟时间。几分钟后，再次提交您的申请。

如果 Macie 可以定位、检索和加密敏感数据样本，则 Macie 会在 sensitiveDataOccurrences 地图中返回样本。该地图指定了发现结果报告的 1-100 种敏感数据类型，为每种类型指定了 1—10 个样本。每个样本都包含调查发现报告的敏感数据的前 1-128 个字符。

在映射中，每个键都是检测到敏感数据的托管式数据标识符的 ID，或检测到敏感数据的自定义数据标识符的名称和唯一标识符。这些值是指定托管数据标识符或自定义数据标识符的样本。例如，以下响应提供了三个人名样本和两个样本 AWS 由托管数据标识符（NAME和AWS_CREDENTIALS）检测到的私有访问密钥。

{
    "sensitiveDataOccurrences": {
        "NAME": [
            {
                "value": "Akua Mansa"
            },
            {
                "value": "John Doe"
            },
            {
                "value": "Martha Rivera"
            }
        ],
        "AWS_CREDENTIALS": [
            {
                "value": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
            },
            {
                "value": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY"
            }
        ]
    },
    "status": "SUCCESS"
}

如果您的请求成功但敏感数据样本不可用于调查发现，则您会收到一条 UnprocessableEntityException 消息，说明样本不可用的原因。例如：

{
    "message": "An error occurred (UnprocessableEntityException) when calling the GetSensitiveDataOccurrences operation: OBJECT_UNAVAILABLE"
}

在前面的示例中，Macie 尝试从受影响的 S3 对象中检索样本，但该对象已不再可用。在 Macie 创建调查发现后，对象的内容发生了变化。

如果您的请求成功，但由于其他类型的错误使 Macie 无法检索和显示调查发现的敏感数据样本，则您会收到类似于以下内容的输出：

{
    "error": "Macie can't retrieve the samples. You're not allowed to access the affected S3 object or the object is encrypted with a key that you're not allowed to use.",
    "status": "ERROR"
}

该 status 字段的值为 ERROR，该 error 字段描述了发生的错误。前述主题 中的信息有助您调查错误。