aws logo
AWS Classic v5.33.0, Mar 24 23

aws.imagebuilder.DistributionConfiguration

Manages an Image Builder Distribution Configuration.

Example Usage

using System.Collections.Generic;
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/v5/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<DistributionConfigurationDistributionArgs>

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

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.

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<DistributionConfigurationDistributionArgs>

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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<DistributionConfigurationDistributionArgs>

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

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.

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.

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.

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<DistributionConfigurationDistributionArgs>

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

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.

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.

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.

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.

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.

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.

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.

Supporting Types

DistributionConfigurationDistribution

Region string

AWS Region for the distribution.

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.

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.

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.

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.

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.

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

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

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

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

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

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

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

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

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

aws_imagebuilder_distribution_configurations resources can be imported by using the Amazon Resource Name (ARN), e.g.,

 $ 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.