本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 了解 S3 文件网关缓存报告中提供的信息
<a name="understand-cache-reports"></a>

缓存报告根据您指定的筛选条件和标准，列出当前在特定文件共享的本地缓存中的文件。每个缓存报告包含以下信息：
+ **存储桶**：与文件共享关联的 Amazon S3 存储桶或接入点。
+ **S3 ObjectKey** — 存储此文件的数据和元数据的 Amazon S3 对象。此对象包含已上传到 S3 的最新数据，但缺少未能上传到 S3 的数据。
+ **FilePath**— 网关缓存中文件条目的文件路径。在挂载和浏览文件共享时，可以在此处找到文件。
+ **RenamedTo**— 重命名文件的新路径。在文件共享上重命名文件时，网关需要跟踪文件的旧位置和新位置。此字段显示文件移动后的位置，可帮助您跟踪文件重命名操作，即使文件已多次重命名也可跟踪。当您需要了解文件共享中的文件如何与 Amazon S3 存储桶中的对象对应时，此信息特别有用。

  以下示例显示了一个复杂场景的缓存报告条目，该场景涉及直接在 Amazon S3 中覆盖文件，同时还通过文件网关对文件进行重命名。在这种情况下，网关将文件 `A.txt` 上传到 S3，然后移出文件内容以在本地缓存中腾出空间。然后，直接在 S3 中（而不是通过网关执行操作）覆盖关联的 S3 对象，由于 S3 对象与网关的期望不匹配，所以这会导致出现 `InvalidObjectState` 错误。同时，通过网关将文件 `A.txt` 重命名为 `B.txt`。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/filegateway/latest/files3/understand-cache-reports.html)
+ **类型**：用于标识该条目是 `FILE` 还是 `DIRECTORY`。
+ **IsDirty**— 报告文件`TRUE`是否有任何类型的更改尚未上传到 Amazon S3。这包括对元数据（例如文件名和 read/write 权限）的更改，即使文件的数据没有更改。
+ **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``，则网关将允许读取该文件。