使用增強型 AMI 分佈功能

AMI ID – 標準 AMI 識別符，例如 ami-0abcdef1234567890。AMI 必須在您呼叫 操作的區域中存在並可存取。

SSM 參數：格式為 的 Systems Manager 參數存放區參考ssm:/path/to/parameter，其中 的文字ssm:是參數名稱或 ARN。參數必須是其值為有效 AMI ID 的String參數。

映像建置器映像版本 ARN – 在您呼叫 操作的區域中映像建置器映像的 ARN。影像的輸出資源必須在該區域中包含 AMI。您可以指定以組建編號結尾的組建版本 ARN，例如 image/my-image/1.0.0/1，或不含組建編號的版本 ARN，例如 image/my-image/1.0.0。Image Builder 會將版本 ARN 解析為 AVAILABLE 狀態的最新組建。

Image Builder 可以擔任以執行分佈的 Image Builder 執行角色。建議您建立已連接 EC2ImageBuilderExecutionPolicy AWS 受管政策的自訂角色。該政策ec2:EnableFastLaunch僅允許對標記為 的資源使用 ec2:ModifyImageAttributeec2:ModifySnapshotAttribute、 和 CreatedBy: EC2 Image Builder，並ssm:PutParameter僅允許對 下的參數使用 /imagebuilder/。如果您的分佈作用於其他資源，請將必要的許可新增至角色。若要設定沒有啟動範本的 EC2 Fast Launch，請同時連接 EC2FastLaunchFullAccess政策。若要使用啟動範本設定 EC2 Fast Launch，啟動範本必須具有 CreatedBy: EC2 Image Builder標籤。Image Builder 只會將此標籤新增至分佈組態在 中更新的啟動範本launchTemplateConfigurations。對於任何其他啟動範本，請自行新增標籤或連接EC2FastLaunchFullAccess政策。

呼叫 imagebuilder:DistributeImage、 imagebuilder:GetDistributionConfiguration和 iam:PassRole 執行角色的許可。Image Builder 也會使用登入資料描述來源 AMI 以進行驗證，因此您需要ec2:DescribeImages每種來源類型。如果來源是 SSM 參數，您也需要ssm:GetParameter該參數。如果來源是映像建置器映像 ARN，您也需要在該映像imagebuilder:GetImage上。如果您在請求中包含標籤，您也需要 imagebuilder:TagResource。

如果分發組態將 AMI 複製到其他帳戶 (targetAccountIds)，或更新其他帳戶中的啟動範本或 SSM 參數，EC2ImageBuilderDistributionCrossAccountRole則每個帳戶中的 都會連接Ec2ImageBuilderCrossAccountDistributionAccess 政策受管政策。受管政策不包含啟動範本或 SSM 參數。若要更新這些參數，也請新增使用映像建置器設定跨帳戶 AMI 分佈列出 launchTemplateConfigurations和 參數存放區參數的政策。

映像處於 FAILED或 CANCELLED 狀態，並在測試或分佈階段失敗或取消。您無法重試成功或仍在進行中的映像，或任何其他階段中失敗或取消的映像。

影像是在過去 30 天內建立的。

映像是以 AMI 為基礎的映像。您無法重試容器映像。

影像尚未重試次數上限。Image Builder 每個映像最多允許 10 次重試。

您已識別並解決失敗的根本原因。在 CloudWatch Logs 中檢閱映像的日誌，以取得錯誤詳細資訊。

您有權在要重試的映像建置版本imagebuilder:RetryImage上呼叫 。

對於跨帳戶分佈失敗，請確認目的地帳戶中EC2ImageBuilderDistributionCrossAccountRole的 已連接 Ec2ImageBuilderCrossAccountDistributionAccess 政策受管政策。如需詳細資訊，請參閱使用映像建置器設定跨帳戶 AMI 分佈。

跨區域和帳戶複製和共用 AMI。

修改分散式 AMIs 上的映像屬性，例如啟動許可。

套用其他映像組態。

暫停以進行手動核准，或使用wait-for-action步驟進行外部回呼。這可讓您建置階段或門控推展 – 例如，分發到測試區域、等待核准，然後繼續生產區域。