步骤5： 将您的目录上传到生产环境中

亚马逊接受您的目录后，您将从暂存环境过渡到生产环境。当您的目录通过亚马逊的验收审查后，您的亚马逊代表会向您的账户授予权限，让您可以向将目录提交至生产环境。在此步骤之前，您只能上传到staging/路径。

您的亚马逊代表确认何时启用生产访问权限，而您可以继续提交并在生产中持续进行目录更改。

提交您的生产目录

启用生产访问权限后，您可以将接受的目录上传到生产环境。

提交您的目录

1. 将您的目录文件上传到生产环境。

   aws s3 cp my-catalog.xml.zst \
     s3://amazon-media-catalogs/<提供者>/prod/catalogs/catalog-20250420.xml.zst
   

2. 创建和上传生产清单。

   {
       "s3Bucket": "amazon-media-catalogs",
       "s3Keys": [
           "<提供者>/prod/catalogs/catalog-20250420.xml.zst"
       ],
       "type": "CATALOG_FULL",
       "schema": "EMBER"
   }
   

   aws s3 cp prod-manifest.manifest \
     s3://amazon-media-catalogs/<提供者>/prod/manifests/prod-manifest-20250420.manifest
   

3. 在prod/reports/上查看生产引入报告。
4. 验证您的内容是否出现在设备上。现在，所有客户都应该能够查看内容。

建立持续维护

生产目录上线后，必须通过定期更新使其保持最新状态。

更新节奏

下表描述了提交目录更新所需的节奏。

为了使您的目录保持最新状态并提供最佳用户体验，亚马逊建议采用以下节奏：

• 每日： 最新发布、节目表更新、可用性变更
• 每周： 元数据校正、图像更新、增量更新
• 每月： 完整目录重建和验证

更新策略

维护目录时，您将定期执行增量更新、完整目录替换以及特定项目删除。

有关action属性（upsert或replace）和Delete元素（包括基于版本的删除规则和分层删除顺序）的详细文档，请参阅删除和编录操作。

增量更新

增量更新是最常见的更新类型。在清单中使用CATALOG_UPDATE并在目录中使用action="upsert"。如果省略action属性，则默认为upsert。

<ProgramCatalog id="MY_CATALOG" version="1" action="upsert">
    <Movie id="NEW_MOVIE" version="1"><!-- ... --></Movie>       <!-- 已添加 -->
    <Movie id="EXISTING_MOVIE" version="3"><!-- ... --></Movie>  <!-- 已更新 -->
    <Delete id="EXPIRED_MOVIE" version="10"/>                    <!-- 已删除 -->
    <!-- 未更改的影片不受影响 -->
</ProgramCatalog>

{
    "s3Bucket": "amazon-media-catalogs",
    "s3Keys": ["<提供者>/prod/catalogs/incremental-20250421.xml.zst"],
    "type": "CATALOG_UPDATE",
    "schema": "EMBER"
}

完整目录更换

在清单中使用CATALOG_FULL。系统会删除提交中不存在的所有项目。请谨慎使用此方法。

{
    "s3Bucket": "amazon-media-catalogs",
    "s3Keys": ["<提供者>/prod/catalogs/full-catalog-20250501.xml.zst"],
    "type": "CATALOG_FULL",
    "schema": "EMBER"
}

删除特定项目

在增量更新中使用Delete元素来移除单个项目。

<ProgramCatalog id="MY_CATALOG" version="1">
    <Delete id="OLD_MOVIE" version="100"/>
    <Delete id="EXPIRED_SERIES" version="50"/>
</ProgramCatalog>

移除电视层次结构时，在删除父项之前先删除子项。

<!-- 按顺序删除： 剧集 → 季 → 连续剧 -->
<Delete id="SERIES_S01E01" version="10"/>
<Delete id="SERIES_S01" version="5"/>
<Delete id="SERIES_1" version="3"/>

自动化

要实现可靠、可重复的上传，请自动执行目录提交流程。将AWS SDK结合计划任务 (cron) 使用来处理角色代入、凭证刷新、目录上传和清单提交。

• 上一个 – 步骤4： 通过亚马逊对目录的验收

Last updated: 2026年5月27日