步骤1：
创建您的目录文件
创建您的目录文件
步骤5： 确认上传的目录是否无误
步骤5： 确认上传的目录是否无误
上传您的目录文件后，亚马逊会以每小时一次的频率将报告发布到您的目录存储桶。这些报告包含了过去一小时内处理的视频项目的详细信息。请查看这些报告，确保您的目录没有错误。如果出现错误，则必须解读引入报告中包含的消息并对目录文件进行排查。
接收和解读目录引入报告
将您的目录数据上传至Amazon Simple Storage Service (S3) 存储桶以集成到亚马逊目录后，目录引入系统就会开始处理您的目录，并以每小时一次的频率生成引入报告。这些报告包含了过去一小时内处理的视频项目数量，以及所发现的任何视频项目问题的详细信息。
检索您的引入报告
引入报告是HTML文件，与您上传的目录文件位于同一S3存储桶中。您可以选择在新报告可供查看时接收电子邮件通知。这封电子邮件会提供报告的基本摘要，以及可用于下载完整报告的命令。
如何接收引入状态通知电子邮件
要接收引入报告摘要电子邮件，请让亚马逊代表将您添加到您目录的分发列表中。引入系统会发送有关成功和失败的电子邮件，因此，如果您想接收这两种类型的电子邮件，请让亚马逊代表将您加入到两个列表中。如果在过去一小时内处理了视频项目，以每小时一次的频率生成报告。
如何使用电子邮件中的信息
您收到的电子邮件会提供过去一小时内处理的视频项目的状态。要查看系统在处理视频项目时遇到的错误，请参阅完整报告。这封电子邮件包含了可用于检索完整报告的亚马逊云科技 (AWS) 命令。
要使用该AWS命令检索报告，您必须先安装AWS命令行界面 (CLI) 工具，然后就可以在普通命令或终端窗口中使用AWS命令了。此流程可确保您的专有目录信息仍然受到保护，因为必须拥有您的S3存储桶的访问权限，才能使用该命令检索报告。
以下是用于检索报告的AWS命令示例。从电子邮件中复制该行，并将其粘贴到命令或终端窗口中。
aws s3api get-object --bucket cdf-test --key reports/12_17_2024/report-1734398489665-20241217012129.html --version-id FciuqMvVh2oWFv726L6Ytf8ECLbO6Kj0 report.html
如果成功运行，此命令会将报告下载到当前文件夹。下载的文件名为report.html。有关该命令的更多详细信息，请参阅AWS CLI命令参考get-object页面（仅提供英文版）。
引入报告
引入报告分为三部分：
摘要
下图展示了引入报告摘要部分的示例。
摘要包含了以下内容：
- 授予每次引入尝试的唯一ID
- 尝试引入的日期和时间
- 处理的视频项目计数，包括总计、已添加、已删除、已跳过、已更新和无变化的视频项目的数量
- 与所处理项目有关的错误、警告和建议消息计数
注意： 查看Counts（计数）部分，确保结果符合预期。可能会出现以下情况：您不小心删除了很大一部分目录，但系统没有报告任何错误。要确定是否出现了问题，您需要通过仔细查看计数发现移除的条目数量异常多。
错误、警告和建议
在报告的这一部分中，您可以找到解决任何问题所需的信息。展开各部分即可查看报告信息。下图展示了三个消息部分，其中Details（详细信息）按钮处于折叠状态。
Details按钮可打开一个可扩展的部分，其中列出了各条消息。每条消息的末尾是生成该消息的条目数。展开详细信息部分后，单击消息旁边的加号可显示生成该消息的作业的ID。在某些情况下，执行此操作后会显示一条包含更多详细信息的附加消息。下图所示的示例包含了展开的错误详细信息。
计数
报告的最后一部分详细介绍了您的目录因引入而发生的变化。单击每个类别中的Details按钮，可显示每个类别中作业的ID。下图展示了报告的Counts部分。
如果您列出了预期变化，则可以将该列表与这些列表进行比较，作为最终验证。Skipped（已跳过）项目计数表示在引入过程中由于出现错误或警告而跳过的视频项目数量。如果引入成功，则Total（总计）、Added（已添加）、Deleted（已删除）、Updated（已更新）和Unchanged（无变化）项目的计数应该会反映您的预期结果。
根据引入报告采取行动
接下来的行动取决于引入报告中存在的错误。
-
没有错误 – 只要总计、已添加、已删除、已更新和无变化的项目计数符合预期，就无需采取进一步行动。但是，如有任何警告和建议，请考虑予以处理。有关每条消息的解释和行动方案，请参阅目录引入报告消息。
-
有错误 – 有关Errors（错误）部分中每个条目的解释和行动方案，请参阅目录引入报告消息。如果您仍然不明白需要做些什么或如何完成，请联系您的亚马逊代表。
目录摘要报告
目录摘要报告以综合视图的形式显示您的目录在亚马逊的当前状态。该综合视图非常全面，包含了所有目录项目、所有未解决的错误和警告，以及优化建议。该报告集中一处显示所有问题（无论问题是何时引入的），从而为目录维护提供了集中的信息来源。您可以借助该报告来高效管理和改善目录的运行状况。该报告每天生成，可在您的S3存储桶中找到，地址为/reports/<日期>/catalog-summary-<日期时间>.html。
下图展示了目录摘要报告示例。
引入报告常见问题解答
以下是有关获取引入报告的常见问题解答（FAQ）
- 问： 如何知道我上传的目录文件是否已被引入到系统中？
- 您可以通过自愿选择接收的电子邮件来接收引入结果。请让亚马逊代表将您添加到电子邮件分发列表中。
- 问： 我的目录引入出错了。接下来该怎么做？
- 请查看引入报告以了解具体错误。引入报告文档包含了每个错误的解释和后续行动说明。有关详细信息，请参阅目录引入报告消息。
后续步骤
继续执行下一步： 步骤6： 定期更新您的目录。
Last updated: 2025年2月4日