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

# 使用增强的 AMI 分发功能
<a name="distribution-enhanced_functionality"></a>

Image Builder 提供高级分发功能， AMIs 可让您灵活控制跨区域和账户的分布方式。这些功能将分发与构建过程分开，允许您按需分发现有图像，高效地从分发失败中恢复，并通过可自定义的工作流程实施受控的多阶段分发策略。

您可以在 Image Builder 中使用增强的 AMI 分发功能直接执行分发活动，而无需重新运行完整的映像构建。

## 解耦分布
<a name="decoupled-distribution"></a>

 DistributeImage API 接受三种类型的源图像引用：
+ **AMI ID** — 标准的 AMI 标识符（例如，`ami-0abcdef1234567890`）
+ **SSM 参数** — 存储 AMI ID 的 SSM 参数（例如，）`ssm:/my/ami/parameter`
+ **Image Builder 版本 ARN** — 图像生成器图像版本 ARN

## 分发重试
<a name="distribution-retry"></a>

如果图像分发失败，请使用 `RetryImage` API 重试分发。这避免了完整的映像重建，从而缩短了排除故障原因的时间。`RetryImage`在解决分发失败的根本原因后使用。

 RetryImage API 接受映像构建版本 ARN（例如）。`arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1`当您调用 API 时，Image Builder 会使用原始分发配置和设置自动从故障点恢复分发过程。`RetryImage`API 可以重试在分发阶段、测试阶段或集成阶段失败的分发。它适用于以下状态：待处理、失败、已删除或可用。 AMIs 

**先决条件** 

在重试分发之前，请确保满足以下条件：
+ 您已经确定并解决了失败的根本原因。查看日志中的分发 CloudWatch 日志，了解错误详情。
+ 您拥有重试镜像构建所必需的 IAM 权限。
+ 对于跨账户分发失败，请验证目标账户`EC2ImageBuilderDistributionCrossAccountRole`中的是否已附加`Ec2ImageBuilderCrossAccountDistributionAccess`策略。

**重要：**如果不修复根本问题，重试将导致重复失败。

## 分发工作流程
<a name="distribution-workflows"></a>

分发工作流是一种新的工作流类型，它补充了构建和测试工作流程，使您能够通过顺序步骤定义和控制分发流程。通过分发工作流程，您可以创建自定义分发流程，包括 AMI 复制操作、 wait-for-action检查点、图像属性修改和其他与分发相关的步骤。这提供了对分布方式的结构化控制， AMIs 包括分步级可见性、并行分发功能和精细的错误报告。

要了解有关创建和自定义工作流程的更多信息，请参阅[管理图像工作流程](manage-image-workflows.html)。