Try AWS Native preview for resources not in the classic version.
aws.imagebuilder.DistributionConfiguration
Explore with Pulumi AI
Try AWS Native preview for resources not in the classic version.
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<Distribution
Configuration Distribution> 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.
- 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
[]Distribution
Configuration Distribution Args 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.
- 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<Distribution
Configuration Distribution> 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.
- 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
Distribution
Configuration Distribution[] 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.
- {[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[Distribution
Configuration Distribution Args] 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.
- 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.
- 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.
- Date
Created string Date the distribution configuration was created.
- Date
Updated string Date the distribution configuration was updated.
- Id string
The provider-assigned unique ID for this managed resource.
- Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- Arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- Date
Created string Date the distribution configuration was created.
- Date
Updated string Date the distribution configuration was updated.
- Id string
The provider-assigned unique ID for this managed resource.
- map[string]string
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- date
Created String Date the distribution configuration was created.
- date
Updated String Date the distribution configuration was updated.
- id String
The provider-assigned unique ID for this managed resource.
- Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- date
Created string Date the distribution configuration was created.
- date
Updated string Date the distribution configuration was updated.
- id string
The provider-assigned unique ID for this managed resource.
- {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.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.
- Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- date
Created String Date the distribution configuration was created.
- date
Updated String Date the distribution configuration was updated.
- id String
The provider-assigned unique ID for this managed resource.
- Map<String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.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.
- Arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- Date
Created string Date the distribution configuration was created.
- Date
Updated string Date the distribution configuration was updated.
- Description string
Description of the distribution configuration.
- Distributions
List<Distribution
Configuration Distribution> One or more configuration blocks with distribution settings. Detailed below.
The following arguments are optional:
- Name string
Name of the distribution configuration.
- 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.- Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- Arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- Date
Created string Date the distribution configuration was created.
- Date
Updated string Date the distribution configuration was updated.
- Description string
Description of the distribution configuration.
- Distributions
[]Distribution
Configuration Distribution Args One or more configuration blocks with distribution settings. Detailed below.
The following arguments are optional:
- Name string
Name of the distribution configuration.
- 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.- map[string]string
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- date
Created String Date the distribution configuration was created.
- date
Updated String Date the distribution configuration was updated.
- description String
Description of the distribution configuration.
- distributions
List<Distribution
Configuration Distribution> One or more configuration blocks with distribution settings. Detailed below.
The following arguments are optional:
- name String
Name of the distribution configuration.
- 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.- Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn string
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- date
Created string Date the distribution configuration was created.
- date
Updated string Date the distribution configuration was updated.
- description string
Description of the distribution configuration.
- distributions
Distribution
Configuration Distribution[] One or more configuration blocks with distribution settings. Detailed below.
The following arguments are optional:
- name string
Name of the distribution configuration.
- {[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.- {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.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[Distribution
Configuration Distribution Args] One or more configuration blocks with distribution settings. Detailed below.
The following arguments are optional:
- name str
Name of the distribution configuration.
- 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.- Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
- arn String
(Required) Amazon Resource Name (ARN) of the distribution configuration.
- date
Created String Date the distribution configuration was created.
- date
Updated 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.
- 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.- Map<String>
A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.Please use
tags
instead.
Supporting Types
DistributionConfigurationDistribution, DistributionConfigurationDistributionArgs
- Region string
AWS Region for the distribution.
The following arguments are optional:
- Ami
Distribution DistributionConfiguration Configuration Distribution Ami Distribution Configuration Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
- Container
Distribution DistributionConfiguration Configuration Distribution Container Distribution Configuration Configuration block with container distribution settings. Detailed below.
- Fast
Launch List<DistributionConfigurations Configuration Distribution Fast Launch Configuration> Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
- Launch
Template List<DistributionConfigurations Configuration Distribution Launch Template Configuration> Set of launch template configuration settings that apply to image distribution. Detailed below.
- License
Configuration List<string>Arns Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
- Region string
AWS Region for the distribution.
The following arguments are optional:
- Ami
Distribution DistributionConfiguration Configuration Distribution Ami Distribution Configuration Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
- Container
Distribution DistributionConfiguration Configuration Distribution Container Distribution Configuration Configuration block with container distribution settings. Detailed below.
- Fast
Launch []DistributionConfigurations Configuration Distribution Fast Launch Configuration Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
- Launch
Template []DistributionConfigurations Configuration Distribution Launch Template Configuration Set of launch template configuration settings that apply to image distribution. Detailed below.
- License
Configuration []stringArns Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
- region String
AWS Region for the distribution.
The following arguments are optional:
- ami
Distribution DistributionConfiguration Configuration Distribution Ami Distribution Configuration Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
- container
Distribution DistributionConfiguration Configuration Distribution Container Distribution Configuration Configuration block with container distribution settings. Detailed below.
- fast
Launch List<DistributionConfigurations Configuration Distribution Fast Launch Configuration> Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
- launch
Template List<DistributionConfigurations Configuration Distribution Launch Template Configuration> Set of launch template configuration settings that apply to image distribution. Detailed below.
- license
Configuration List<String>Arns Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
- region string
AWS Region for the distribution.
The following arguments are optional:
- ami
Distribution DistributionConfiguration Configuration Distribution Ami Distribution Configuration Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
- container
Distribution DistributionConfiguration Configuration Distribution Container Distribution Configuration Configuration block with container distribution settings. Detailed below.
- fast
Launch DistributionConfigurations Configuration Distribution Fast Launch Configuration[] Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
- launch
Template DistributionConfigurations Configuration Distribution Launch Template Configuration[] Set of launch template configuration settings that apply to image distribution. Detailed below.
- license
Configuration string[]Arns 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_ Distributionconfiguration Configuration Distribution Ami Distribution Configuration Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
- container_
distribution_ Distributionconfiguration Configuration Distribution Container Distribution Configuration Configuration block with container distribution settings. Detailed below.
- fast_
launch_ Sequence[Distributionconfigurations Configuration Distribution Fast Launch Configuration] Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
- launch_
template_ Sequence[Distributionconfigurations Configuration Distribution Launch Template Configuration] Set of launch template configuration settings that apply to image distribution. Detailed below.
- license_
configuration_ Sequence[str]arns Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
- region String
AWS Region for the distribution.
The following arguments are optional:
- ami
Distribution Property MapConfiguration Configuration block with Amazon Machine Image (AMI) distribution settings. Detailed below.
- container
Distribution Property MapConfiguration Configuration block with container distribution settings. Detailed below.
- fast
Launch List<Property Map>Configurations Set of Windows faster-launching configurations to use for AMI distribution. Detailed below.
- launch
Template List<Property Map>Configurations Set of launch template configuration settings that apply to image distribution. Detailed below.
- license
Configuration List<String>Arns Set of Amazon Resource Names (ARNs) of License Manager License Configurations.
DistributionConfigurationDistributionAmiDistributionConfiguration, DistributionConfigurationDistributionAmiDistributionConfigurationArgs
- Dictionary<string, string>
Key-value map of tags to apply to the distributed AMI.
- Description string
Description to apply to the distributed AMI.
- Kms
Key stringId Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
- Launch
Permission DistributionConfiguration Distribution Ami Distribution Configuration Launch Permission Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
- Name string
Name to apply to the distributed AMI.
- Target
Account List<string>Ids Set of AWS Account identifiers to distribute the AMI.
- map[string]string
Key-value map of tags to apply to the distributed AMI.
- Description string
Description to apply to the distributed AMI.
- Kms
Key stringId Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
- Launch
Permission DistributionConfiguration Distribution Ami Distribution Configuration Launch Permission Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
- Name string
Name to apply to the distributed AMI.
- Target
Account []stringIds Set of AWS Account identifiers to distribute the AMI.
- Map<String,String>
Key-value map of tags to apply to the distributed AMI.
- description String
Description to apply to the distributed AMI.
- kms
Key StringId Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
- launch
Permission DistributionConfiguration Distribution Ami Distribution Configuration Launch Permission Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
- name String
Name to apply to the distributed AMI.
- target
Account List<String>Ids Set of AWS Account identifiers to distribute the AMI.
- {[key: string]: string}
Key-value map of tags to apply to the distributed AMI.
- description string
Description to apply to the distributed AMI.
- kms
Key stringId Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
- launch
Permission DistributionConfiguration Distribution Ami Distribution Configuration Launch Permission Configuration block of EC2 launch permissions to apply to the distributed AMI. Detailed below.
- name string
Name to apply to the distributed AMI.
- target
Account string[]Ids Set of AWS Account identifiers to distribute the AMI.
- 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_ strid Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
- launch_
permission DistributionConfiguration Distribution Ami Distribution Configuration Launch Permission 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_ Sequence[str]ids Set of AWS Account identifiers to distribute the AMI.
- Map<String>
Key-value map of tags to apply to the distributed AMI.
- description String
Description to apply to the distributed AMI.
- kms
Key StringId Amazon Resource Name (ARN) of the Key Management Service (KMS) Key to encrypt the distributed AMI.
- launch
Permission 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.
- target
Account List<String>Ids Set of AWS Account identifiers to distribute the AMI.
DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermission, DistributionConfigurationDistributionAmiDistributionConfigurationLaunchPermissionArgs
- Organization
Arns List<string> Set of AWS Organization ARNs to assign.
- Organizational
Unit List<string>Arns Set of AWS Organizational Unit ARNs to assign.
- User
Groups List<string> Set of EC2 launch permission user groups to assign. Use
all
to distribute a public AMI.- User
Ids List<string> Set of AWS Account identifiers to assign.
- Organization
Arns []string Set of AWS Organization ARNs to assign.
- Organizational
Unit []stringArns Set of AWS Organizational Unit ARNs to assign.
- User
Groups []string Set of EC2 launch permission user groups to assign. Use
all
to distribute a public AMI.- User
Ids []string Set of AWS Account identifiers to assign.
- organization
Arns List<String> Set of AWS Organization ARNs to assign.
- organizational
Unit List<String>Arns Set of AWS Organizational Unit ARNs to assign.
- user
Groups List<String> Set of EC2 launch permission user groups to assign. Use
all
to distribute a public AMI.- user
Ids List<String> Set of AWS Account identifiers to assign.
- organization
Arns string[] Set of AWS Organization ARNs to assign.
- organizational
Unit string[]Arns Set of AWS Organizational Unit ARNs to assign.
- user
Groups string[] Set of EC2 launch permission user groups to assign. Use
all
to distribute a public AMI.- user
Ids string[] Set of AWS Account identifiers to assign.
- organization_
arns Sequence[str] Set of AWS Organization ARNs to assign.
- organizational_
unit_ Sequence[str]arns 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.
- organization
Arns List<String> Set of AWS Organization ARNs to assign.
- organizational
Unit List<String>Arns Set of AWS Organizational Unit ARNs to assign.
- user
Groups List<String> Set of EC2 launch permission user groups to assign. Use
all
to distribute a public AMI.- user
Ids List<String> Set of AWS Account identifiers to assign.
DistributionConfigurationDistributionContainerDistributionConfiguration, DistributionConfigurationDistributionContainerDistributionConfigurationArgs
- Target
Repository DistributionConfiguration Distribution Container Distribution Configuration Target Repository Configuration block with the destination repository for the container distribution configuration.
- List<string>
Set of tags that are attached to the container distribution configuration.
- Description string
Description of the container distribution configuration.
- Target
Repository DistributionConfiguration Distribution Container Distribution Configuration Target Repository Configuration block with the destination repository for the container distribution configuration.
- []string
Set of tags that are attached to the container distribution configuration.
- Description string
Description of the container distribution configuration.
- target
Repository DistributionConfiguration Distribution Container Distribution Configuration Target Repository Configuration block with the destination repository for the container distribution configuration.
- List<String>
Set of tags that are attached to the container distribution configuration.
- description String
Description of the container distribution configuration.
- target
Repository DistributionConfiguration Distribution Container Distribution Configuration Target Repository Configuration block with the destination repository for the container distribution configuration.
- string[]
Set of tags that are attached to the container distribution configuration.
- description string
Description of the container distribution configuration.
- target_
repository DistributionConfiguration Distribution Container Distribution Configuration Target Repository Configuration block with the destination repository for the container distribution configuration.
- Sequence[str]
Set of tags that are attached to the container distribution configuration.
- description str
Description of the container distribution configuration.
- target
Repository Property Map Configuration block with the destination repository for the container distribution configuration.
- List<String>
Set of tags that are attached to the container distribution configuration.
- description String
Description of the container distribution configuration.
DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepository, DistributionConfigurationDistributionContainerDistributionConfigurationTargetRepositoryArgs
- Repository
Name 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 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 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 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
.
- repository
Name 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
- Account
Id 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, orfalse
to stop using it.- Launch
Template DistributionConfiguration Distribution Fast Launch Configuration Launch Template 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 intLaunches The maximum number of parallel instances that are launched for creating resources.
- Snapshot
Configuration DistributionConfiguration Distribution Fast Launch Configuration Snapshot Configuration 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 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, orfalse
to stop using it.- Launch
Template DistributionConfiguration Distribution Fast Launch Configuration Launch Template 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 intLaunches The maximum number of parallel instances that are launched for creating resources.
- Snapshot
Configuration DistributionConfiguration Distribution Fast Launch Configuration Snapshot Configuration 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 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, orfalse
to stop using it.- launch
Template DistributionConfiguration Distribution Fast Launch Configuration Launch Template 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 IntegerLaunches The maximum number of parallel instances that are launched for creating resources.
- snapshot
Configuration DistributionConfiguration Distribution Fast Launch Configuration Snapshot Configuration 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 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, orfalse
to stop using it.- launch
Template DistributionConfiguration Distribution Fast Launch Configuration Launch Template 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 numberLaunches The maximum number of parallel instances that are launched for creating resources.
- snapshot
Configuration DistributionConfiguration Distribution Fast Launch Configuration Snapshot Configuration 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, orfalse
to stop using it.- launch_
template DistributionConfiguration Distribution Fast Launch Configuration Launch Template 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_ intlaunches The maximum number of parallel instances that are launched for creating resources.
- snapshot_
configuration DistributionConfiguration Distribution Fast Launch Configuration Snapshot Configuration 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 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, orfalse
to stop using it.- launch
Template 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.
- max
Parallel NumberLaunches The maximum number of parallel instances that are launched for creating resources.
- snapshot
Configuration 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
- Launch
Template stringId The ID of the launch template to use for faster launching for a Windows AMI.
- Launch
Template stringName The name of the launch template to use for faster launching for a Windows AMI.
- Launch
Template stringVersion The version of the launch template to use for faster launching for a Windows AMI.
- Launch
Template stringId The ID of the launch template to use for faster launching for a Windows AMI.
- Launch
Template stringName The name of the launch template to use for faster launching for a Windows AMI.
- Launch
Template stringVersion The version of the launch template to use for faster launching for a Windows AMI.
- launch
Template StringId The ID of the launch template to use for faster launching for a Windows AMI.
- launch
Template StringName The name of the launch template to use for faster launching for a Windows AMI.
- launch
Template StringVersion The version of the launch template to use for faster launching for a Windows AMI.
- launch
Template stringId The ID of the launch template to use for faster launching for a Windows AMI.
- launch
Template stringName The name of the launch template to use for faster launching for a Windows AMI.
- launch
Template stringVersion The version of the launch template to use for faster launching for a Windows AMI.
- launch_
template_ strid The ID of the launch template to use for faster launching for a Windows AMI.
- launch_
template_ strname The name of the launch template to use for faster launching for a Windows AMI.
- launch_
template_ strversion The version of the launch template to use for faster launching for a Windows AMI.
- launch
Template StringId The ID of the launch template to use for faster launching for a Windows AMI.
- launch
Template StringName The name of the launch template to use for faster launching for a Windows AMI.
- launch
Template StringVersion The version of the launch template to use for faster launching for a Windows AMI.
DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfiguration, DistributionConfigurationDistributionFastLaunchConfigurationSnapshotConfigurationArgs
- Target
Resource intCount The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
- Target
Resource intCount The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
- target
Resource IntegerCount The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
- target
Resource numberCount The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
- target_
resource_ intcount The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
- target
Resource NumberCount The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
DistributionConfigurationDistributionLaunchTemplateConfiguration, DistributionConfigurationDistributionLaunchTemplateConfigurationArgs
- Launch
Template stringId The ID of the Amazon EC2 launch template to use.
- Account
Id 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
.
- Launch
Template stringId The ID of the Amazon EC2 launch template to use.
- Account
Id 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
.
- launch
Template StringId The ID of the Amazon EC2 launch template to use.
- account
Id 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 stringId The ID of the Amazon EC2 launch template to use.
- account
Id 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_ strid 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
.
- launch
Template StringId The ID of the Amazon EC2 launch template to use.
- account
Id 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.
Try AWS Native preview for resources not in the classic version.