為您的 S3 檔案閘道建立快取報告 - AWS Storage Gateway

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

為您的 S3 檔案閘道建立快取報告

S3 File Gateway 可以針對特定檔案共享產生目前在本機上傳快取中的檔案中繼資料報告。您可以套用篩選條件和其他條件，以決定哪些特定類型的快取檔案會出現在報告中。您可以使用此報告來協助識別和解決閘道問題。例如，如果您有檔案無法從閘道上傳到 Amazon S3，您可以產生報告，列出無法上傳的特定檔案，以及上傳失敗的原因。報告是 CSV 檔案，其中包含符合您指定的一組篩選條件參數的檔案清單。輸出檔案會以 Amazon S3 物件的形式存放在您在設定報告時指定的儲存貯體位置。若要使用 AWS Storage Gateway API 建立快取報告，請參閱 Storage Gateway API 參考中的 StartCacheReport。若要在 Storage Gateway 主控台中建立快取報告，請使用下列程序。

先決條件

  • 閘道必須具有您要存放快取報告的 Amazon S3 儲存貯體的 s3:PutObject和 s3:AbortMultipartUpload許可。

  • 檔案共享目前沒有其他快取報告正在進行中。

  • 檔案共享的現有快取報告必須少於 10 個。

  • 閘道必須上線並連線至 AWS。

  • 閘道根磁碟必須至少有 20GB 的可用空間。

使用 Storage Gateway 主控台建立快取報告

  1. 前往 https://console.aws.amazon.com/storagegateway/home 開啟 Storage Gateway 主控台。

  2. 在頁面左側的導覽窗格中，選擇檔案共享，然後選擇您要為其建立快取報告的檔案共享。

  3. 從動作下拉式功能表中，選擇建立快取報告。

  4. 對於 Amazon S3 位置，輸入您要在 Amazon S3 中儲存已完成快取報告 CSV 檔案物件的位置的 Amazon S3 儲存貯體和字首。若要從現有的 Amazon S3 儲存體中選取儲存貯體和字首，請選擇瀏覽 S3。

  5. 對於 IAM 角色，請執行下列其中一項作業來指定 IAM 角色，以授予檔案閘道產生和存放快取報告的許可：

    • 若要指定現有的 IAM 角色，請從下拉式清單中選擇角色。

    • 若要手動建立新的 IAM 角色，請選擇建立角色，然後使用 IAM 主控台建立新的角色。

    注意

    您指定的 IAM 角色必須具有下列許可，才能將物件寫入報告儲存貯體 Amazon S3 位置，並停止分段上傳至報告儲存貯體：

    • s3:PutObject

    • s3:AbortMultipartUpload

    角色也必須允許storagegateway.amazonaws.com服務使用 sts:AssumeRole動作擔任角色。

  6. 針對報告篩選條件，執行下列其中一項操作，以判斷快取報告中將包含哪些檔案：

    • 若要包含目前上傳到 Amazon S3 失敗的所有快取檔案，請選擇上傳失敗的所有檔案。

    • 若要僅包含因特定原因而無法上傳至 Amazon S3 的檔案，請僅選擇特定上傳失敗原因。然後，基於失敗原因，選取下列一或多個原因：

      • 無法存取的儲存類別 — 閘道無法存取存放物件的 Amazon S3 儲存類別。如需詳細資訊，請參閱錯誤：InaccessibleStorageClass。

      • 物件狀態無效 — 閘道上檔案的狀態與 Amazon S3 中的狀態不相符。如需詳細資訊，請參閱錯誤：InvalidObjectState。

      • 物件遺失 — 物件已在 Amazon S3 中刪除或移動。如需詳細資訊，請參閱錯誤：ObjectMissing。

      • S3 存取遭拒 — Amazon S3 儲存貯體存取 IAM 角色不允許閘道執行上傳操作。如需詳細資訊，請參閱錯誤：S3AccessDenied。

    注意

    檔案上傳失敗旗標會每 24 小時重設一次，並在閘道重新啟動期間重設。如果此報告在重設後擷取檔案，但在再次標記為標記之前，它們將不會報告為檔案上傳失敗。

  7. 對於使用 VPC 端點連線至 S3？，請執行下列其中一項動作來指定閘道如何連線至 Amazon S3 儲存貯體：

    • 若要直接連線而不使用 Amazon VPC，請選擇直接連線至儲存貯體。

    • 若要瀏覽現有 Amazon VPC 端點的清單，請選擇選擇 VPC 端點，然後從出現的 VPC 端點下拉式清單中指定端點。

    • 若要依 DNS 名稱指定現有的 Amazon VPC 端點，請選擇輸入 VPC 端點 DNS 名稱，然後在出現的 VPC 端點 DNS 名稱欄位中輸入 DNS 名稱。

    注意

    如果您的檔案共享使用 VPC 端點連線至 Amazon S3 進行正常操作，我們建議您在設定快取報告時使用相同的 VPC。如果閘道因任何原因無法連線至 Amazon S3 儲存貯體，包括無效的 VPC 組態，快取報告建立將會失敗。

  8. （選用） 在標籤 - 選用下，選擇新增標籤，然後輸入快取報告的索引鍵和值。

    標籤是區分大小寫的鍵值組，可協助您分類 Storage Gateway 資源。新增標籤可讓您更輕鬆地篩選和搜尋快取報告。您可以重複此步驟來新增最多 50 個標籤。

  9. 完成後，請選擇建立報告。

    Storage Gateway 會開始產生報告。您可以在檔案共享的詳細資訊頁面的快取報告索引標籤上檢查進度和檢視狀態。