檢索 Macie 發現的敏感數據樣本

請在 Amazon Macie 主控台上執行下列步驟，以判斷是否有機密資料樣本可供尋找。

若要以程式設計方式判斷敏感資料樣本是否可用於尋找項目，請使用 Amazon Macie API 的GetSensitiveDataOccurrencesAvailability操作。當您提交請求時，請使用findingId參數來指定發現項目的唯一識別碼。要獲取此標識符，您可以使用該ListFindings操作。

如果您使用的是 AWS Command Line Interface (AWS CLI)，執行 get-sensitive-data-occurrences-availability 命令，並使用finding-id參數來指定發現項目的唯一識別碼。要獲取此標識符，您可以運行列表發現項目命令。

如果您的要求成功，且尋找項目有可用的範例，您會收到類似下列的輸出：

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

如果您的要求成功且尋找項目無法使用範例，則code欄位的值為，UNAVAILABLE而reasons陣列會指定原因。例如：

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

如果發現項目的敏感資料探索結果發生問題，發現項目classificationDetails.detailedResultsLocation欄位中的資訊可協助您調查問題。此欄位會指定 Amazon S3 中結果的原始路徑。若要調查IAM角色的問題，請確定角色的策略符合 Macie 擔任該角色的所有要求。如需這些詳細資訊，請參閱設定IAM角色以存取受影響的 S3 物件。

請遵循下列步驟，使用 Amazon Macie 主控台擷取和顯示用於尋找的敏感資料範例。

若要擷取和顯示以程式設計方式尋找的敏感資料範例，請使用 Amazon Macie API 的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，您可以運行列表發現項目命令。

如果您的要求成功，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位說明發生的錯誤。上述主題中的資訊可協助您調查錯誤。