Manage EC2 Image Builder distribution settings - EC2 Image Builder
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Manage EC2 Image Builder distribution settings

After you create distribution settings with Image Builder, you can manage them using the Image Builder console, the Image Builder API, or imagebuilder commands in the Amazon CLI. With distribution settings, you can perform the following actions:

AMI distribution

  • Specify the name and description of your output AMI.

  • Authorize other Amazon Web Services accounts, organizations, and OUs to launch the AMI from the owner's account. The owner account is billed for charges that are associated with the AMI.

    Note

    To make an AMI public, set the launch permission authorized accounts to all. For information and examples, see ModifyImageAttribute in the Amazon EC2 API Reference.

  • Create a copy of the output AMI for each of the specified target accounts, organizations, and OUs in the destination Region. The target accounts, organizations, and OUs own their AMI copies, and are billed for any associated charges. For more information about distributing your AMI to Amazon Organizations and OUs, see Share an AMI with organizations or OUs.

  • Copy the AMI to the owner's account in other Amazon Web Services Regions.

  • Export VM image disks to Amazon Simple Storage Service (Amazon S3). For more information, see Create distribution settings for output VM disks from the Amazon CLI.

Container image distribution

  • Specify the ECR repository where Image Builder stores the output image in the distribution Region.

You can use your distribution settings in the following ways to deliver images to target Regions, accounts, Amazon Organizations and organizational units (OUs) one time, or with every pipeline build:

  • To automatically deliver updated images to specified Regions, accounts, Organizations, and OUs, use distribution settings with an Image Builder pipeline that runs on a schedule.

  • To create a new image and deliver it to the specified Regions, accounts, Organizations, and OUs, use distribution settings with an Image Builder pipeline that you run one time from the Image Builder console, using Run pipeline from the Actions menu.

  • To create a new image and deliver it to the specified Regions, accounts, Organizations, and OUs, use distribution settings with the following API action or Image Builder command in the Amazon CLI:

  • To export virtual machine (VM) image disks to S3 buckets in target Regions as part of your regular image build process.

Tip

When you have multiple resources of the same type, tagging helps you to identify a specific resource based on the tags you've assigned to it. For more information about tagging your resources using Image Builder commands in the Amazon CLI, see the Tag resources section of this guide.

This topic covers how to list, view, and create distribution settings.

Contents