/CreateImage
http://imagebuilder.{region}.amazonaws.com/CreateImageCreates 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.
Body Params
The tags of the image.
The idempotency token used to make this request idempotent.
The Amazon Resource Name (ARN) of the image recipe that defines how images are configured, tested, and assessed.
The Amazon Resource Name (ARN) of the container recipe that defines how images are configured and tested.
Configure image tests for your pipeline build. Tests run after building the image, to verify that the AMI or container image is valid before distributing it.
Contains settings for Image Builder image resource and container image scans.
The Amazon Resource Name (ARN) of the distribution configuration that defines and configures the outputs of your pipeline.
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.
The Amazon Resource Name (ARN) of the infrastructure configuration that defines the environment in which your image will be built and tested.
Responses
{
"success": true,
"data": {
"id": "abc123",
"created_at": "2025-01-01T00:00:00Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
}
}1curl --request PUT \2 --url 'http://imagebuilder.{region}.amazonaws.com/CreateImage' \3 --header 'accept: application/json' \4 --header 'content-type: application/json'1{2 "success": true,3 "data": {4 "id": "abc123",5 "created_at": "2025-01-01T00:00:00Z"6 }7}