本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對資料儲存庫任務失敗進行故障診斷
<a name="failed-tasks"></a>

您可以[開啟記錄](cw-event-logging.md)到 CloudWatch Logs，以記錄有關使用資料儲存庫任務匯入或匯出檔案時遇到的任何失敗的資訊。如需 CloudWatch Logs 事件日誌的資訊，請參閱 [資料儲存庫事件日誌](data-repo-event-logs.md)。

當資料儲存庫任務失敗時，您可以在主控台**的任務狀態**頁面上，找到 Amazon FSx 在 檔案中**無法匯出的檔案**數目。或者，您可以使用 CLI 或 API 並檢視任務的 `Status: FailedCount` 屬性。如需存取此資訊的資訊，請參閱 [存取資料儲存庫任務](view-data-repo-tasks.md)。

對於資料儲存庫任務，Amazon FSx 也會選擇性地提供有關完成報告中失敗的特定檔案和目錄的資訊。任務完成報告包含檔案Lustre系統上失敗的檔案或目錄路徑、其狀態和失敗原因。如需詳細資訊，請參閱[使用任務完成報告](task-completion-report.md)。

資料儲存庫任務可能會因為多種原因而失敗，包括下列原因。


| 錯誤程式碼 | 說明 | 
| --- | --- | 
|  `FileSizeTooLarge`  |  Amazon S3 支援的物件大小上限為 5 TiB。  | 
|  `InternalError`  |  匯入、匯出或發行任務的 Amazon FSx 檔案系統內發生錯誤。一般而言，此錯誤碼表示失敗任務執行的 Amazon FSx 檔案系統處於 FAILED 生命週期狀態。發生這種情況時，由於資料遺失，受影響的檔案可能無法復原。否則，您可以使用階層式儲存管理 (HSM) 命令，將檔案和目錄匯出至 S3 上的資料儲存庫。如需詳細資訊，請參閱[使用 HSM 命令匯出檔案](exporting-files-hsm.md)。  | 
|  `OperationNotPermitted`  | Amazon FSx 無法釋出檔案，因為它尚未匯出至連結的 S3 儲存貯體。您必須使用自動匯出或匯出資料儲存庫任務，以確保您的檔案先匯出至連結的 Amazon S3 儲存貯體。  | 
|  `PathSizeTooLong`  |  匯出路徑太長。S3 支援的物件金鑰長度上限為 1，024 個字元。  | 
|  `ResourceBusy`  | Amazon FSx 無法匯出或釋出檔案，因為檔案系統上的另一個用戶端正在存取該檔案。您可以在工作流程寫入檔案完成後重試 DataRepositoryTask。  | 
|  `S3AccessDenied`  |  拒絕對 Amazon S3 進行資料儲存庫匯出或匯入任務的存取。 對於匯出任務，Amazon FSx 檔案系統必須具有執行 `S3:PutObject`操作的許可，才能匯出至 S3 上連結的資料儲存庫。此許可是在`AWSServiceRoleForFSxS3Access_{{fs-0123456789abcdef0}}`服務連結角色中授予。如需詳細資訊，請參閱[使用 Amazon FSx 的服務連結角色](using-service-linked-roles.md)。 對於匯出任務，因為匯出任務需要資料才能在檔案系統的 VPC 外部流動，如果目標儲存庫具有包含其中一個 `aws:SourceVpc`或 IAM `aws:SourceVpce` 全域條件金鑰的儲存貯體政策，則可能會發生此錯誤。 對於匯入任務，Amazon FSx 檔案系統必須具有執行 `S3:HeadObject`和 `S3:GetObject`操作的許可，才能從 S3 上連結的資料儲存庫匯入 。 對於匯入任務，如果您的 S3 儲存貯體使用伺服器端加密搭配存放在 AWS Key Management Service (SSE-KMS) 中的客戶受管金鑰，您必須遵循 中的政策組態[使用伺服器端加密的 Amazon S3 儲存貯體](s3-server-side-encryption-support.md)。 如果您的 S3 儲存貯體包含從與檔案系統連結的 S3 儲存貯體帳戶 AWS 帳戶 不同的 上傳的物件，您可以確保資料儲存庫任務可以修改 S3 中繼資料或覆寫 S3 物件，無論其上傳的帳戶為何。我們建議您為 S3 儲存貯體啟用 S3 物件擁有權功能。此功能可讓您取得其他 AWS 帳戶 上傳到儲存貯體的新物件的所有權，方法是強制上傳以提供`-/-acl bucket-owner-full-control`標準 ACL。您可以在 S3 儲存貯體中選擇**儲存貯體擁有者偏好的**選項，以啟用 S3 物件擁有權。如需詳細資訊，請參閱《Amazon [ S3 使用者指南》中的使用 S3 物件擁有權控制上傳物件的擁有權](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)。 *Amazon S3 *  | 
|  `S3Error`  |  Amazon FSx 遇到非 的 S3-related錯誤`S3AccessDenied`。  | 
|  `S3FileDeleted`  | Amazon FSx 無法匯出硬連結檔案，因為來源檔案不存在於資料儲存庫中。 | 
|  `S3ObjectInUnsupportedTier`  | Amazon FSx 成功從 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 儲存類別匯入非符號連結物件。`FileStatus` 將在`succeeded with warning`任務完成報告中。警告指出若要擷取資料，您必須先還原 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 物件，然後使用 `hsm_restore`命令匯入物件。  | 
|  `S3ObjectNotFound`  | Amazon FSx 無法匯入或匯出檔案，因為它不存在於資料儲存庫中。 | 
|  `S3ObjectPathNotPosixCompliant`  |  Amazon S3 物件存在，但無法匯入，因為它不是 POSIX 相容物件。如需有關支援的 POSIX 中繼資料的資訊，請參閱 [資料儲存庫的 POSIX 中繼資料支援](posix-metadata-support.md)。  | 
|  `S3ObjectUpdateInProgressFromFileRename`  | Amazon FSx 無法釋出檔案，因為自動匯出正在處理檔案的重新命名。必須先完成自動匯出重新命名程序，才能釋出檔案。  | 
|  `S3SymlinkInUnsupportedTier`  | Amazon FSx 無法匯入符號連結物件，因為它位於不支援的 Amazon S3 儲存類別中，例如 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 儲存類別。`FileStatus` 將在`failed`任務完成報告中。 | 
|  `SourceObjectDeletedBeforeReleasing`  | Amazon FSx 無法從檔案系統釋出檔案，因為檔案在可以釋出之前已從資料儲存庫中刪除。 |