Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1456338351.9 KB

Creates a new image. This request will create a new image along with all of the configured output resources defined in the distribution configuration. You must specify exactly one recipe for your image, using either a ContainerRecipeArn or an ImageRecipeArn.

put/CreateImage

Request body

imageRecipeArnstring

The Amazon Resource Name (ARN) of the image recipe that defines how images are configured, tested, and assessed.

containerRecipeArnstring

The Amazon Resource Name (ARN) of the container recipe that defines how images are configured and tested.

distributionConfigurationArnstring

The Amazon Resource Name (ARN) of the distribution configuration that defines and configures the outputs of your pipeline.

infrastructureConfigurationArnstring required

The Amazon Resource Name (ARN) of the infrastructure configuration that defines the environment in which your image will be built and tested.

enhancedImageMetadataEnabledboolean

Collects additional information about the image being created, including the operating system (OS) version and package list. This information is used to enhance the overall experience of using EC2 Image Builder. Enabled by default.

tagsobject

The tags of the image.

clientTokenstring required

The idempotency token used to make this request idempotent.

Response

Success

requestIdstring

The request ID that uniquely identifies this request.

clientTokenstring

The idempotency token used to make this request idempotent.

imageBuildVersionArnstring

The Amazon Resource Name (ARN) of the image that this request created.