Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS
  3. API Docs
  4. imagebuilder
  5. DistributionConfiguration
AWS v6.77.0 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-aws

aws.imagebuilder.DistributionConfiguration

Explore with Pulumi AI

AWS v6.77.0 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-aws

Manages an Image Builder Distribution Configuration.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.imagebuilder.DistributionConfiguration("example", {
    name: "example",
    distributions: [{
        amiDistributionConfiguration: {
            amiTags: {
                CostCenter: "IT",
            },
            name: "example-{{ imagebuilder:buildDate }}",
            launchPermission: {
                userIds: ["123456789012"],
            },
        },
        launchTemplateConfigurations: [{
            launchTemplateId: "lt-0aaa1bcde2ff3456",
        }],
        region: "us-east-1",
    }],
});
Copy
import pulumi
import pulumi_aws as aws

example = aws.imagebuilder.DistributionConfiguration("example",
    name="example",
    distributions=[{
        "ami_distribution_configuration": {
            "ami_tags": {
                "CostCenter": "IT",
            },
            "name": "example-{{ imagebuilder:buildDate }}",
            "launch_permission": {
                "user_ids": ["123456789012"],
            },
        },
        "launch_template_configurations": [{
            "launch_template_id": "lt-0aaa1bcde2ff3456",
        }],
        "region": "us-east-1",
    }])
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/imagebuilder"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := imagebuilder.NewDistributionConfiguration(ctx, "example", &imagebuilder.DistributionConfigurationArgs{
			Name: pulumi.String("example"),
			Distributions: imagebuilder.DistributionConfigurationDistributionArray{
				&imagebuilder.DistributionConfigurationDistributionArgs{
					AmiDistributionConfiguration: &imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationArgs{
						AmiTags: pulumi.StringMap{
							"CostCenter": pulumi.String("IT"),
						},
						Name: pulumi.String("example-{{ imagebuilder:buildDate }}"),
						LaunchPermission: &imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs{
							UserIds: pulumi.StringArray{
								pulumi.String("123456789012"),
							},
						},
					},
					LaunchTemplateConfigurations: imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArray{
						&imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs{
							LaunchTemplateId: pulumi.String("lt-0aaa1bcde2ff3456"),
						},
					},
					Region: pulumi.String("us-east-1"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.ImageBuilder.DistributionConfiguration("example", new()
    {
        Name = "example",
        Distributions = new[]
        {
            new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionArgs
            {
                AmiDistributionConfiguration = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionAmiDistributionConfigurationArgs
                {
                    AmiTags = 
                    {
                        { "CostCenter", "IT" },
                    },
                    Name = "example-{{ imagebuilder:buildDate }}",
                    LaunchPermission = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs
                    {
                        UserIds = new[]
                        {
                            "123456789012",
                        },
                    },
                },
                LaunchTemplateConfigurations = new[]
                {
                    new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs
                    {
                        LaunchTemplateId = "lt-0aaa1bcde2ff3456",
                    },
                },
                Region = "us-east-1",
            },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.imagebuilder.DistributionConfiguration;
import com.pulumi.aws.imagebuilder.DistributionConfigurationArgs;
import com.pulumi.aws.imagebuilder.inputs.DistributionConfigurationDistributionArgs;
import com.pulumi.aws.imagebuilder.inputs.DistributionConfigurationDistributionAmiDistributionConfigurationArgs;
import com.pulumi.aws.imagebuilder.inputs.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs;
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 DistributionConfiguration("example", DistributionConfigurationArgs.builder()
            .name("example")
            .distributions(DistributionConfigurationDistributionArgs.builder()
                .amiDistributionConfiguration(DistributionConfigurationDistributionAmiDistributionConfigurationArgs.builder()
                    .amiTags(Map.of("CostCenter", "IT"))
                    .name("example-{{ imagebuilder:buildDate }}")
                    .launchPermission(DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs.builder()
                        .userIds("123456789012")
                        .build())
                    .build())
                .launchTemplateConfigurations(DistributionConfigurationDistributionLaunchTemplateConfigurationArgs.builder()
                    .launchTemplateId("lt-0aaa1bcde2ff3456")
                    .build())
                .region("us-east-1")
                .build())
            .build());

    }
}
Copy
resources:
  example:
    type: aws:imagebuilder:DistributionConfiguration
    properties:
      name: example
      distributions:
        - amiDistributionConfiguration:
            amiTags:
              CostCenter: IT
            name: example-{{ imagebuilder:buildDate }}
            launchPermission:
              userIds:
                - '123456789012'
          launchTemplateConfigurations:
            - launchTemplateId: lt-0aaa1bcde2ff3456
          region: us-east-1
Copy

Create DistributionConfiguration Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new DistributionConfiguration(name: string, args: DistributionConfigurationArgs, opts?: CustomResourceOptions);
@overload
def DistributionConfiguration(resource_name: str,
                              args: DistributionConfigurationArgs,
                              opts: Optional[ResourceOptions] = None)

@overload
def DistributionConfiguration(resource_name: str,
                              opts: Optional[ResourceOptions] = None,
                              distributions: Optional[Sequence[DistributionConfigurationDistributionArgs]] = None,
                              description: Optional[str] = None,
                              name: Optional[str] = None,
                              tags: Optional[Mapping[str, str]] = None)
func NewDistributionConfiguration(ctx *Context, name string, args DistributionConfigurationArgs, opts ...ResourceOption) (*DistributionConfiguration, error)
public DistributionConfiguration(string name, DistributionConfigurationArgs args, CustomResourceOptions? opts = null)
public DistributionConfiguration(String name, DistributionConfigurationArgs args)
public DistributionConfiguration(String name, DistributionConfigurationArgs args, CustomResourceOptions options)

type: aws:imagebuilder:DistributionConfiguration
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. DistributionConfigurationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. DistributionConfigurationArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. DistributionConfigurationArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. DistributionConfigurationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. DistributionConfigurationArgs
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 distributionConfigurationResource = new Aws.ImageBuilder.DistributionConfiguration("distributionConfigurationResource", new()
{
    Distributions = new[]
    {
        new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionArgs
        {
            Region = "string",
            AmiDistributionConfiguration = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionAmiDistributionConfigurationArgs
            {
                AmiTags = 
                {
                    { "string", "string" },
                },
                Description = "string",
                KmsKeyId = "string",
                LaunchPermission = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs
                {
                    OrganizationArns = new[]
                    {
                        "string",
                    },
                    OrganizationalUnitArns = new[]
                    {
                        "string",
                    },
                    UserGroups = new[]
                    {
                        "string",
                    },
                    UserIds = new[]
                    {
                        "string",
                    },
                },
                Name = "string",
                TargetAccountIds = new[]
                {
                    "string",
                },
            },
            ContainerDistributionConfiguration = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionContainerDistributionConfigurationArgs
            {
                TargetRepository = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepositoryArgs
                {
                    RepositoryName = "string",
                    Service = "string",
                },
                ContainerTags = new[]
                {
                    "string",
                },
                Description = "string",
            },
            FastLaunchConfigurations = new[]
            {
                new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionFastLaunchConfigurationArgs
                {
                    AccountId = "string",
                    Enabled = false,
                    LaunchTemplate = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplateArgs
                    {
                        LaunchTemplateId = "string",
                        LaunchTemplateName = "string",
                        LaunchTemplateVersion = "string",
                    },
                    MaxParallelLaunches = 0,
                    SnapshotConfiguration = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfigurationArgs
                    {
                        TargetResourceCount = 0,
                    },
                },
            },
            LaunchTemplateConfigurations = new[]
            {
                new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs
                {
                    LaunchTemplateId = "string",
                    AccountId = "string",
                    Default = false,
                },
            },
            LicenseConfigurationArns = new[]
            {
                "string",
            },
            S3ExportConfiguration = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionS3ExportConfigurationArgs
            {
                DiskImageFormat = "string",
                RoleName = "string",
                S3Bucket = "string",
                S3Prefix = "string",
            },
        },
    },
    Description = "string",
    Name = "string",
    Tags = 
    {
        { "string", "string" },
    },
});
Copy
example, err := imagebuilder.NewDistributionConfiguration(ctx, "distributionConfigurationResource", &imagebuilder.DistributionConfigurationArgs{
	Distributions: imagebuilder.DistributionConfigurationDistributionArray{
		&imagebuilder.DistributionConfigurationDistributionArgs{
			Region: pulumi.String("string"),
			AmiDistributionConfiguration: &imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationArgs{
				AmiTags: pulumi.StringMap{
					"string": pulumi.String("string"),
				},
				Description: pulumi.String("string"),
				KmsKeyId:    pulumi.String("string"),
				LaunchPermission: &imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs{
					OrganizationArns: pulumi.StringArray{
						pulumi.String("string"),
					},
					OrganizationalUnitArns: pulumi.StringArray{
						pulumi.String("string"),
					},
					UserGroups: pulumi.StringArray{
						pulumi.String("string"),
					},
					UserIds: pulumi.StringArray{
						pulumi.String("string"),
					},
				},
				Name: pulumi.String("string"),
				TargetAccountIds: pulumi.StringArray{
					pulumi.String("string"),
				},
			},
			ContainerDistributionConfiguration: &imagebuilder.DistributionConfigurationDistributionContainerDistributionConfigurationArgs{
				TargetRepository: &imagebuilder.DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepositoryArgs{
					RepositoryName: pulumi.String("string"),
					Service:        pulumi.String("string"),
				},
				ContainerTags: pulumi.StringArray{
					pulumi.String("string"),
				},
				Description: pulumi.String("string"),
			},
			FastLaunchConfigurations: imagebuilder.DistributionConfigurationDistributionFastLaunchConfigurationArray{
				&imagebuilder.DistributionConfigurationDistributionFastLaunchConfigurationArgs{
					AccountId: pulumi.String("string"),
					Enabled:   pulumi.Bool(false),
					LaunchTemplate: &imagebuilder.DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplateArgs{
						LaunchTemplateId:      pulumi.String("string"),
						LaunchTemplateName:    pulumi.String("string"),
						LaunchTemplateVersion: pulumi.String("string"),
					},
					MaxParallelLaunches: pulumi.Int(0),
					SnapshotConfiguration: &imagebuilder.DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfigurationArgs{
						TargetResourceCount: pulumi.Int(0),
					},
				},
			},
			LaunchTemplateConfigurations: imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArray{
				&imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs{
					LaunchTemplateId: pulumi.String("string"),
					AccountId:        pulumi.String("string"),
					Default:          pulumi.Bool(false),
				},
			},
			LicenseConfigurationArns: pulumi.StringArray{
				pulumi.String("string"),
			},
			S3ExportConfiguration: &imagebuilder.DistributionConfigurationDistributionS3ExportConfigurationArgs{
				DiskImageFormat: pulumi.String("string"),
				RoleName:        pulumi.String("string"),
				S3Bucket:        pulumi.String("string"),
				S3Prefix:        pulumi.String("string"),
			},
		},
	},
	Description: pulumi.String("string"),
	Name:        pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
})
Copy
var distributionConfigurationResource = new DistributionConfiguration("distributionConfigurationResource", DistributionConfigurationArgs.builder()
    .distributions(DistributionConfigurationDistributionArgs.builder()
        .region("string")
        .amiDistributionConfiguration(DistributionConfigurationDistributionAmiDistributionConfigurationArgs.builder()
            .amiTags(Map.of("string", "string"))
            .description("string")
            .kmsKeyId("string")
            .launchPermission(DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs.builder()
                .organizationArns("string")
                .organizationalUnitArns("string")
                .userGroups("string")
                .userIds("string")
                .build())
            .name("string")
            .targetAccountIds("string")
            .build())
        .containerDistributionConfiguration(DistributionConfigurationDistributionContainerDistributionConfigurationArgs.builder()
            .targetRepository(DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepositoryArgs.builder()
                .repositoryName("string")
                .service("string")
                .build())
            .containerTags("string")
            .description("string")
            .build())
        .fastLaunchConfigurations(DistributionConfigurationDistributionFastLaunchConfigurationArgs.builder()
            .accountId("string")
            .enabled(false)
            .launchTemplate(DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplateArgs.builder()
                .launchTemplateId("string")
                .launchTemplateName("string")
                .launchTemplateVersion("string")
                .build())
            .maxParallelLaunches(0)
            .snapshotConfiguration(DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfigurationArgs.builder()
                .targetResourceCount(0)
                .build())
            .build())
        .launchTemplateConfigurations(DistributionConfigurationDistributionLaunchTemplateConfigurationArgs.builder()
            .launchTemplateId("string")
            .accountId("string")
            .default_(false)
            .build())
        .licenseConfigurationArns("string")
        .s3ExportConfiguration(DistributionConfigurationDistributionS3ExportConfigurationArgs.builder()
            .diskImageFormat("string")
            .roleName("string")
            .s3Bucket("string")
            .s3Prefix("string")
            .build())
        .build())
    .description("string")
    .name("string")
    .tags(Map.of("string", "string"))
    .build());
Copy
distribution_configuration_resource = aws.imagebuilder.DistributionConfiguration("distributionConfigurationResource",
    distributions=[{
        "region": "string",
        "ami_distribution_configuration": {
            "ami_tags": {
                "string": "string",
            },
            "description": "string",
            "kms_key_id": "string",
            "launch_permission": {
                "organization_arns": ["string"],
                "organizational_unit_arns": ["string"],
                "user_groups": ["string"],
                "user_ids": ["string"],
            },
            "name": "string",
            "target_account_ids": ["string"],
        },
        "container_distribution_configuration": {
            "target_repository": {
                "repository_name": "string",
                "service": "string",
            },
            "container_tags": ["string"],
            "description": "string",
        },
        "fast_launch_configurations": [{
            "account_id": "string",
            "enabled": False,
            "launch_template": {
                "launch_template_id": "string",
                "launch_template_name": "string",
                "launch_template_version": "string",
            },
            "max_parallel_launches": 0,
            "snapshot_configuration": {
                "target_resource_count": 0,
            },
        }],
        "launch_template_configurations": [{
            "launch_template_id": "string",
            "account_id": "string",
            "default": False,
        }],
        "license_configuration_arns": ["string"],
        "s3_export_configuration": {
            "disk_image_format": "string",
            "role_name": "string",
            "s3_bucket": "string",
            "s3_prefix": "string",
        },
    }],
    description="string",
    name="string",
    tags={
        "string": "string",
    })
Copy
const distributionConfigurationResource = new aws.imagebuilder.DistributionConfiguration("distributionConfigurationResource", {
    distributions: [{
        region: "string",
        amiDistributionConfiguration: {
            amiTags: {
                string: "string",
            },
            description: "string",
            kmsKeyId: "string",
            launchPermission: {
                organizationArns: ["string"],
                organizationalUnitArns: ["string"],
                userGroups: ["string"],
                userIds: ["string"],
            },
            name: "string",
            targetAccountIds: ["string"],
        },
        containerDistributionConfiguration: {
            targetRepository: {
                repositoryName: "string",
                service: "string",
            },
            containerTags: ["string"],
            description: "string",
        },
        fastLaunchConfigurations: [{
            accountId: "string",
            enabled: false,
            launchTemplate: {
                launchTemplateId: "string",
                launchTemplateName: "string",
                launchTemplateVersion: "string",
            },
            maxParallelLaunches: 0,
            snapshotConfiguration: {
                targetResourceCount: 0,
            },
        }],
        launchTemplateConfigurations: [{
            launchTemplateId: "string",
            accountId: "string",
            "default": false,
        }],
        licenseConfigurationArns: ["string"],
        s3ExportConfiguration: {
            diskImageFormat: "string",
            roleName: "string",
            s3Bucket: "string",
            s3Prefix: "string",
        },
    }],
    description: "string",
    name: "string",
    tags: {
        string: "string",
    },
});
Copy
type: aws:imagebuilder:DistributionConfiguration
properties:
    description: string
    distributions:
        - amiDistributionConfiguration:
            amiTags:
                string: string
            description: string
            kmsKeyId: string
            launchPermission:
                organizationArns:
                    - string
                organizationalUnitArns:
                    - string
                userGroups:
                    - string
                userIds:
                    - string
            name: string
            targetAccountIds:
                - string
          containerDistributionConfiguration:
            containerTags:
                - string
            description: string
            targetRepository:
                repositoryName: string
                service: string
          fastLaunchConfigurations:
            - accountId: string
              enabled: false
              launchTemplate:
                launchTemplateId: string
                launchTemplateName: string
                launchTemplateVersion: string
              maxParallelLaunches: 0
              snapshotConfiguration:
                targetResourceCount: 0
          launchTemplateConfigurations:
            - accountId: string
              default: false
              launchTemplateId: string
          licenseConfigurationArns:
            - string
          region: string
          s3ExportConfiguration:
            diskImageFormat: string
            roleName: string
            s3Bucket: string
            s3Prefix: string
    name: string
    tags:
        string: string
Copy

DistributionConfiguration 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 DistributionConfiguration resource accepts the following input properties:

Distributions This property is required. List<DistributionConfigurationDistribution>

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

Description string
Description of the distribution configuration.
Name Changes to this property will trigger replacement. string
Name of the distribution configuration.
Tags Dictionary<string, string>
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
Distributions This property is required. []DistributionConfigurationDistributionArgs

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

Description string
Description of the distribution configuration.
Name Changes to this property will trigger replacement. string
Name of the distribution configuration.
Tags map[string]string
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
distributions This property is required. List<DistributionConfigurationDistribution>

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

description String
Description of the distribution configuration.
name Changes to this property will trigger replacement. String
Name of the distribution configuration.
tags Map<String,String>
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
distributions This property is required. DistributionConfigurationDistribution[]

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

description string
Description of the distribution configuration.
name Changes to this property will trigger replacement. string
Name of the distribution configuration.
tags {[key: string]: string}
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
distributions This property is required. Sequence[DistributionConfigurationDistributionArgs]

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

description str
Description of the distribution configuration.
name Changes to this property will trigger replacement. str
Name of the distribution configuration.
tags Mapping[str, str]
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
distributions This property is required. List<Property Map>

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

description String
Description of the distribution configuration.
name Changes to this property will trigger replacement. String
Name of the distribution configuration.
tags Map<String>
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration 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 DistributionConfiguration resource produces the following output properties:

Arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
DateCreated string
Date the distribution configuration was created.
DateUpdated string
Date the distribution configuration was updated.
Id string
The provider-assigned unique ID for this managed resource.
TagsAll Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
DateCreated string
Date the distribution configuration was created.
DateUpdated string
Date the distribution configuration was updated.
Id string
The provider-assigned unique ID for this managed resource.
TagsAll map[string]string
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
dateCreated String
Date the distribution configuration was created.
dateUpdated String
Date the distribution configuration was updated.
id String
The provider-assigned unique ID for this managed resource.
tagsAll Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
dateCreated string
Date the distribution configuration was created.
dateUpdated string
Date the distribution configuration was updated.
id string
The provider-assigned unique ID for this managed resource.
tagsAll {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn str
(Required) Amazon Resource Name (ARN) of the distribution configuration.
date_created str
Date the distribution configuration was created.
date_updated str
Date the distribution configuration was updated.
id str
The provider-assigned unique ID for this managed resource.
tags_all Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
dateCreated String
Date the distribution configuration was created.
dateUpdated String
Date the distribution configuration was updated.
id String
The provider-assigned unique ID for this managed resource.
tagsAll Map<String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Look up Existing DistributionConfiguration Resource

Get an existing DistributionConfiguration 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?: DistributionConfigurationState, opts?: CustomResourceOptions): DistributionConfiguration
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        arn: Optional[str] = None,
        date_created: Optional[str] = None,
        date_updated: Optional[str] = None,
        description: Optional[str] = None,
        distributions: Optional[Sequence[DistributionConfigurationDistributionArgs]] = None,
        name: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        tags_all: Optional[Mapping[str, str]] = None) -> DistributionConfiguration
func GetDistributionConfiguration(ctx *Context, name string, id IDInput, state *DistributionConfigurationState, opts ...ResourceOption) (*DistributionConfiguration, error)
public static DistributionConfiguration Get(string name, Input<string> id, DistributionConfigurationState? state, CustomResourceOptions? opts = null)
public static DistributionConfiguration get(String name, Output<String> id, DistributionConfigurationState state, CustomResourceOptions options)
resources:  _:    type: aws:imagebuilder:DistributionConfiguration    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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.
The following state arguments are supported:
Arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
DateCreated string
Date the distribution configuration was created.
DateUpdated string
Date the distribution configuration was updated.
Description string
Description of the distribution configuration.
Distributions List<DistributionConfigurationDistribution>

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

Name Changes to this property will trigger replacement. string
Name of the distribution configuration.
Tags Dictionary<string, string>
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
TagsAll Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
DateCreated string
Date the distribution configuration was created.
DateUpdated string
Date the distribution configuration was updated.
Description string
Description of the distribution configuration.
Distributions []DistributionConfigurationDistributionArgs

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

Name Changes to this property will trigger replacement. string
Name of the distribution configuration.
Tags map[string]string
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
TagsAll map[string]string
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
dateCreated String
Date the distribution configuration was created.
dateUpdated String
Date the distribution configuration was updated.
description String
Description of the distribution configuration.
distributions List<DistributionConfigurationDistribution>

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

name Changes to this property will trigger replacement. String
Name of the distribution configuration.
tags Map<String,String>
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tagsAll Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
dateCreated string
Date the distribution configuration was created.
dateUpdated string
Date the distribution configuration was updated.
description string
Description of the distribution configuration.
distributions DistributionConfigurationDistribution[]

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

name Changes to this property will trigger replacement. string
Name of the distribution configuration.
tags {[key: string]: string}
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tagsAll {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn str
(Required) Amazon Resource Name (ARN) of the distribution configuration.
date_created str
Date the distribution configuration was created.
date_updated str
Date the distribution configuration was updated.
description str
Description of the distribution configuration.
distributions Sequence[DistributionConfigurationDistributionArgs]

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

name Changes to this property will trigger replacement. str
Name of the distribution configuration.
tags Mapping[str, str]
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tags_all Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
dateCreated String
Date the distribution configuration was created.
dateUpdated String
Date the distribution configuration was updated.
description String
Description of the distribution configuration.
distributions List<Property Map>

One or more configuration blocks with distribution settings. Detailed below.

The following arguments are optional:

name Changes to this property will trigger replacement. String
Name of the distribution configuration.
tags Map<String>
Key-value map of resource tags for the distribution configuration. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tagsAll Map<String>
A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

Deprecated: Please use tags instead.

Supporting Types

DistributionConfigurationDistribution
, DistributionConfigurationDistributionArgs

Region This property is required. string

AWS Region for the distribution.

The following arguments are optional:

AmiDistributionConfiguration DistributionConfigurationDistributionAmiDistributionConfiguration
Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
ContainerDistributionConfiguration DistributionConfigurationDistributionContainerDistributionConfiguration
Configuration block with container distribution settings. Detailed below.
FastLaunchConfigurations List<DistributionConfigurationDistributionFastLaunchConfiguration>
Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
LaunchTemplateConfigurations List<DistributionConfigurationDistributionLaunchTemplateConfiguration>
Set of launch template configuration settings that apply to image distribution. Detailed below.
LicenseConfigurationArns List<string>
Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
S3ExportConfiguration DistributionConfigurationDistributionS3ExportConfiguration
Configuration block with S3 export settings. Detailed below.
Region This property is required. string

AWS Region for the distribution.

The following arguments are optional:

AmiDistributionConfiguration DistributionConfigurationDistributionAmiDistributionConfiguration
Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
ContainerDistributionConfiguration DistributionConfigurationDistributionContainerDistributionConfiguration
Configuration block with container distribution settings. Detailed below.
FastLaunchConfigurations []DistributionConfigurationDistributionFastLaunchConfiguration
Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
LaunchTemplateConfigurations []DistributionConfigurationDistributionLaunchTemplateConfiguration
Set of launch template configuration settings that apply to image distribution. Detailed below.
LicenseConfigurationArns []string
Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
S3ExportConfiguration DistributionConfigurationDistributionS3ExportConfiguration
Configuration block with S3 export settings. Detailed below.
region This property is required. String

AWS Region for the distribution.

The following arguments are optional:

amiDistributionConfiguration DistributionConfigurationDistributionAmiDistributionConfiguration
Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
containerDistributionConfiguration DistributionConfigurationDistributionContainerDistributionConfiguration
Configuration block with container distribution settings. Detailed below.
fastLaunchConfigurations List<DistributionConfigurationDistributionFastLaunchConfiguration>
Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
launchTemplateConfigurations List<DistributionConfigurationDistributionLaunchTemplateConfiguration>
Set of launch template configuration settings that apply to image distribution. Detailed below.
licenseConfigurationArns List<String>
Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
s3ExportConfiguration DistributionConfigurationDistributionS3ExportConfiguration
Configuration block with S3 export settings. Detailed below.
region This property is required. string

AWS Region for the distribution.

The following arguments are optional:

amiDistributionConfiguration DistributionConfigurationDistributionAmiDistributionConfiguration
Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
containerDistributionConfiguration DistributionConfigurationDistributionContainerDistributionConfiguration
Configuration block with container distribution settings. Detailed below.
fastLaunchConfigurations DistributionConfigurationDistributionFastLaunchConfiguration[]
Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
launchTemplateConfigurations DistributionConfigurationDistributionLaunchTemplateConfiguration[]
Set of launch template configuration settings that apply to image distribution. Detailed below.
licenseConfigurationArns string[]
Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
s3ExportConfiguration DistributionConfigurationDistributionS3ExportConfiguration
Configuration block with S3 export settings. Detailed below.
region This property is required. str

AWS Region for the distribution.

The following arguments are optional:

ami_distribution_configuration DistributionConfigurationDistributionAmiDistributionConfiguration
Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
container_distribution_configuration DistributionConfigurationDistributionContainerDistributionConfiguration
Configuration block with container distribution settings. Detailed below.
fast_launch_configurations Sequence[DistributionConfigurationDistributionFastLaunchConfiguration]
Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
launch_template_configurations Sequence[DistributionConfigurationDistributionLaunchTemplateConfiguration]
Set of launch template configuration settings that apply to image distribution. Detailed below.
license_configuration_arns Sequence[str]
Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
s3_export_configuration DistributionConfigurationDistributionS3ExportConfiguration
Configuration block with S3 export settings. Detailed below.
region This property is required. String

AWS Region for the distribution.

The following arguments are optional:

amiDistributionConfiguration Property Map
Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
containerDistributionConfiguration Property Map
Configuration block with container distribution settings. Detailed below.
fastLaunchConfigurations List<Property Map>
Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
launchTemplateConfigurations List<Property Map>
Set of launch template configuration settings that apply to image distribution. Detailed below.
licenseConfigurationArns List<String>
Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
s3ExportConfiguration Property Map
Configuration block with S3 export settings. Detailed below.

DistributionConfigurationDistributionAmiDistributionConfiguration
, DistributionConfigurationDistributionAmiDistributionConfigurationArgs

AmiTags Dictionary<string, string>
Key-value map of tags to apply to the distributed AMI.
Description string
Description to apply to the distributed AMI.
KmsKeyId string
Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
LaunchPermission DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermission
Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
Name string
Name to apply to the distributed AMI.
TargetAccountIds List<string>
Set of AWS Account identifiers to distribute the AMI.
AmiTags map[string]string
Key-value map of tags to apply to the distributed AMI.
Description string
Description to apply to the distributed AMI.
KmsKeyId string
Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
LaunchPermission DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermission
Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
Name string
Name to apply to the distributed AMI.
TargetAccountIds []string
Set of AWS Account identifiers to distribute the AMI.
amiTags Map<String,String>
Key-value map of tags to apply to the distributed AMI.
description String
Description to apply to the distributed AMI.
kmsKeyId String
Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
launchPermission DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermission
Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
name String
Name to apply to the distributed AMI.
targetAccountIds List<String>
Set of AWS Account identifiers to distribute the AMI.
amiTags {[key: string]: string}
Key-value map of tags to apply to the distributed AMI.
description string
Description to apply to the distributed AMI.
kmsKeyId string
Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
launchPermission DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermission
Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
name string
Name to apply to the distributed AMI.
targetAccountIds string[]
Set of AWS Account identifiers to distribute the AMI.
ami_tags Mapping[str, str]
Key-value map of tags to apply to the distributed AMI.
description str
Description to apply to the distributed AMI.
kms_key_id str
Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
launch_permission DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermission
Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
name str
Name to apply to the distributed AMI.
target_account_ids Sequence[str]
Set of AWS Account identifiers to distribute the AMI.
amiTags Map<String>
Key-value map of tags to apply to the distributed AMI.
description String
Description to apply to the distributed AMI.
kmsKeyId String
Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
launchPermission Property Map
Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
name String
Name to apply to the distributed AMI.
targetAccountIds List<String>
Set of AWS Account identifiers to distribute the AMI.

DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermission
, DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs

OrganizationArns List<string>
Set of AWS Organization ARNs to assign.
OrganizationalUnitArns List<string>
Set of AWS Organizational Unit ARNs to assign.
UserGroups List<string>
Set of EC2 launch permission user groups to assign. Use all to distribute a public AMI.
UserIds List<string>
Set of AWS Account identifiers to assign.
OrganizationArns []string
Set of AWS Organization ARNs to assign.
OrganizationalUnitArns []string
Set of AWS Organizational Unit ARNs to assign.
UserGroups []string
Set of EC2 launch permission user groups to assign. Use all to distribute a public AMI.
UserIds []string
Set of AWS Account identifiers to assign.
organizationArns List<String>
Set of AWS Organization ARNs to assign.
organizationalUnitArns List<String>
Set of AWS Organizational Unit ARNs to assign.
userGroups List<String>
Set of EC2 launch permission user groups to assign. Use all to distribute a public AMI.
userIds List<String>
Set of AWS Account identifiers to assign.
organizationArns string[]
Set of AWS Organization ARNs to assign.
organizationalUnitArns string[]
Set of AWS Organizational Unit ARNs to assign.
userGroups string[]
Set of EC2 launch permission user groups to assign. Use all to distribute a public AMI.
userIds string[]
Set of AWS Account identifiers to assign.
organization_arns Sequence[str]
Set of AWS Organization ARNs to assign.
organizational_unit_arns Sequence[str]
Set of AWS Organizational Unit ARNs to assign.
user_groups Sequence[str]
Set of EC2 launch permission user groups to assign. Use all to distribute a public AMI.
user_ids Sequence[str]
Set of AWS Account identifiers to assign.
organizationArns List<String>
Set of AWS Organization ARNs to assign.
organizationalUnitArns List<String>
Set of AWS Organizational Unit ARNs to assign.
userGroups List<String>
Set of EC2 launch permission user groups to assign. Use all to distribute a public AMI.
userIds List<String>
Set of AWS Account identifiers to assign.

DistributionConfigurationDistributionContainerDistributionConfiguration
, DistributionConfigurationDistributionContainerDistributionConfigurationArgs

TargetRepository This property is required. DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepository
Configuration block with the destination repository for the container distribution configuration.
ContainerTags List<string>
Set of tags that are attached to the container distribution configuration.
Description string
Description of the container distribution configuration.
TargetRepository This property is required. DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepository
Configuration block with the destination repository for the container distribution configuration.
ContainerTags []string
Set of tags that are attached to the container distribution configuration.
Description string
Description of the container distribution configuration.
targetRepository This property is required. DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepository
Configuration block with the destination repository for the container distribution configuration.
containerTags List<String>
Set of tags that are attached to the container distribution configuration.
description String
Description of the container distribution configuration.
targetRepository This property is required. DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepository
Configuration block with the destination repository for the container distribution configuration.
containerTags string[]
Set of tags that are attached to the container distribution configuration.
description string
Description of the container distribution configuration.
target_repository This property is required. DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepository
Configuration block with the destination repository for the container distribution configuration.
container_tags Sequence[str]
Set of tags that are attached to the container distribution configuration.
description str
Description of the container distribution configuration.
targetRepository This property is required. Property Map
Configuration block with the destination repository for the container distribution configuration.
containerTags List<String>
Set of tags that are attached to the container distribution configuration.
description String
Description of the container distribution configuration.

DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepository
, DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepositoryArgs

RepositoryName This property is required. string
The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
Service This property is required. string
The service in which this image is registered. Valid values: ECR.
RepositoryName This property is required. string
The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
Service This property is required. string
The service in which this image is registered. Valid values: ECR.
repositoryName This property is required. String
The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
service This property is required. String
The service in which this image is registered. Valid values: ECR.
repositoryName This property is required. string
The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
service This property is required. string
The service in which this image is registered. Valid values: ECR.
repository_name This property is required. str
The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
service This property is required. str
The service in which this image is registered. Valid values: ECR.
repositoryName This property is required. String
The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
service This property is required. String
The service in which this image is registered. Valid values: ECR.

DistributionConfigurationDistributionFastLaunchConfiguration
, DistributionConfigurationDistributionFastLaunchConfigurationArgs

AccountId This property is required. string
The owner account ID for the fast-launch enabled Windows AMI.
Enabled This property is required. bool
A Boolean that represents the current state of faster launching for the Windows AMI. Set to true to start using Windows faster launching, or false to stop using it.
LaunchTemplate DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplate
Configuration block for the launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots. Detailed below.
MaxParallelLaunches int
The maximum number of parallel instances that are launched for creating resources.
SnapshotConfiguration DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfiguration
Configuration block for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled. Detailed below.
AccountId This property is required. string
The owner account ID for the fast-launch enabled Windows AMI.
Enabled This property is required. bool
A Boolean that represents the current state of faster launching for the Windows AMI. Set to true to start using Windows faster launching, or false to stop using it.
LaunchTemplate DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplate
Configuration block for the launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots. Detailed below.
MaxParallelLaunches int
The maximum number of parallel instances that are launched for creating resources.
SnapshotConfiguration DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfiguration
Configuration block for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled. Detailed below.
accountId This property is required. String
The owner account ID for the fast-launch enabled Windows AMI.
enabled This property is required. Boolean
A Boolean that represents the current state of faster launching for the Windows AMI. Set to true to start using Windows faster launching, or false to stop using it.
launchTemplate DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplate
Configuration block for the launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots. Detailed below.
maxParallelLaunches Integer
The maximum number of parallel instances that are launched for creating resources.
snapshotConfiguration DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfiguration
Configuration block for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled. Detailed below.
accountId This property is required. string
The owner account ID for the fast-launch enabled Windows AMI.
enabled This property is required. boolean
A Boolean that represents the current state of faster launching for the Windows AMI. Set to true to start using Windows faster launching, or false to stop using it.
launchTemplate DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplate
Configuration block for the launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots. Detailed below.
maxParallelLaunches number
The maximum number of parallel instances that are launched for creating resources.
snapshotConfiguration DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfiguration
Configuration block for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled. Detailed below.
account_id This property is required. str
The owner account ID for the fast-launch enabled Windows AMI.
enabled This property is required. bool
A Boolean that represents the current state of faster launching for the Windows AMI. Set to true to start using Windows faster launching, or false to stop using it.
launch_template DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplate
Configuration block for the launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots. Detailed below.
max_parallel_launches int
The maximum number of parallel instances that are launched for creating resources.
snapshot_configuration DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfiguration
Configuration block for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled. Detailed below.
accountId This property is required. String
The owner account ID for the fast-launch enabled Windows AMI.
enabled This property is required. Boolean
A Boolean that represents the current state of faster launching for the Windows AMI. Set to true to start using Windows faster launching, or false to stop using it.
launchTemplate Property Map
Configuration block for the launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots. Detailed below.
maxParallelLaunches Number
The maximum number of parallel instances that are launched for creating resources.
snapshotConfiguration Property Map
Configuration block for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled. Detailed below.

DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplate
, DistributionConfigurationDistributionFastLaunchConfigurationLaunchTemplateArgs

LaunchTemplateId string
The ID of the launch template to use for faster launching for a Windows AMI.
LaunchTemplateName string
The name of the launch template to use for faster launching for a Windows AMI.
LaunchTemplateVersion string
The version of the launch template to use for faster launching for a Windows AMI.
LaunchTemplateId string
The ID of the launch template to use for faster launching for a Windows AMI.
LaunchTemplateName string
The name of the launch template to use for faster launching for a Windows AMI.
LaunchTemplateVersion string
The version of the launch template to use for faster launching for a Windows AMI.
launchTemplateId String
The ID of the launch template to use for faster launching for a Windows AMI.
launchTemplateName String
The name of the launch template to use for faster launching for a Windows AMI.
launchTemplateVersion String
The version of the launch template to use for faster launching for a Windows AMI.
launchTemplateId string
The ID of the launch template to use for faster launching for a Windows AMI.
launchTemplateName string
The name of the launch template to use for faster launching for a Windows AMI.
launchTemplateVersion string
The version of the launch template to use for faster launching for a Windows AMI.
launch_template_id str
The ID of the launch template to use for faster launching for a Windows AMI.
launch_template_name str
The name of the launch template to use for faster launching for a Windows AMI.
launch_template_version str
The version of the launch template to use for faster launching for a Windows AMI.
launchTemplateId String
The ID of the launch template to use for faster launching for a Windows AMI.
launchTemplateName String
The name of the launch template to use for faster launching for a Windows AMI.
launchTemplateVersion String
The version of the launch template to use for faster launching for a Windows AMI.

DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfiguration
, DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfigurationArgs

TargetResourceCount int
The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
TargetResourceCount int
The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
targetResourceCount Integer
The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
targetResourceCount number
The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
target_resource_count int
The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
targetResourceCount Number
The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.

DistributionConfigurationDistributionLaunchTemplateConfiguration
, DistributionConfigurationDistributionLaunchTemplateConfigurationArgs

LaunchTemplateId This property is required. string
The ID of the Amazon EC2 launch template to use.
AccountId string
The account ID that this configuration applies to.
Default bool
Indicates whether to set the specified Amazon EC2 launch template as the default launch template. Defaults to true.
LaunchTemplateId This property is required. string
The ID of the Amazon EC2 launch template to use.
AccountId string
The account ID that this configuration applies to.
Default bool
Indicates whether to set the specified Amazon EC2 launch template as the default launch template. Defaults to true.
launchTemplateId This property is required. String
The ID of the Amazon EC2 launch template to use.
accountId String
The account ID that this configuration applies to.
default_ Boolean
Indicates whether to set the specified Amazon EC2 launch template as the default launch template. Defaults to true.
launchTemplateId This property is required. string
The ID of the Amazon EC2 launch template to use.
accountId string
The account ID that this configuration applies to.
default boolean
Indicates whether to set the specified Amazon EC2 launch template as the default launch template. Defaults to true.
launch_template_id This property is required. str
The ID of the Amazon EC2 launch template to use.
account_id str
The account ID that this configuration applies to.
default bool
Indicates whether to set the specified Amazon EC2 launch template as the default launch template. Defaults to true.
launchTemplateId This property is required. String
The ID of the Amazon EC2 launch template to use.
accountId String
The account ID that this configuration applies to.
default Boolean
Indicates whether to set the specified Amazon EC2 launch template as the default launch template. Defaults to true.

DistributionConfigurationDistributionS3ExportConfiguration
, DistributionConfigurationDistributionS3ExportConfigurationArgs

DiskImageFormat This property is required. string
The disk image format of the exported image (RAW, VHD, or VMDK)
RoleName This property is required. string
The name of the IAM role to use for exporting.
S3Bucket This property is required. string
The name of the S3 bucket to store the exported image in. The bucket needs to exist before the export configuration is created.
S3Prefix string
The prefix for the exported image.
DiskImageFormat This property is required. string
The disk image format of the exported image (RAW, VHD, or VMDK)
RoleName This property is required. string
The name of the IAM role to use for exporting.
S3Bucket This property is required. string
The name of the S3 bucket to store the exported image in. The bucket needs to exist before the export configuration is created.
S3Prefix string
The prefix for the exported image.
diskImageFormat This property is required. String
The disk image format of the exported image (RAW, VHD, or VMDK)
roleName This property is required. String
The name of the IAM role to use for exporting.
s3Bucket This property is required. String
The name of the S3 bucket to store the exported image in. The bucket needs to exist before the export configuration is created.
s3Prefix String
The prefix for the exported image.
diskImageFormat This property is required. string
The disk image format of the exported image (RAW, VHD, or VMDK)
roleName This property is required. string
The name of the IAM role to use for exporting.
s3Bucket This property is required. string
The name of the S3 bucket to store the exported image in. The bucket needs to exist before the export configuration is created.
s3Prefix string
The prefix for the exported image.
disk_image_format This property is required. str
The disk image format of the exported image (RAW, VHD, or VMDK)
role_name This property is required. str
The name of the IAM role to use for exporting.
s3_bucket This property is required. str
The name of the S3 bucket to store the exported image in. The bucket needs to exist before the export configuration is created.
s3_prefix str
The prefix for the exported image.
diskImageFormat This property is required. String
The disk image format of the exported image (RAW, VHD, or VMDK)
roleName This property is required. String
The name of the IAM role to use for exporting.
s3Bucket This property is required. String
The name of the S3 bucket to store the exported image in. The bucket needs to exist before the export configuration is created.
s3Prefix String
The prefix for the exported image.

Import

Using pulumi import, import aws_imagebuilder_distribution_configurations resources using the Amazon Resource Name (ARN). For example:

$ pulumi import aws:imagebuilder/distributionConfiguration:DistributionConfiguration example arn:aws:imagebuilder:us-east-1:123456789012:distribution-configuration/example
Copy

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 aws Terraform Provider.
AWS v6.77.0 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-aws