DistributionProperty Struct
The distribution configuration distribution defines the settings for a specific Region in the Distribution Configuration.
You must specify whether the distribution is for an AMI or a container image. To do so, include exactly one of the following data types for your distribution:
- amiDistributionConfiguration
- containerDistributionConfiguration
Example
ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_imagebuilder as imagebuilder } from 'aws-cdk-lib';
declare const amiDistributionConfiguration: any;
declare const containerDistributionConfiguration: any;
const distributionProperty: imagebuilder.CfnDistributionConfiguration.DistributionProperty = {
region: 'region',
// the properties below are optional
amiDistributionConfiguration: amiDistributionConfiguration,
containerDistributionConfiguration: containerDistributionConfiguration,
fastLaunchConfigurations: [{
accountId: 'accountId',
enabled: false,
launchTemplate: {
launchTemplateId: 'launchTemplateId',
launchTemplateName: 'launchTemplateName',
launchTemplateVersion: 'launchTemplateVersion',
},
maxParallelLaunches: 123,
snapshotConfiguration: {
targetResourceCount: 123,
},
}],
launchTemplateConfigurations: [{
accountId: 'accountId',
launchTemplateId: 'launchTemplateId',
setDefaultVersion: false,
}],
licenseConfigurationArns: ['licenseConfigurationArns'],
ssmParameterConfigurations: [{
parameterName: 'parameterName',
// the properties below are optional
amiAccountId: 'amiAccountId',
dataType: 'dataType',
}],
};
Properties
amiDistributionConfigurationoptionalanyami_distribution_configurationoptionalAnyamiDistributionConfigurationoptionalObjectAmiDistributionConfigurationoptionalobjectAmiDistributionConfigurationoptionalinterface{}#The specific AMI settings, such as launch permissions and AMI tags.
For details, see example schema below.
containerDistributionConfigurationoptionalanycontainer_distribution_configurationoptionalAnycontainerDistributionConfigurationoptionalObjectContainerDistributionConfigurationoptionalobjectContainerDistributionConfigurationoptionalinterface{}#Container distribution settings for encryption, licensing, and sharing in a specific Region.
For details, see example schema below.
fastLaunchConfigurationsoptionalIResolvable | IResolvable | CfnDistributionConfiguration.FastLaunchConfigurationProperty[]fast_launch_configurationsoptionaltyping.Union[IResolvable, typing.List[typing.Union[IResolvable, FastLaunchConfigurationProperty]]]fastLaunchConfigurationsoptionalIResolvableFastLaunchConfigurationsoptionalIResolvableFastLaunchConfigurationsoptionalinterface{}#The Windows faster-launching configurations to use for AMI distribution.
launchTemplateConfigurationsoptionalIResolvable | IResolvable | CfnDistributionConfiguration.LaunchTemplateConfigurationProperty[]launch_template_configurationsoptionaltyping.Union[IResolvable, typing.List[typing.Union[IResolvable, LaunchTemplateConfigurationProperty]]]launchTemplateConfigurationsoptionalIResolvableLaunchTemplateConfigurationsoptionalIResolvableLaunchTemplateConfigurationsoptionalinterface{}#A group of launchTemplateConfiguration settings that apply to image distribution for specified accounts.
licenseConfigurationArnsoptionalstring[]license_configuration_arnsoptionaltyping.List[str]licenseConfigurationArnsoptionalList<String>LicenseConfigurationArnsoptionalstring[]LicenseConfigurationArnsoptional*[]*string#The License Manager Configuration to associate with the AMI in the specified Region.
For more information, see the LicenseConfiguration API .
The target Region for the Distribution Configuration.
For example, eu-west-1 .
ssmParameterConfigurationsoptionalIResolvable | IResolvable | CfnDistributionConfiguration.SsmParameterConfigurationProperty[]ssm_parameter_configurationsoptionaltyping.Union[IResolvable, typing.List[typing.Union[IResolvable, SsmParameterConfigurationProperty]]]ssmParameterConfigurationsoptionalIResolvableSsmParameterConfigurationsoptionalIResolvableSsmParameterConfigurationsoptionalinterface{}#Contains settings to update AWS Systems Manager (SSM) Parameter Store Parameters with output AMI IDs from the build by target Region.