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

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.77.0 published on Wednesday, Sep 20, 2023 by Pulumi

aws-native.imagebuilder.DistributionConfiguration

Explore with Pulumi AI

aws-native logo

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.77.0 published on Wednesday, Sep 20, 2023 by Pulumi

    Resource schema for AWS::ImageBuilder::DistributionConfiguration

    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[Any] = 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-native: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<Pulumi.AwsNative.ImageBuilder.Inputs.DistributionConfigurationDistribution>

    The distributions of the distribution configuration.

    Description string

    The description of the distribution configuration.

    Name string

    The name of the distribution configuration.

    Tags object

    The tags associated with the component.

    Distributions []DistributionConfigurationDistributionArgs

    The distributions of the distribution configuration.

    Description string

    The description of the distribution configuration.

    Name string

    The name of the distribution configuration.

    Tags interface{}

    The tags associated with the component.

    distributions List<DistributionConfigurationDistribution>

    The distributions of the distribution configuration.

    description String

    The description of the distribution configuration.

    name String

    The name of the distribution configuration.

    tags Object

    The tags associated with the component.

    distributions DistributionConfigurationDistribution[]

    The distributions of the distribution configuration.

    description string

    The description of the distribution configuration.

    name string

    The name of the distribution configuration.

    tags any

    The tags associated with the component.

    distributions Sequence[DistributionConfigurationDistributionArgs]

    The distributions of the distribution configuration.

    description str

    The description of the distribution configuration.

    name str

    The name of the distribution configuration.

    tags Any

    The tags associated with the component.

    distributions List<Property Map>

    The distributions of the distribution configuration.

    description String

    The description of the distribution configuration.

    name String

    The name of the distribution configuration.

    tags Any

    The tags associated with the component.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DistributionConfiguration resource produces the following output properties:

    Arn string

    The Amazon Resource Name (ARN) of the distribution configuration.

    Id string

    The provider-assigned unique ID for this managed resource.

    Arn string

    The Amazon Resource Name (ARN) of the distribution configuration.

    Id string

    The provider-assigned unique ID for this managed resource.

    arn String

    The Amazon Resource Name (ARN) of the distribution configuration.

    id String

    The provider-assigned unique ID for this managed resource.

    arn string

    The Amazon Resource Name (ARN) of the distribution configuration.

    id string

    The provider-assigned unique ID for this managed resource.

    arn str

    The Amazon Resource Name (ARN) of the distribution configuration.

    id str

    The provider-assigned unique ID for this managed resource.

    arn String

    The Amazon Resource Name (ARN) of the distribution configuration.

    id String

    The provider-assigned unique ID for this managed resource.

    Supporting Types

    DistributionConfigurationAmiDistributionConfiguration, DistributionConfigurationAmiDistributionConfigurationArgs

    AmiTags object

    The tags to apply to AMIs distributed to this Region.

    Description string

    The description of the AMI distribution configuration.

    KmsKeyId string

    The KMS key identifier used to encrypt the distributed image.

    LaunchPermissionConfiguration Pulumi.AwsNative.ImageBuilder.Inputs.DistributionConfigurationLaunchPermissionConfiguration
    Name string

    The name of the AMI distribution configuration.

    TargetAccountIds List<string>

    The ID of accounts to which you want to distribute an image.

    AmiTags interface{}

    The tags to apply to AMIs distributed to this Region.

    Description string

    The description of the AMI distribution configuration.

    KmsKeyId string

    The KMS key identifier used to encrypt the distributed image.

    LaunchPermissionConfiguration DistributionConfigurationLaunchPermissionConfiguration
    Name string

    The name of the AMI distribution configuration.

    TargetAccountIds []string

    The ID of accounts to which you want to distribute an image.

    amiTags Object

    The tags to apply to AMIs distributed to this Region.

    description String

    The description of the AMI distribution configuration.

    kmsKeyId String

    The KMS key identifier used to encrypt the distributed image.

    launchPermissionConfiguration DistributionConfigurationLaunchPermissionConfiguration
    name String

    The name of the AMI distribution configuration.

    targetAccountIds List<String>

    The ID of accounts to which you want to distribute an image.

    amiTags any

    The tags to apply to AMIs distributed to this Region.

    description string

    The description of the AMI distribution configuration.

    kmsKeyId string

    The KMS key identifier used to encrypt the distributed image.

    launchPermissionConfiguration DistributionConfigurationLaunchPermissionConfiguration
    name string

    The name of the AMI distribution configuration.

    targetAccountIds string[]

    The ID of accounts to which you want to distribute an image.

    ami_tags Any

    The tags to apply to AMIs distributed to this Region.

    description str

    The description of the AMI distribution configuration.

    kms_key_id str

    The KMS key identifier used to encrypt the distributed image.

    launch_permission_configuration DistributionConfigurationLaunchPermissionConfiguration
    name str

    The name of the AMI distribution configuration.

    target_account_ids Sequence[str]

    The ID of accounts to which you want to distribute an image.

    amiTags Any

    The tags to apply to AMIs distributed to this Region.

    description String

    The description of the AMI distribution configuration.

    kmsKeyId String

    The KMS key identifier used to encrypt the distributed image.

    launchPermissionConfiguration Property Map
    name String

    The name of the AMI distribution configuration.

    targetAccountIds List<String>

    The ID of accounts to which you want to distribute an image.

    DistributionConfigurationContainerDistributionConfiguration, DistributionConfigurationContainerDistributionConfigurationArgs

    ContainerTags List<string>

    Tags that are attached to the container distribution configuration.

    Description string

    The description of the container distribution configuration.

    TargetRepository Pulumi.AwsNative.ImageBuilder.Inputs.DistributionConfigurationTargetContainerRepository

    The destination repository for the container distribution configuration.

    ContainerTags []string

    Tags that are attached to the container distribution configuration.

    Description string

    The description of the container distribution configuration.

    TargetRepository DistributionConfigurationTargetContainerRepository

    The destination repository for the container distribution configuration.

    containerTags List<String>

    Tags that are attached to the container distribution configuration.

    description String

    The description of the container distribution configuration.

    targetRepository DistributionConfigurationTargetContainerRepository

    The destination repository for the container distribution configuration.

    containerTags string[]

    Tags that are attached to the container distribution configuration.

    description string

    The description of the container distribution configuration.

    targetRepository DistributionConfigurationTargetContainerRepository

    The destination repository for the container distribution configuration.

    container_tags Sequence[str]

    Tags that are attached to the container distribution configuration.

    description str

    The description of the container distribution configuration.

    target_repository DistributionConfigurationTargetContainerRepository

    The destination repository for the container distribution configuration.

    containerTags List<String>

    Tags that are attached to the container distribution configuration.

    description String

    The description of the container distribution configuration.

    targetRepository Property Map

    The destination repository for the container distribution configuration.

    DistributionConfigurationDistribution, DistributionConfigurationDistributionArgs

    Region string

    region

    AmiDistributionConfiguration DistributionConfigurationAmiDistributionConfiguration
    ContainerDistributionConfiguration DistributionConfigurationContainerDistributionConfiguration
    FastLaunchConfigurations []DistributionConfigurationFastLaunchConfiguration

    The Windows faster-launching configurations to use for AMI distribution.

    LaunchTemplateConfigurations []DistributionConfigurationLaunchTemplateConfiguration

    A group of launchTemplateConfiguration settings that apply to image distribution.

    LicenseConfigurationArns []string

    The License Manager Configuration to associate with the AMI in the specified Region.

    region String

    region

    amiDistributionConfiguration DistributionConfigurationAmiDistributionConfiguration
    containerDistributionConfiguration DistributionConfigurationContainerDistributionConfiguration
    fastLaunchConfigurations List<DistributionConfigurationFastLaunchConfiguration>

    The Windows faster-launching configurations to use for AMI distribution.

    launchTemplateConfigurations List<DistributionConfigurationLaunchTemplateConfiguration>

    A group of launchTemplateConfiguration settings that apply to image distribution.

    licenseConfigurationArns List<String>

    The License Manager Configuration to associate with the AMI in the specified Region.

    region string

    region

    amiDistributionConfiguration DistributionConfigurationAmiDistributionConfiguration
    containerDistributionConfiguration DistributionConfigurationContainerDistributionConfiguration
    fastLaunchConfigurations DistributionConfigurationFastLaunchConfiguration[]

    The Windows faster-launching configurations to use for AMI distribution.

    launchTemplateConfigurations DistributionConfigurationLaunchTemplateConfiguration[]

    A group of launchTemplateConfiguration settings that apply to image distribution.

    licenseConfigurationArns string[]

    The License Manager Configuration to associate with the AMI in the specified Region.

    region str

    region

    ami_distribution_configuration DistributionConfigurationAmiDistributionConfiguration
    container_distribution_configuration DistributionConfigurationContainerDistributionConfiguration
    fast_launch_configurations Sequence[DistributionConfigurationFastLaunchConfiguration]

    The Windows faster-launching configurations to use for AMI distribution.

    launch_template_configurations Sequence[DistributionConfigurationLaunchTemplateConfiguration]

    A group of launchTemplateConfiguration settings that apply to image distribution.

    license_configuration_arns Sequence[str]

    The License Manager Configuration to associate with the AMI in the specified Region.

    region String

    region

    amiDistributionConfiguration Property Map
    containerDistributionConfiguration Property Map
    fastLaunchConfigurations List<Property Map>

    The Windows faster-launching configurations to use for AMI distribution.

    launchTemplateConfigurations List<Property Map>

    A group of launchTemplateConfiguration settings that apply to image distribution.

    licenseConfigurationArns List<String>

    The License Manager Configuration to associate with the AMI in the specified Region.

    DistributionConfigurationFastLaunchConfiguration, DistributionConfigurationFastLaunchConfigurationArgs

    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 Pulumi.AwsNative.ImageBuilder.Inputs.DistributionConfigurationFastLaunchLaunchTemplateSpecification

    The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.

    MaxParallelLaunches int

    The maximum number of parallel instances that are launched for creating resources.

    SnapshotConfiguration Pulumi.AwsNative.ImageBuilder.Inputs.DistributionConfigurationFastLaunchSnapshotConfiguration

    Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.

    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 DistributionConfigurationFastLaunchLaunchTemplateSpecification

    The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.

    MaxParallelLaunches int

    The maximum number of parallel instances that are launched for creating resources.

    SnapshotConfiguration DistributionConfigurationFastLaunchSnapshotConfiguration

    Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.

    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 DistributionConfigurationFastLaunchLaunchTemplateSpecification

    The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.

    maxParallelLaunches Integer

    The maximum number of parallel instances that are launched for creating resources.

    snapshotConfiguration DistributionConfigurationFastLaunchSnapshotConfiguration

    Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.

    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 DistributionConfigurationFastLaunchLaunchTemplateSpecification

    The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.

    maxParallelLaunches number

    The maximum number of parallel instances that are launched for creating resources.

    snapshotConfiguration DistributionConfigurationFastLaunchSnapshotConfiguration

    Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.

    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 DistributionConfigurationFastLaunchLaunchTemplateSpecification

    The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.

    max_parallel_launches int

    The maximum number of parallel instances that are launched for creating resources.

    snapshot_configuration DistributionConfigurationFastLaunchSnapshotConfiguration

    Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.

    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

    The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.

    maxParallelLaunches Number

    The maximum number of parallel instances that are launched for creating resources.

    snapshotConfiguration Property Map

    Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.

    DistributionConfigurationFastLaunchLaunchTemplateSpecification, DistributionConfigurationFastLaunchLaunchTemplateSpecificationArgs

    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.

    DistributionConfigurationFastLaunchSnapshotConfiguration, DistributionConfigurationFastLaunchSnapshotConfigurationArgs

    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.

    DistributionConfigurationLaunchPermissionConfiguration, DistributionConfigurationLaunchPermissionConfigurationArgs

    OrganizationArns List<string>

    The ARN for an Amazon Web Services Organization that you want to share your AMI with.

    OrganizationalUnitArns List<string>

    The ARN for an Organizations organizational unit (OU) that you want to share your AMI with.

    UserGroups List<string>

    The name of the group.

    UserIds List<string>

    The AWS account ID.

    OrganizationArns []string

    The ARN for an Amazon Web Services Organization that you want to share your AMI with.

    OrganizationalUnitArns []string

    The ARN for an Organizations organizational unit (OU) that you want to share your AMI with.

    UserGroups []string

    The name of the group.

    UserIds []string

    The AWS account ID.

    organizationArns List<String>

    The ARN for an Amazon Web Services Organization that you want to share your AMI with.

    organizationalUnitArns List<String>

    The ARN for an Organizations organizational unit (OU) that you want to share your AMI with.

    userGroups List<String>

    The name of the group.

    userIds List<String>

    The AWS account ID.

    organizationArns string[]

    The ARN for an Amazon Web Services Organization that you want to share your AMI with.

    organizationalUnitArns string[]

    The ARN for an Organizations organizational unit (OU) that you want to share your AMI with.

    userGroups string[]

    The name of the group.

    userIds string[]

    The AWS account ID.

    organization_arns Sequence[str]

    The ARN for an Amazon Web Services Organization that you want to share your AMI with.

    organizational_unit_arns Sequence[str]

    The ARN for an Organizations organizational unit (OU) that you want to share your AMI with.

    user_groups Sequence[str]

    The name of the group.

    user_ids Sequence[str]

    The AWS account ID.

    organizationArns List<String>

    The ARN for an Amazon Web Services Organization that you want to share your AMI with.

    organizationalUnitArns List<String>

    The ARN for an Organizations organizational unit (OU) that you want to share your AMI with.

    userGroups List<String>

    The name of the group.

    userIds List<String>

    The AWS account ID.

    DistributionConfigurationLaunchTemplateConfiguration, DistributionConfigurationLaunchTemplateConfigurationArgs

    AccountId string

    The account ID that this configuration applies to.

    LaunchTemplateId string

    Identifies the EC2 launch template to use.

    SetDefaultVersion bool

    Set the specified EC2 launch template as the default launch template for the specified account.

    AccountId string

    The account ID that this configuration applies to.

    LaunchTemplateId string

    Identifies the EC2 launch template to use.

    SetDefaultVersion bool

    Set the specified EC2 launch template as the default launch template for the specified account.

    accountId String

    The account ID that this configuration applies to.

    launchTemplateId String

    Identifies the EC2 launch template to use.

    setDefaultVersion Boolean

    Set the specified EC2 launch template as the default launch template for the specified account.

    accountId string

    The account ID that this configuration applies to.

    launchTemplateId string

    Identifies the EC2 launch template to use.

    setDefaultVersion boolean

    Set the specified EC2 launch template as the default launch template for the specified account.

    account_id str

    The account ID that this configuration applies to.

    launch_template_id str

    Identifies the EC2 launch template to use.

    set_default_version bool

    Set the specified EC2 launch template as the default launch template for the specified account.

    accountId String

    The account ID that this configuration applies to.

    launchTemplateId String

    Identifies the EC2 launch template to use.

    setDefaultVersion Boolean

    Set the specified EC2 launch template as the default launch template for the specified account.

    DistributionConfigurationTargetContainerRepository, DistributionConfigurationTargetContainerRepositoryArgs

    RepositoryName string

    The repository name of target container repository.

    Service Pulumi.AwsNative.ImageBuilder.DistributionConfigurationTargetContainerRepositoryService

    The service of target container repository.

    RepositoryName string

    The repository name of target container repository.

    Service DistributionConfigurationTargetContainerRepositoryService

    The service of target container repository.

    repositoryName String

    The repository name of target container repository.

    service DistributionConfigurationTargetContainerRepositoryService

    The service of target container repository.

    repositoryName string

    The repository name of target container repository.

    service DistributionConfigurationTargetContainerRepositoryService

    The service of target container repository.

    repository_name str

    The repository name of target container repository.

    service DistributionConfigurationTargetContainerRepositoryService

    The service of target container repository.

    repositoryName String

    The repository name of target container repository.

    service "ECR"

    The service of target container repository.

    DistributionConfigurationTargetContainerRepositoryService, DistributionConfigurationTargetContainerRepositoryServiceArgs

    Ecr
    ECR
    DistributionConfigurationTargetContainerRepositoryServiceEcr
    ECR
    Ecr
    ECR
    Ecr
    ECR
    ECR
    ECR
    "ECR"
    ECR

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    AWS Native is in preview. AWS Classic is fully supported.

    AWS Native v0.77.0 published on Wednesday, Sep 20, 2023 by Pulumi