DistributionConfiguration
Defines how Image Builder distributes the output of an image build. You can configure:
-
The Regions to distribute the image to.
-
The Region-specific settings to apply, such as output AMI names, launch permissions for other AWS accounts, and target container repositories.
Contents
- timeoutMinutes
-
A property that Image Builder doesn't use. You can't set this property when you create or update a distribution configuration, and it has no effect on distribution behavior.
Type: Integer
Valid Range: Minimum value of 30. Maximum value of 720.
Required: Yes
- arn
-
The Amazon Resource Name (ARN) of the distribution configuration.
Type: String
Pattern:
^arn:aws[^:]*:imagebuilder:[^:]+:(?:[0-9]{12}|aws(?:-[a-z-]+)?|third-party):(?:image-recipe|container-recipe|infrastructure-configuration|distribution-configuration|component|image|image-pipeline|lifecycle-policy|workflow\/(?:build|test|distribution))/[a-z0-9-_]+(?:/(?:(?:x|[0-9]+)\.(?:x|[0-9]+)\.(?:x|[0-9]+))(?:/[0-9]+)?)?$Required: No
- dateCreated
-
The date on which this distribution configuration was created.
Type: String
Required: No
- dateUpdated
-
The date on which this distribution configuration was last updated.
Type: String
Required: No
- description
-
The description of the distribution configuration.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: No
- distributions
-
The distribution objects that apply Region-specific settings for the deployment of the image to targeted Regions.
Type: Array of Distribution objects
Required: No
- name
-
The name of the distribution configuration.
Type: String
Pattern:
^[-_A-Za-z-0-9][-_A-Za-z0-9 ]{1,126}[-_A-Za-z-0-9]$Required: No
-
The tags of the distribution configuration.
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-Z0-9\s_.:/=+\-@]*$Value Length Constraints: Maximum length of 256.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: