了解 S3 文件网关缓存报告中提供的信息

存储桶：与文件共享关联的 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。

类型：用于标识该条目是 FILE 还是 DIRECTORY。

IsDirty— 报告文件TRUE是否有任何类型的更改尚未上传到 Amazon S3。这包括对元数据（例如文件名和 read/write 权限）的更改，即使文件的数据没有更改。

IsDataDirty— 报告文件数据TRUE是否有更改但尚未上传到 Amazon S3。

IsDeleted— 报告文件TRUE是否已在网关上删除。如果文件标记为已删除，则该文件将始终被标记为“脏”。

IsFailingToUpload— 报告将文件上传到 Amazon S3 时TRUE是否存在问题。此状态每 24 小时重置一次，以便让网关可以重试上传并检查问题是否已解决。对于未能上传的文件，网关会拒绝任何新的写入操作。如果网关缓存中还没有整个文件，则网关也会拒绝读取操作。

UploadError— 导致文件无法上传到 Amazon S3 的错误。有关解决这些错误的更多信息和建议的步骤，请参阅故障排除：文件网关问题。

SizeInBytes— 文件的总大小。

IsWholeFileInCache— 报告文件的所有数据当前TRUE是否存储在网关缓存中。对于未能上传到 Amazon S3 的文件，如果此项为 TRUE，则网关将允许读取该文件。