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

# 了解 S3 File Gateway 快取報告中提供的資訊
<a name="understand-cache-reports"></a>

快取報告會根據您指定的篩選條件和條件，列出目前位於特定檔案共享本機快取中的檔案。每個快取報告都包含下列資訊：
+ **儲存貯體** — 與檔案共用相關聯的 Amazon S3 儲存貯體或存取點。
+ **S3ObjectKey** — 存放此檔案資料和中繼資料的 Amazon S3 物件。此物件具有已上傳至 S3 的最新資料，但可能缺少無法上傳至 S3 的資料。
+ **FilePath** — 閘道快取中檔案項目的檔案路徑。您可以在此處找到掛載和瀏覽檔案共享時的檔案。
+ **RenamedTo** — 重新命名檔案的新路徑。當您重新命名檔案共享上的檔案時，閘道需要同時追蹤檔案的舊位置和新位置。此欄位會顯示檔案移至何處，協助您追蹤檔案重新命名操作 - 即使檔案已重新命名多次。當您需要了解檔案共享中的檔案如何對應至 Amazon S3 儲存貯體中的物件時，此資訊特別有用。

  下列範例顯示複雜案例的快取報告項目，涉及直接在 Amazon S3 中覆寫檔案，同時透過檔案閘道重新命名。在此案例中，閘道會將檔案上傳至 `A.txt` S3，然後移出檔案內容以在本機快取中騰出空間。然後，關聯的 S3 物件會直接在 S3 中覆寫，而不是透過閘道採取的動作，這會導致 `InvalidObjectState`，因為 S3 物件與閘道預期的不相符。同時，檔案`A.txt`已`B.txt`透過閘道重新命名為 。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/filegateway/latest/files3/understand-cache-reports.html)
+ **類型** — 表示項目是用於 `FILE`或 `DIRECTORY`。
+ **IsDirty** — 報告`TRUE`檔案是否有任何尚未上傳至 Amazon S3 的變更類型。這包括變更中繼資料，例如檔案名稱和讀取/寫入許可，即使檔案的資料尚未變更。
+ **IsDataDirty** — `TRUE` 如果檔案的資料有變更，且尚未上傳至 Amazon S3，請回報。
+ **IsDeleted** — `TRUE` 報告是否已在閘道上刪除檔案。如果檔案標示為已刪除，則一律會標示為骯髒。
+ **IsFailingToUpload** — 將檔案上傳至 Amazon S3 `TRUE` 時發生問題時回報。此狀態每 24 小時重設一次，以允許閘道重試上傳，並檢查是否已解決問題。對於無法上傳的檔案，閘道會拒絕任何新的寫入操作。如果閘道在快取中沒有整個檔案，則也會拒絕讀取操作。
+ **UploadError** — 防止檔案上傳至 Amazon S3 的錯誤。如需詳細資訊和解決這些錯誤的建議步驟，請參閱[故障診斷：檔案閘道問題](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html)。
+ **SizeInBytes** — 檔案的總大小。
+ **IsWholeFileInCache** — `TRUE` 報告是否所有檔案的資料目前都存放在閘道快取中。如果檔案無法上傳至 Amazon S3 是 TRUE``，則閘道將允許讀取檔案。