了解 S3 File Gateway 快取報告中提供的資訊

快取報告會根據您指定的篩選條件和條件，列出目前位於特定檔案共享本機快取中的檔案。每個快取報告都包含下列資訊：

• 儲存貯體 — 與檔案共用相關聯的 Amazon S3 儲存貯體或存取點。

• S3ObjectKey — 存放此檔案資料和中繼資料的 Amazon S3 物件。此物件具有已上傳至 S3 的最新資料，但可能缺少無法上傳至 S3 的資料。

• FilePath — 閘道快取中檔案項目的檔案路徑。您可以在此處找到掛載和瀏覽檔案共享時的檔案。

• RenamedTo — 重新命名檔案的新路徑。當您重新命名檔案共享上的檔案時，閘道需要同時追蹤檔案的舊位置和新位置。此欄位會顯示檔案移至何處，協助您追蹤檔案重新命名操作 - 即使檔案已重新命名多次。當您需要了解檔案共享中的檔案如何對應至 Amazon S3 儲存貯體中的物件時，此資訊特別有用。

  下列範例顯示複雜案例的快取報告項目，涉及直接在 Amazon S3 中覆寫檔案，同時透過檔案閘道重新命名。在此案例中，閘道會將檔案上傳至 A.txt S3，然後移出檔案內容以在本機快取中騰出空間。然後，關聯的 S3 物件會直接在 S3 中覆寫，而不是透過閘道採取的動作，這會導致 InvalidObjectState，因為 S3 物件與閘道預期的不相符。同時，檔案A.txt已B.txt透過閘道重新命名為 。

  儲存貯體	S3ObjectKey	FilePath	RenamedTo	Type	IsDirty	IsDataDirty	IsDeleted	IsFailingToUpload	UploadError	SizeInBytes	IsWholeFileInCache
  samplebucket-iad	A.txt	/B.txt		FILE	TRUE	FALSE	FALSE	TRUE	InvalidObjectState	4	FALSE
  samplebucket-iad	A.txt	/A.txt	/B.txt	FILE	TRUE	FALSE	TRUE	FALSE		4	FALSE

• 類型 — 表示項目是用於 FILE或 DIRECTORY。

• IsDirty — 報告TRUE檔案是否有任何尚未上傳至 Amazon S3 的變更類型。這包括變更中繼資料，例如檔案名稱和讀取/寫入許可，即使檔案的資料尚未變更。

• IsDataDirty — TRUE 如果檔案的資料有變更，且尚未上傳至 Amazon S3，則報告。

• IsDeleted — TRUE 報告是否已在閘道上刪除檔案。如果檔案標示為已刪除，則一律會標示為骯髒。

• IsFailingToUpload — 將檔案上傳至 Amazon S3 TRUE 時發生問題時回報。此狀態每 24 小時重設一次，以允許閘道重試上傳，並檢查是否已解決問題。對於無法上傳的檔案，閘道會拒絕任何新的寫入操作。如果閘道在快取中沒有整個檔案，則也會拒絕讀取操作。

• UploadError — 防止檔案上傳至 Amazon S3 的錯誤。如需詳細資訊和解決這些錯誤的建議步驟，請參閱故障診斷：檔案閘道問題。

• SizeInBytes — 檔案的總大小。

• IsWholeFileInCache — TRUE 報告是否所有檔案的資料目前都存放在閘道快取中。如果檔案無法上傳至 Amazon S3 是 TRUE，則閘道將允許讀取檔案。