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

# 為您的 S3 檔案閘道建立快取報告
<a name="create-cache-report"></a>

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

**先決條件**
+ 閘道必須具有您要存放快取報告的 Amazon S3 儲存貯體的 `s3:PutObject`和 `s3:AbortMultipartUpload`許可。
+ 檔案共享目前沒有其他快取報告正在進行中。
+ 檔案共享的現有快取報告必須少於 10 個。
+ 閘道必須上線並連線至 AWS。
+ 閘道根磁碟必須至少有 20GB 的可用空間。

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

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

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

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

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

1. 對於 **IAM 角色**，請執行下列其中一項作業來指定 IAM 角色，以授予您的檔案閘道產生和存放快取報告的許可：
   + 若要指定現有的 IAM 角色，請從下拉式清單中選擇角色。
   + 若要手動建立新的 IAM 角色，請選擇**建立角色**，然後使用 IAM 主控台建立新的角色。
**注意**  
您指定的 IAM 角色必須具有下列許可，才能將物件寫入報告儲存貯體 **Amazon S3 位置**，以及停止分段上傳至報告儲存貯體：  
`s3:PutObject`
`s3:AbortMultipartUpload`
角色也必須允許`storagegateway.amazonaws.com`服務使用 `sts:AssumeRole`動作擔任角色。

1. 對於**報告篩選條件**，請執行下列其中一項操作，以判斷快取報告中將包含哪些檔案：
   + 若要包含目前上傳到 Amazon S3 失敗的所有快取檔案，請選擇**上傳失敗的所有檔案**。
   + 若要僅包含因特定原因而無法上傳至 Amazon S3 的檔案，請**僅選擇特定上傳失敗原因**。然後，基於**失敗原因**，選取下列一或多個原因：
     + 無法存取的儲存類別 — 閘道無法存取存放物件的 Amazon S3 儲存類別。如需詳細資訊，請參閱[錯誤：InaccessibleStorageClass](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-inaccessiblestorageclass)。
     + 物件狀態無效 — 閘道上檔案的狀態與 Amazon S3 中的狀態不相符。如需詳細資訊，請參閱[錯誤：InvalidObjectState](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-invalidobjectstate)。
     + 物件遺失 — 物件已在 Amazon S3 中刪除或移動。如需詳細資訊，請參閱[錯誤：ObjectMissing](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-objectmissing)。
     + S3 存取遭拒 — Amazon S3 儲存貯體存取 IAM 角色不允許閘道執行上傳操作。如需詳細資訊，請參閱[錯誤：S3AccessDenied](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-s3accessdenied)。
**注意**  
**檔案上傳失敗**旗標會每 24 小時重設一次，並在閘道重新啟動期間重設。如果此報告在重設後擷取檔案，但在再次被標記之前，不會將其報告為**檔案上傳失敗**。

1. 對於**使用 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 組態，快取報告建立將會失敗。

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

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

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

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