1. Packages
  2. AWS Classic
  3. API Docs
  4. imagebuilder
  5. DistributionConfiguration

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.28.1 published on Thursday, Mar 28, 2024 by Pulumi

aws.imagebuilder.DistributionConfiguration

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.28.1 published on Thursday, Mar 28, 2024 by Pulumi

    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",
        }],
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.imagebuilder.DistributionConfiguration("example",
        name="example",
        distributions=[aws.imagebuilder.DistributionConfigurationDistributionArgs(
            ami_distribution_configuration=aws.imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationArgs(
                ami_tags={
                    "CostCenter": "IT",
                },
                name="example-{{ imagebuilder:buildDate }}",
                launch_permission=aws.imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs(
                    user_ids=["123456789012"],
                ),
            ),
            launch_template_configurations=[aws.imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs(
                launch_template_id="lt-0aaa1bcde2ff3456",
            )],
            region="us-east-1",
        )])
    
    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
    	})
    }
    
    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",
                },
            },
        });
    
    });
    
    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());
    
        }
    }
    
    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
    

    Create DistributionConfiguration Resource

    new DistributionConfiguration(name: string, args: DistributionConfigurationArgs, opts?: CustomResourceOptions);
    @overload
    def DistributionConfiguration(resource_name: str,
                                  opts: Optional[ResourceOptions] = None,
                                  description: Optional[str] = None,
                                  distributions: Optional[Sequence[DistributionConfigurationDistributionArgs]] = None,
                                  name: Optional[str] = None,
                                  tags: Optional[Mapping[str, str]] = None)
    @overload
    def DistributionConfiguration(resource_name: str,
                                  args: DistributionConfigurationArgs,
                                  opts: Optional[ResourceOptions] = 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.
    
    
    name string
    The unique name of the resource.
    args DistributionConfigurationArgs
    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 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 string
    The unique name of the resource.
    args DistributionConfigurationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DistributionConfigurationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DistributionConfigurationArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    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

    The DistributionConfiguration resource accepts the following input properties:

    Distributions 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 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 []DistributionConfigurationDistributionArgs

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

    The following arguments are optional:

    Description string
    Description of the distribution configuration.
    Name 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 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 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 DistributionConfigurationDistribution[]

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

    The following arguments are optional:

    description string
    Description of the distribution configuration.
    name 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 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 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 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 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)
    Resource lookup is not supported in YAML
    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.
    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 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 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 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 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 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 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 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.
    Region 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.
    region 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.
    region 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.
    region 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.
    region 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.

    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 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 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 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 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 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 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 string
    The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
    Service string
    The service in which this image is registered. Valid values: ECR.
    RepositoryName string
    The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
    Service string
    The service in which this image is registered. Valid values: ECR.
    repositoryName String
    The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
    service String
    The service in which this image is registered. Valid values: ECR.
    repositoryName string
    The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
    service string
    The service in which this image is registered. Valid values: ECR.
    repository_name str
    The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
    service str
    The service in which this image is registered. Valid values: ECR.
    repositoryName String
    The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
    service String
    The service in which this image is registered. Valid values: ECR.

    DistributionConfigurationDistributionFastLaunchConfiguration, DistributionConfigurationDistributionFastLaunchConfigurationArgs

    AccountId string
    The owner account ID for the fast-launch enabled Windows AMI.
    Enabled 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 string
    The owner account ID for the fast-launch enabled Windows AMI.
    Enabled 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 String
    The owner account ID for the fast-launch enabled Windows AMI.
    enabled 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 string
    The owner account ID for the fast-launch enabled Windows AMI.
    enabled 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 str
    The owner account ID for the fast-launch enabled Windows AMI.
    enabled 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 String
    The owner account ID for the fast-launch enabled Windows AMI.
    enabled 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 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 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 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 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 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 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.

    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
    

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.28.1 published on Thursday, Mar 28, 2024 by Pulumi