本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用增強型 AMI 分佈功能
<a name="distribution-enhanced_functionality"></a>

Image Builder 提供進階分佈功能，可讓您靈活地控制 AMIs區域和帳戶之間的分佈方式。這些功能將分發與建置程序分開，可讓您隨需分發現有的映像、有效率地從分發失敗中復原，並透過可自訂的工作流程實作受控的多階段分發策略。

您可以使用映像建置器中的增強型 AMI 分佈功能直接執行分佈活動，而不需要重新執行完整的映像建置。

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

DistributeImage API 接受三種類型的來源映像參考：
+ **AMI ID** – 標準 AMI 識別符 （例如 `ami-0abcdef1234567890`)
+ **SSM 參數** – 存放 AMI ID 的 SSM 參數 （例如 `ssm:/my/ami/parameter`)
+ **映像建置器版本 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 Logs 中的分佈日誌以取得錯誤詳細資訊。
+ 您擁有重試映像建置所需的 IAM 許可。
+ 對於跨帳戶分佈失敗，請確認目的地帳戶中`EC2ImageBuilderDistributionCrossAccountRole`的 已連接`Ec2ImageBuilderCrossAccountDistributionAccess`政策。

**重要：**在不修正基礎問題的情況下重試會導致重複失敗。

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

分佈工作流程是補充建置和測試工作流程的新工作流程類型，可讓您使用循序步驟定義和控制分佈程序。透過分發工作流程，您可以建立自訂分發程序，其中包含 AMI 複製操作、wait-for-action檢查點、影像屬性修改和其他分發相關步驟。這可讓您透過步驟層級可見性、平行分佈功能和精細錯誤報告，對 AMIs分佈方式進行結構化控制。

若要進一步了解如何建立和自訂工作流程，請參閱[管理映像工作流程](manage-image-workflows.html)。