published on Tuesday, Mar 10, 2026 by Pulumi
published on Tuesday, Mar 10, 2026 by Pulumi
Manages an Image Builder Image.
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.ImageBuilder.Image("example", new()
{
DistributionConfigurationArn = aws_imagebuilder_distribution_configuration.Example.Arn,
ImageRecipeArn = aws_imagebuilder_image_recipe.Example.Arn,
InfrastructureConfigurationArn = aws_imagebuilder_infrastructure_configuration.Example.Arn,
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/imagebuilder"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := imagebuilder.NewImage(ctx, "example", &imagebuilder.ImageArgs{
DistributionConfigurationArn: pulumi.Any(aws_imagebuilder_distribution_configuration.Example.Arn),
ImageRecipeArn: pulumi.Any(aws_imagebuilder_image_recipe.Example.Arn),
InfrastructureConfigurationArn: pulumi.Any(aws_imagebuilder_infrastructure_configuration.Example.Arn),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.imagebuilder.Image;
import com.pulumi.aws.imagebuilder.ImageArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new Image("example", ImageArgs.builder()
.distributionConfigurationArn(aws_imagebuilder_distribution_configuration.example().arn())
.imageRecipeArn(aws_imagebuilder_image_recipe.example().arn())
.infrastructureConfigurationArn(aws_imagebuilder_infrastructure_configuration.example().arn())
.build());
}
}
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.imagebuilder.Image("example", {
distributionConfigurationArn: aws_imagebuilder_distribution_configuration.example.arn,
imageRecipeArn: aws_imagebuilder_image_recipe.example.arn,
infrastructureConfigurationArn: aws_imagebuilder_infrastructure_configuration.example.arn,
});
import pulumi
import pulumi_aws as aws
example = aws.imagebuilder.Image("example",
distribution_configuration_arn=aws_imagebuilder_distribution_configuration["example"]["arn"],
image_recipe_arn=aws_imagebuilder_image_recipe["example"]["arn"],
infrastructure_configuration_arn=aws_imagebuilder_infrastructure_configuration["example"]["arn"])
resources:
example:
type: aws:imagebuilder:Image
properties:
distributionConfigurationArn: ${aws_imagebuilder_distribution_configuration.example.arn}
imageRecipeArn: ${aws_imagebuilder_image_recipe.example.arn}
infrastructureConfigurationArn: ${aws_imagebuilder_infrastructure_configuration.example.arn}
Create Image Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Image(name: string, args: ImageArgs, opts?: CustomResourceOptions);@overload
def Image(resource_name: str,
args: ImageArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Image(resource_name: str,
opts: Optional[ResourceOptions] = None,
infrastructure_configuration_arn: Optional[str] = None,
container_recipe_arn: Optional[str] = None,
distribution_configuration_arn: Optional[str] = None,
enhanced_image_metadata_enabled: Optional[bool] = None,
image_recipe_arn: Optional[str] = None,
image_tests_configuration: Optional[ImageImageTestsConfigurationArgs] = None,
tags: Optional[Mapping[str, str]] = None)func NewImage(ctx *Context, name string, args ImageArgs, opts ...ResourceOption) (*Image, error)public Image(string name, ImageArgs args, CustomResourceOptions? opts = null)type: aws:imagebuilder:Image
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ImageArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ImageArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ImageArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ImageArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ImageArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var imageResource = new Aws.ImageBuilder.Image("imageResource", new()
{
InfrastructureConfigurationArn = "string",
ContainerRecipeArn = "string",
DistributionConfigurationArn = "string",
EnhancedImageMetadataEnabled = false,
ImageRecipeArn = "string",
ImageTestsConfiguration = new Aws.ImageBuilder.Inputs.ImageImageTestsConfigurationArgs
{
ImageTestsEnabled = false,
TimeoutMinutes = 0,
},
Tags =
{
{ "string", "string" },
},
});
example, err := imagebuilder.NewImage(ctx, "imageResource", &imagebuilder.ImageArgs{
InfrastructureConfigurationArn: pulumi.String("string"),
ContainerRecipeArn: pulumi.String("string"),
DistributionConfigurationArn: pulumi.String("string"),
EnhancedImageMetadataEnabled: pulumi.Bool(false),
ImageRecipeArn: pulumi.String("string"),
ImageTestsConfiguration: &imagebuilder.ImageImageTestsConfigurationArgs{
ImageTestsEnabled: pulumi.Bool(false),
TimeoutMinutes: pulumi.Int(0),
},
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
})
var imageResource = new com.pulumi.aws.imagebuilder.Image("imageResource", com.pulumi.aws.imagebuilder.ImageArgs.builder()
.infrastructureConfigurationArn("string")
.containerRecipeArn("string")
.distributionConfigurationArn("string")
.enhancedImageMetadataEnabled(false)
.imageRecipeArn("string")
.imageTestsConfiguration(ImageImageTestsConfigurationArgs.builder()
.imageTestsEnabled(false)
.timeoutMinutes(0)
.build())
.tags(Map.of("string", "string"))
.build());
image_resource = aws.imagebuilder.Image("imageResource",
infrastructure_configuration_arn="string",
container_recipe_arn="string",
distribution_configuration_arn="string",
enhanced_image_metadata_enabled=False,
image_recipe_arn="string",
image_tests_configuration={
"image_tests_enabled": False,
"timeout_minutes": 0,
},
tags={
"string": "string",
})
const imageResource = new aws.imagebuilder.Image("imageResource", {
infrastructureConfigurationArn: "string",
containerRecipeArn: "string",
distributionConfigurationArn: "string",
enhancedImageMetadataEnabled: false,
imageRecipeArn: "string",
imageTestsConfiguration: {
imageTestsEnabled: false,
timeoutMinutes: 0,
},
tags: {
string: "string",
},
});
type: aws:imagebuilder:Image
properties:
containerRecipeArn: string
distributionConfigurationArn: string
enhancedImageMetadataEnabled: false
imageRecipeArn: string
imageTestsConfiguration:
imageTestsEnabled: false
timeoutMinutes: 0
infrastructureConfigurationArn: string
tags:
string: string
Image Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Image resource accepts the following input properties:
- Infrastructure
Configuration stringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- Container
Recipe stringArn - Amazon Resource Name (ARN) of the container recipe.
- Distribution
Configuration stringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- Enhanced
Image boolMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - Image
Recipe stringArn - Amazon Resource Name (ARN) of the image recipe.
- Image
Tests ImageConfiguration Image Tests Configuration - Configuration block with image tests configuration. Detailed below.
- Dictionary<string, string>
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.
- Infrastructure
Configuration stringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- Container
Recipe stringArn - Amazon Resource Name (ARN) of the container recipe.
- Distribution
Configuration stringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- Enhanced
Image boolMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - Image
Recipe stringArn - Amazon Resource Name (ARN) of the image recipe.
- Image
Tests ImageConfiguration Image Tests Configuration Args - Configuration block with image tests configuration. Detailed below.
- map[string]string
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.
- infrastructure
Configuration StringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- container
Recipe StringArn - Amazon Resource Name (ARN) of the container recipe.
- distribution
Configuration StringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced
Image BooleanMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - image
Recipe StringArn - Amazon Resource Name (ARN) of the image recipe.
- image
Tests ImageConfiguration Image Tests Configuration - Configuration block with image tests configuration. Detailed below.
- Map<String,String>
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.
- infrastructure
Configuration stringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- container
Recipe stringArn - Amazon Resource Name (ARN) of the container recipe.
- distribution
Configuration stringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced
Image booleanMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - image
Recipe stringArn - Amazon Resource Name (ARN) of the image recipe.
- image
Tests ImageConfiguration Image Tests Configuration - Configuration block with image tests configuration. Detailed below.
- {[key: string]: string}
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.
- infrastructure_
configuration_ strarn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- container_
recipe_ strarn - Amazon Resource Name (ARN) of the container recipe.
- distribution_
configuration_ strarn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced_
image_ boolmetadata_ enabled - Whether additional information about the image being created is collected. Defaults to
true. - image_
recipe_ strarn - Amazon Resource Name (ARN) of the image recipe.
- image_
tests_ Imageconfiguration Image Tests Configuration Args - Configuration block with image tests configuration. Detailed below.
- Mapping[str, str]
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.
- infrastructure
Configuration StringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- container
Recipe StringArn - Amazon Resource Name (ARN) of the container recipe.
- distribution
Configuration StringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced
Image BooleanMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - image
Recipe StringArn - Amazon Resource Name (ARN) of the image recipe.
- image
Tests Property MapConfiguration - Configuration block with image tests configuration. Detailed below.
- Map<String>
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.
Outputs
All input properties are implicitly available as output properties. Additionally, the Image resource produces the following output properties:
- Arn string
- Amazon Resource Name (ARN) of the image.
- Date
Created string - Date the image was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Name of the AMI.
- Os
Version string - Operating System version of the image.
- Output
Resources List<ImageOutput Resource> - List of objects with resources created by the image.
- Platform string
- Platform of the image.
- Dictionary<string, string>
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - Version string
- Version of the image.
- Arn string
- Amazon Resource Name (ARN) of the image.
- Date
Created string - Date the image was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Name of the AMI.
- Os
Version string - Operating System version of the image.
- Output
Resources []ImageOutput Resource - List of objects with resources created by the image.
- Platform string
- Platform of the image.
- map[string]string
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - Version string
- Version of the image.
- arn String
- Amazon Resource Name (ARN) of the image.
- date
Created String - Date the image was created.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- Name of the AMI.
- os
Version String - Operating System version of the image.
- output
Resources List<ImageOutput Resource> - List of objects with resources created by the image.
- platform String
- Platform of the image.
- Map<String,String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version String
- Version of the image.
- arn string
- Amazon Resource Name (ARN) of the image.
- date
Created string - Date the image was created.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- Name of the AMI.
- os
Version string - Operating System version of the image.
- output
Resources ImageOutput Resource[] - List of objects with resources created by the image.
- platform string
- Platform of the image.
- {[key: string]: string}
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version string
- Version of the image.
- arn str
- Amazon Resource Name (ARN) of the image.
- date_
created str - Date the image was created.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- Name of the AMI.
- os_
version str - Operating System version of the image.
- output_
resources Sequence[ImageOutput Resource] - List of objects with resources created by the image.
- platform str
- Platform of the image.
- Mapping[str, str]
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version str
- Version of the image.
- arn String
- Amazon Resource Name (ARN) of the image.
- date
Created String - Date the image was created.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- Name of the AMI.
- os
Version String - Operating System version of the image.
- output
Resources List<Property Map> - List of objects with resources created by the image.
- platform String
- Platform of the image.
- Map<String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version String
- Version of the image.
Look up Existing Image Resource
Get an existing Image resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: ImageState, opts?: CustomResourceOptions): Image@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
arn: Optional[str] = None,
container_recipe_arn: Optional[str] = None,
date_created: Optional[str] = None,
distribution_configuration_arn: Optional[str] = None,
enhanced_image_metadata_enabled: Optional[bool] = None,
image_recipe_arn: Optional[str] = None,
image_tests_configuration: Optional[ImageImageTestsConfigurationArgs] = None,
infrastructure_configuration_arn: Optional[str] = None,
name: Optional[str] = None,
os_version: Optional[str] = None,
output_resources: Optional[Sequence[ImageOutputResourceArgs]] = None,
platform: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None,
version: Optional[str] = None) -> Imagefunc GetImage(ctx *Context, name string, id IDInput, state *ImageState, opts ...ResourceOption) (*Image, error)public static Image Get(string name, Input<string> id, ImageState? state, CustomResourceOptions? opts = null)public static Image get(String name, Output<String> id, ImageState state, CustomResourceOptions options)resources: _: type: aws:imagebuilder:Image get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Arn string
- Amazon Resource Name (ARN) of the image.
- Container
Recipe stringArn - Amazon Resource Name (ARN) of the container recipe.
- Date
Created string - Date the image was created.
- Distribution
Configuration stringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- Enhanced
Image boolMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - Image
Recipe stringArn - Amazon Resource Name (ARN) of the image recipe.
- Image
Tests ImageConfiguration Image Tests Configuration - Configuration block with image tests configuration. Detailed below.
- Infrastructure
Configuration stringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- Name string
- Name of the AMI.
- Os
Version string - Operating System version of the image.
- Output
Resources List<ImageOutput Resource> - List of objects with resources created by the image.
- Platform string
- Platform of the image.
- Dictionary<string, string>
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Dictionary<string, string>
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - Version string
- Version of the image.
- Arn string
- Amazon Resource Name (ARN) of the image.
- Container
Recipe stringArn - Amazon Resource Name (ARN) of the container recipe.
- Date
Created string - Date the image was created.
- Distribution
Configuration stringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- Enhanced
Image boolMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - Image
Recipe stringArn - Amazon Resource Name (ARN) of the image recipe.
- Image
Tests ImageConfiguration Image Tests Configuration Args - Configuration block with image tests configuration. Detailed below.
- Infrastructure
Configuration stringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- Name string
- Name of the AMI.
- Os
Version string - Operating System version of the image.
- Output
Resources []ImageOutput Resource Args - List of objects with resources created by the image.
- Platform string
- Platform of the image.
- map[string]string
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - map[string]string
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - Version string
- Version of the image.
- arn String
- Amazon Resource Name (ARN) of the image.
- container
Recipe StringArn - Amazon Resource Name (ARN) of the container recipe.
- date
Created String - Date the image was created.
- distribution
Configuration StringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced
Image BooleanMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - image
Recipe StringArn - Amazon Resource Name (ARN) of the image recipe.
- image
Tests ImageConfiguration Image Tests Configuration - Configuration block with image tests configuration. Detailed below.
- infrastructure
Configuration StringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- name String
- Name of the AMI.
- os
Version String - Operating System version of the image.
- output
Resources List<ImageOutput Resource> - List of objects with resources created by the image.
- platform String
- Platform of the image.
- Map<String,String>
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String,String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version String
- Version of the image.
- arn string
- Amazon Resource Name (ARN) of the image.
- container
Recipe stringArn - Amazon Resource Name (ARN) of the container recipe.
- date
Created string - Date the image was created.
- distribution
Configuration stringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced
Image booleanMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - image
Recipe stringArn - Amazon Resource Name (ARN) of the image recipe.
- image
Tests ImageConfiguration Image Tests Configuration - Configuration block with image tests configuration. Detailed below.
- infrastructure
Configuration stringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- name string
- Name of the AMI.
- os
Version string - Operating System version of the image.
- output
Resources ImageOutput Resource[] - List of objects with resources created by the image.
- platform string
- Platform of the image.
- {[key: string]: string}
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - {[key: string]: string}
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version string
- Version of the image.
- arn str
- Amazon Resource Name (ARN) of the image.
- container_
recipe_ strarn - Amazon Resource Name (ARN) of the container recipe.
- date_
created str - Date the image was created.
- distribution_
configuration_ strarn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced_
image_ boolmetadata_ enabled - Whether additional information about the image being created is collected. Defaults to
true. - image_
recipe_ strarn - Amazon Resource Name (ARN) of the image recipe.
- image_
tests_ Imageconfiguration Image Tests Configuration Args - Configuration block with image tests configuration. Detailed below.
- infrastructure_
configuration_ strarn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- name str
- Name of the AMI.
- os_
version str - Operating System version of the image.
- output_
resources Sequence[ImageOutput Resource Args] - List of objects with resources created by the image.
- platform str
- Platform of the image.
- Mapping[str, str]
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Mapping[str, str]
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version str
- Version of the image.
- arn String
- Amazon Resource Name (ARN) of the image.
- container
Recipe StringArn - Amazon Resource Name (ARN) of the container recipe.
- date
Created String - Date the image was created.
- distribution
Configuration StringArn - Amazon Resource Name (ARN) of the Image Builder Distribution Configuration.
- enhanced
Image BooleanMetadata Enabled - Whether additional information about the image being created is collected. Defaults to
true. - image
Recipe StringArn - Amazon Resource Name (ARN) of the image recipe.
- image
Tests Property MapConfiguration - Configuration block with image tests configuration. Detailed below.
- infrastructure
Configuration StringArn Amazon Resource Name (ARN) of the Image Builder Infrastructure Configuration.
The following arguments are optional:
- name String
- Name of the AMI.
- os
Version String - Operating System version of the image.
- output
Resources List<Property Map> - List of objects with resources created by the image.
- platform String
- Platform of the image.
- Map<String>
- Key-value map of resource tags for the Image Builder Image. If configured with a provider
default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tagsconfiguration block. - version String
- Version of the image.
Supporting Types
ImageImageTestsConfiguration, ImageImageTestsConfigurationArgs
- Image
Tests boolEnabled - Whether image tests are enabled. Defaults to
true. - Timeout
Minutes int - Number of minutes before image tests time out. Valid values are between
60and1440. Defaults to720.
- Image
Tests boolEnabled - Whether image tests are enabled. Defaults to
true. - Timeout
Minutes int - Number of minutes before image tests time out. Valid values are between
60and1440. Defaults to720.
- image
Tests BooleanEnabled - Whether image tests are enabled. Defaults to
true. - timeout
Minutes Integer - Number of minutes before image tests time out. Valid values are between
60and1440. Defaults to720.
- image
Tests booleanEnabled - Whether image tests are enabled. Defaults to
true. - timeout
Minutes number - Number of minutes before image tests time out. Valid values are between
60and1440. Defaults to720.
- image_
tests_ boolenabled - Whether image tests are enabled. Defaults to
true. - timeout_
minutes int - Number of minutes before image tests time out. Valid values are between
60and1440. Defaults to720.
- image
Tests BooleanEnabled - Whether image tests are enabled. Defaults to
true. - timeout
Minutes Number - Number of minutes before image tests time out. Valid values are between
60and1440. Defaults to720.
ImageOutputResource, ImageOutputResourceArgs
- Amis
List<Image
Output Resource Ami> - Set of objects with each Amazon Machine Image (AMI) created.
- Containers
List<Image
Output Resource Container> - Set of objects with each container image created and stored in the output repository.
- Amis
[]Image
Output Resource Ami - Set of objects with each Amazon Machine Image (AMI) created.
- Containers
[]Image
Output Resource Container - Set of objects with each container image created and stored in the output repository.
- amis
List<Image
Output Resource Ami> - Set of objects with each Amazon Machine Image (AMI) created.
- containers
List<Image
Output Resource Container> - Set of objects with each container image created and stored in the output repository.
- amis
Image
Output Resource Ami[] - Set of objects with each Amazon Machine Image (AMI) created.
- containers
Image
Output Resource Container[] - Set of objects with each container image created and stored in the output repository.
- amis
Sequence[Image
Output Resource Ami] - Set of objects with each Amazon Machine Image (AMI) created.
- containers
Sequence[Image
Output Resource Container] - Set of objects with each container image created and stored in the output repository.
- amis List<Property Map>
- Set of objects with each Amazon Machine Image (AMI) created.
- containers List<Property Map>
- Set of objects with each container image created and stored in the output repository.
ImageOutputResourceAmi, ImageOutputResourceAmiArgs
- Account
Id string - Account identifier of the AMI.
- Description string
- Description of the AMI.
- Image string
- Identifier of the AMI.
- Name string
- Name of the AMI.
- Region string
- Region of the container image.
- Account
Id string - Account identifier of the AMI.
- Description string
- Description of the AMI.
- Image string
- Identifier of the AMI.
- Name string
- Name of the AMI.
- Region string
- Region of the container image.
- account
Id String - Account identifier of the AMI.
- description String
- Description of the AMI.
- image String
- Identifier of the AMI.
- name String
- Name of the AMI.
- region String
- Region of the container image.
- account
Id string - Account identifier of the AMI.
- description string
- Description of the AMI.
- image string
- Identifier of the AMI.
- name string
- Name of the AMI.
- region string
- Region of the container image.
- account_
id str - Account identifier of the AMI.
- description str
- Description of the AMI.
- image str
- Identifier of the AMI.
- name str
- Name of the AMI.
- region str
- Region of the container image.
- account
Id String - Account identifier of the AMI.
- description String
- Description of the AMI.
- image String
- Identifier of the AMI.
- name String
- Name of the AMI.
- region String
- Region of the container image.
ImageOutputResourceContainer, ImageOutputResourceContainerArgs
- image_
uris Sequence[str] - Set of URIs for created containers.
- region str
- Region of the container image.
Import
aws_imagebuilder_image resources can be imported using the Amazon Resource Name (ARN), e.g.,
$ pulumi import aws:imagebuilder/image:Image example arn:aws:imagebuilder:us-east-1:123456789012:image/example/1.0.0/1
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
awsTerraform Provider.
published on Tuesday, Mar 10, 2026 by Pulumi
