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.13.2 published on Thursday, Dec 7, 2023 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.13.2 published on Thursday, Dec 7, 2023 by Pulumi

    Manages an Image Builder Distribution Configuration.

    Example Usage

    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()
        {
            Distributions = new[]
            {
                new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionArgs
                {
                    AmiDistributionConfiguration = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionAmiDistributionConfigurationArgs
                    {
                        AmiTags = 
                        {
                            { "CostCenter", "IT" },
                        },
                        LaunchPermission = new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs
                        {
                            UserIds = new[]
                            {
                                "123456789012",
                            },
                        },
                        Name = "example-{{ imagebuilder:buildDate }}",
                    },
                    LaunchTemplateConfigurations = new[]
                    {
                        new Aws.ImageBuilder.Inputs.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs
                        {
                            LaunchTemplateId = "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{
    			Distributions: imagebuilder.DistributionConfigurationDistributionArray{
    				&imagebuilder.DistributionConfigurationDistributionArgs{
    					AmiDistributionConfiguration: &imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationArgs{
    						AmiTags: pulumi.StringMap{
    							"CostCenter": pulumi.String("IT"),
    						},
    						LaunchPermission: &imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs{
    							UserIds: pulumi.StringArray{
    								pulumi.String("123456789012"),
    							},
    						},
    						Name: pulumi.String("example-{{ imagebuilder:buildDate }}"),
    					},
    					LaunchTemplateConfigurations: imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArray{
    						&imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs{
    							LaunchTemplateId: pulumi.String("lt-0aaa1bcde2ff3456"),
    						},
    					},
    					Region: pulumi.String("us-east-1"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.imagebuilder.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()        
                .distributions(DistributionConfigurationDistributionArgs.builder()
                    .amiDistributionConfiguration(DistributionConfigurationDistributionAmiDistributionConfigurationArgs.builder()
                        .amiTags(Map.of("CostCenter", "IT"))
                        .launchPermission(DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs.builder()
                            .userIds("123456789012")
                            .build())
                        .name("example-{{ imagebuilder:buildDate }}")
                        .build())
                    .launchTemplateConfigurations(DistributionConfigurationDistributionLaunchTemplateConfigurationArgs.builder()
                        .launchTemplateId("lt-0aaa1bcde2ff3456")
                        .build())
                    .region("us-east-1")
                    .build())
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.imagebuilder.DistributionConfiguration("example", distributions=[aws.imagebuilder.DistributionConfigurationDistributionArgs(
        ami_distribution_configuration=aws.imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationArgs(
            ami_tags={
                "CostCenter": "IT",
            },
            launch_permission=aws.imagebuilder.DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs(
                user_ids=["123456789012"],
            ),
            name="example-{{ imagebuilder:buildDate }}",
        ),
        launch_template_configurations=[aws.imagebuilder.DistributionConfigurationDistributionLaunchTemplateConfigurationArgs(
            launch_template_id="lt-0aaa1bcde2ff3456",
        )],
        region="us-east-1",
    )])
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.imagebuilder.DistributionConfiguration("example", {distributions: [{
        amiDistributionConfiguration: {
            amiTags: {
                CostCenter: "IT",
            },
            launchPermission: {
                userIds: ["123456789012"],
            },
            name: "example-{{ imagebuilder:buildDate }}",
        },
        launchTemplateConfigurations: [{
            launchTemplateId: "lt-0aaa1bcde2ff3456",
        }],
        region: "us-east-1",
    }]});
    
    resources:
      example:
        type: aws:imagebuilder:DistributionConfiguration
        properties:
          distributions:
            - amiDistributionConfiguration:
                amiTags:
                  CostCenter: IT
                launchPermission:
                  userIds:
                    - '123456789012'
                name: example-{{ imagebuilder:buildDate }}
              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.13.2 published on Thursday, Dec 7, 2023 by Pulumi