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

# 为 S3 文件网关创建缓存报告
<a name="create-cache-report"></a>

S3 文件网关可为当前位于特定文件共享的本地上传缓存中的文件生成元数据报告。您可以应用筛选条件和其他标准来确定哪些特定类型的缓存文件出现在报告中。您可以使用此报告帮助确定和解决网关问题。例如，如果您无法将文件从网关上传到 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。
+ 网关根磁盘必须至少有 20 GB 的空闲空间。

**使用 Storage Gateway 控制台创建缓存报告**

1. 在家中打开 Storage Gateway 控制台 [https://console.aws.amazon.com/storagegateway//](https://console.aws.amazon.com/storagegateway/home/)。

1. 在页面左侧的导航窗格中，选择**文件共享**，然后选择要为其创建缓存报告的文件共享。

1. 从**操作**下拉菜单中，选择**创建缓存报告**。

1. 对于 **Amazon S3 位置**，输入 Amazon S3 存储桶和前缀，这指明了您希望用来在 Amazon S3 中保存已完成的缓存报告 CSV 文件对象的位置。要从现有 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 角色不支持网关执行上传操作。有关更多信息，请参阅[错误：S3 AccessDenied](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。如果网关出于任何原因（包括 VPC 配置无效）而无法连接到 Amazon S3 存储桶，则缓存报告创建会失败。

1. （可选）在**标签 - 可选**下，选择**添加新标签**，然后输入缓存报告的**键**和**值**。

   标签是区分大小写的键值对，有助于您对 Storage Gateway 资源进行分类。添加标签可以更轻松地筛选和搜索缓存报告。您可以重复此步骤以添加至多 50 个标签。

1. 完成后，选择**创建报告**。

   Storage Gateway 开始生成报告。您可以在文件共享详细信息页面的**缓存报告**选项卡上查看进度和状态。