/CreateInfrastructureConfiguration
http://imagebuilder.{region}.amazonaws.com/CreateInfrastructureConfigurationCreates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.
Body Params
The name of the infrastructure configuration.
The tags of the infrastructure configuration.
The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.
Logging configuration defines where Image Builder uploads your logs.
The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.
The idempotency token used to make this request idempotent.
The description of the infrastructure configuration.
<p>The Amazon Resource Name (ARN) for the SNS topic to which we send image build event notifications.</p> <note> <p>EC2 Image Builder is unable to send notifications to SNS topics that are encrypted using keys from other accounts. The key that is used to encrypt the SNS topic must reside in the account that the Image Builder service runs under.</p> </note>
The tags attached to the resource created by Image Builder.
The instance types of the infrastructure configuration. You can specify one or more instance types to use for this build. The service will pick one of these instance types based on availability.
The security group IDs to associate with the instance used to customize your Amazon EC2 AMI.
The instance profile to associate with the instance used to customize your Amazon EC2 AMI.
The instance metadata options that apply to the HTTP requests that pipeline builds use to launch EC2 build and test instances. For more information about instance metadata options, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html">Configure the instance metadata options</a> in the <i> <i>Amazon EC2 User Guide</i> </i> for Linux instances, or <a href="https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/configuring-instance-metadata-options.html">Configure the instance metadata options</a> in the <i> <i>Amazon EC2 Windows Guide</i> </i> for Windows instances.
The terminate instance on failure setting of the infrastructure configuration. Set to false if you want Image Builder to retain the instance used to configure your AMI if the build or test phase of your workflow fails.
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/CreateInfrastructureConfiguration' \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}