> **Experimental**
>
> `@aws-cdk/aws-imagebuilder-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# AmiDistribution

The regional distribution settings to use for an AMI build.

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/distribution-configuration.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0-alpha.0/packages/@aws-cdk/aws-imagebuilder-alpha/lib/distribution-configuration.ts#L189)

## Example

```ts
const infrastructureConfiguration = new imagebuilder.InfrastructureConfiguration(this, 'Infrastructure', {
  infrastructureConfigurationName: 'production-infrastructure',
  instanceTypes: [
    ec2.InstanceType.of(ec2.InstanceClass.COMPUTE7_INTEL, ec2.InstanceSize.LARGE)
  ],
  vpc: vpc,
  subnetSelection: { subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS }
});

const distributionConfiguration = new imagebuilder.DistributionConfiguration(this, 'Distribution');
distributionConfiguration.addAmiDistributions({
  amiName: 'production-ami-{{ imagebuilder:buildDate }}',
  amiTargetAccountIds: ['123456789012', '098765432109']
});

const productionPipeline = new imagebuilder.ImagePipeline(this, 'ProductionPipeline', {
  recipe: exampleImageRecipe,
  infrastructureConfiguration: infrastructureConfiguration,
  distributionConfiguration: distributionConfiguration
});
```

## Properties

- `amiDescription`: string = None — The description of the AMI.

- `amiKmsKey`: [IKey](/cdk/api/v2/docs/aws-cdk-lib.aws_kms.IKey.html) = None — The KMS key to encrypt the distributed AMI with.

- `amiLaunchPermission`: [AmiLaunchPermission](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.AmiLaunchPermission.html) = None — The launch permissions for the AMI, defining which principals are allowed to access the AMI.

- `amiName`: string — The name to use for the distributed AMIs.

  **Default:** A name is generated from the image recipe name

- `amiTags`: { [key: string]: string } = None — The tags to apply to the distributed AMIs.

- `amiTargetAccountIds`: string[] = None — The account IDs to copy the output AMI to.

- `fastLaunchConfigurations`: [FastLaunchConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.FastLaunchConfiguration.html)[] = None — The fast launch configurations to use for enabling EC2 Fast Launch on the distributed Windows AMI.

- `launchTemplates`: [LaunchTemplateConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.LaunchTemplateConfiguration.html)[] = None — The launch templates to apply the distributed AMI to.

- `licenseConfigurationArns`: string[] = None — The License Manager license configuration ARNs to apply to the distributed AMIs.

- `region`: string — The target region to distribute AMIs to.

  **Default:** The current region is used

- `ssmParameters`: [SSMParameterConfigurations](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.SSMParameterConfigurations.html)[] = None — The SSM parameters to create or update for the distributed AMIs.