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.100.0 published on Wednesday, Mar 27, 2024 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.100.0 published on Wednesday, Mar 27, 2024 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[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-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 Dictionary<string, string>
    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 map[string]string
    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 Map<String,String>
    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 {[key: string]: string}
    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 Mapping[str, str]
    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 Map<String>
    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 Dictionary<string, string>
    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 map[string]string
    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 Map<String,String>
    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 {[key: string]: string}
    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 Mapping[str, str]
    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 Map<String>
    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.100.0 published on Wednesday, Mar 27, 2024 by Pulumi