在 S3 的惡意軟體防護中監控 S3 物件掃描

當您使用惡意軟體防護搭配 S3GuardDuty 偵測器 ID 時，如果您的 Amazon S3 物件潛在惡意，GuardDuty 將產生 S3 調查結果類型的惡意軟體防護。使用 GuardDuty 主控台和 APIs，您可以檢視產生的調查結果。如需了解此調查結果類型的資訊，請參閱調查結果詳細資訊。

在未啟用 GuardDuty （無偵測器 ID) 的情況下使用適用於 S3 的惡意軟體防護時，即使您掃描的 Amazon S3 物件可能惡意，GuardDuty 也無法產生任何問題清單。

S3 物件潛在掃描狀態和結果狀態

本節說明潛在的 S3 物件掃描狀態值和掃描結果值。

S3 物件掃描狀態表示惡意軟體掃描的狀態，例如已完成、略過或失敗。

S3 物件惡意軟體掃描結果狀態會根據掃描狀態值指出掃描結果。每個惡意軟體掃描結果狀態值都會映射至掃描狀態。

下列清單提供潛在的 S3 物件掃描結果值。如果您已啟用標記，您可以透過監控掃描結果使用 S3 物件標籤。掃描後，標籤值將具有下列其中一個掃描結果值。

S3 物件潛在惡意軟體掃描結果狀態值

NO_THREATS_FOUND – GuardDuty 未偵測到與掃描物件相關聯的潛在威脅。
THREATS_FOUND – GuardDuty 偵測到與掃描物件相關聯的潛在威脅。
UNSUPPORTED – S3 的惡意軟體防護會略過掃描有幾個原因。可能的原因包括受密碼保護的檔案、具有極高壓縮比率的封存、 S3 配額的惡意軟體防護和對某些 Amazon S3 功能的支援可能無法使用。如需詳細資訊，請參閱S3 的惡意軟體防護功能。
ACCESS_DENIED – GuardDuty 無法存取此物件進行掃描。檢查與此儲存貯體相關聯的 IAM 角色許可。如需詳細資訊，請參閱建立或更新 IAM 角色政策。

如果您已啟用掃描後 S3 物件標記，請參閱對 S3 物件掃描後標籤失敗進行故障診斷。
FAILED – 由於內部錯誤，GuardDuty 無法對此物件執行惡意軟體掃描。

以下清單提供潛在的 S3 物件掃描狀態值及其與 S3 物件掃描結果的映射。

S3 物件潛在掃描狀態值

已完成 – 掃描已成功完成，並指出 S3 物件是否具有惡意軟體。在這種情況下，潛在的 S3 物件掃描結果值可以是 THREATS_FOUND或 NO_THREATS_FOUND。
已略過 – GuardDuty 在惡意軟體防護 S3 不支援掃描此 S3 物件時略過惡意軟體掃描，或 GuardDuty 無法存取所選儲存貯體中上傳的 S3 物件。

在這種情況下，潛在的 S3 物件掃描結果值可以是 UNSUPPORTED或 ACCESS_DENIED。

如果刪除必要的 IAM 角色，GuardDuty 也會略過掃描。
失敗 – 類似於 S3 物件掃描結果值 FAILED，此掃描狀態表示 GuardDuty 因為內部錯誤而無法對 S3 物件執行惡意軟體掃描。

當掃描狀態為時SKIPPED，S3 物件掃描結果的 EventBridge 通知會在中包含 statusReasons 欄位scanResultDetails。此欄位是字串清單，提供略過掃描的特定原因。下表說明可能的 statusReasons 值。

狀態原因	掃描結果狀態	Description
`UNAUTHORIZED_TO_GET_OBJECT`	`ACCESS_DENIED`	S3 的惡意軟體防護沒有讀取 S3 物件的許可，或 S3 物件不存在。確認與受保護儲存貯體相關聯的 IAM 角色具有必要的許可，而且任何儲存貯體 AWS KMS 政策都允許該角色解密物件。
`UNAUTHORIZED_TO_ASSUME_ROLE`	`ACCESS_DENIED`	S3 的惡意軟體防護無法擔任為受保護儲存貯體設定的 IAM 角色。確認角色信任政策允許 S3 的惡意軟體防護擔任該角色。
`SSE_C_ENCRYPTED_OBJECT`	`ACCESS_DENIED`	S3 物件會使用客戶提供的加密金鑰 (SSE-C) 進行加密。GuardDuty 無法存取使用 SSE-C 加密的物件。如需詳細資訊，請參閱 Amazon S3 功能的支援能力。
`OBJECT_E_TAG_CHANGED`	`ACCESS_DENIED`	S3 物件 ETag 會在啟動掃描和 GuardDuty 嘗試讀取物件之間變更。後續上傳或新版本將會掃描。
`BUCKET_NOT_FOUND`	`ACCESS_DENIED`	與掃描相關聯的 S3 儲存貯體不再存在。
`UNSUPPORTED_STORAGE_CLASS`	`UNSUPPORTED`	S3 物件使用惡意軟體防護 S3 不支援的儲存類別。如需詳細資訊，請參閱Amazon S3 功能的支援能力。
`OBJECT_SIZE_LIMIT_EXCEEDED`	`UNSUPPORTED`	S3 物件大小超過 S3 惡意軟體防護的檔案大小上限。如需詳細資訊，請參閱S3 配額的惡意軟體防護。
`PASSWORD_PROTECTED`	`UNSUPPORTED`	物件受密碼保護。
`EXTRACTED_FILE_LIMIT_EXCEEDED`	`UNSUPPORTED`	封存包含的檔案超過允許的上限。如需詳細資訊，請參閱S3 配額的惡意軟體防護。
`EXTRACTED_LEVEL_LIMIT_EXCEEDED`	`UNSUPPORTED`	封存超過允許的巢狀深度上限。
`EXTRACTED_BYTE_LIMIT_EXCEEDED`	`UNSUPPORTED`	擷取的封存內容超過允許的位元組大小上限。如需詳細資訊，請參閱S3 配額的惡意軟體防護。
`EXTRACTION_RATIO_LIMIT_EXCEEDED`	`UNSUPPORTED`	封存的壓縮比率非常高，超過允許的限制。如需詳細資訊，請參閱S3 配額的惡意軟體防護。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

檢視並了解受保護的儲存貯體狀態

使用 Amazon EventBridge

在 S3 的惡意軟體防護中監控 S3 物件掃描

目錄

S3 物件潛在掃描狀態和結果狀態

S3 物件潛在惡意軟體掃描結果狀態值

S3 物件潛在掃描狀態值