Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AmiDistributionConfiguration - EC2 Image Builder

AmiDistributionConfiguration

Define and configure the output AMIs of the pipeline.

Contents

amiTags

The tags to apply to AMIs distributed to this Region.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[a-zA-Z+-=._:/]+$

Value Length Constraints: Maximum length of 256.

Required: No

description

The description of the AMI distribution configuration. Minimum and maximum length are in characters.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

kmsKeyId

The KMS key identifier used to encrypt the distributed image.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

launchPermission

Launch permissions can be used to configure which AWS accounts can use the AMI to launch instances.

Type: LaunchPermissionConfiguration object

Required: No

name

The name of the output AMI.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 127.

Pattern: ^[-_A-Za-z0-9{][-_A-Za-z0-9\s:{}\.]+[-_A-Za-z0-9}]$

Required: No

targetAccountIds

The ID of an account to which you want to distribute an image.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 1536 items.

Pattern: ^[0-9]{12}$

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.