aws-cdk-lib 2.194.0__py3-none-any.whl → 2.195.0__py3-none-any.whl

aws_cdk/aws_imagebuilder/__init__.py

@@ -694,7 +694,7 @@ class CfnContainerRecipe(
         :param components: Build and test components that are included in the container recipe. Recipes require a minimum of one build component, and can have a maximum of 20 build and test components in any combination.
         :param container_type: Specifies the type of container, such as Docker.
         :param name: The name of the container recipe.
-        :param parent_image: The base image for the container recipe.
+        :param parent_image: The base image for customizations specified in the container recipe. This can contain an Image Builder image resource ARN or a container image URI, for example ``amazonlinux:latest`` .
         :param target_repository: The destination repository for the container image.
         :param version: The semantic version of the container recipe. .. epigraph:: The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them. *Assignment:* For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node. *Patterns:* You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01. *Filtering:* With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.
         :param description: The description of the container recipe.
@@ -839,7 +839,7 @@ class CfnContainerRecipe(
     @builtins.property
     @jsii.member(jsii_name="parentImage")
     def parent_image(self) -> builtins.str:
-        '''The base image for the container recipe.'''
+        '''The base image for customizations specified in the container recipe.'''
         return typing.cast(builtins.str, jsii.get(self, "parentImage"))
 
     @parent_image.setter
@@ -1458,7 +1458,7 @@ class CfnContainerRecipe(
             '''Defines a custom base AMI and block device mapping configurations of an instance used for building and testing container images.
 
             :param block_device_mappings: Defines the block devices to attach for building an instance from this Image Builder AMI.
-            :param image: The AMI ID to use as the base image for a container build and test instance. If not specified, Image Builder will use the appropriate ECS-optimized AMI as a base image.
+            :param image: The base image for a container build and test instance. This can contain an AMI ID or it can specify an AWS Systems Manager (SSM) Parameter Store Parameter, prefixed by ``ssm:`` , followed by the parameter name or ARN. If not specified, Image Builder uses the appropriate ECS-optimized AMI as a base image.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-containerrecipe-instanceconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -1511,9 +1511,11 @@ class CfnContainerRecipe(
 
         @builtins.property
         def image(self) -> typing.Optional[builtins.str]:
-            '''The AMI ID to use as the base image for a container build and test instance.
+            '''The base image for a container build and test instance.
 
-            If not specified, Image Builder will use the appropriate ECS-optimized AMI as a base image.
+            This can contain an AMI ID or it can specify an AWS Systems Manager (SSM) Parameter Store Parameter, prefixed by ``ssm:`` , followed by the parameter name or ARN.
+
+            If not specified, Image Builder uses the appropriate ECS-optimized AMI as a base image.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-containerrecipe-instanceconfiguration.html#cfn-imagebuilder-containerrecipe-instanceconfiguration-image
             '''
@@ -1650,7 +1652,7 @@ class CfnContainerRecipeProps:
         :param components: Build and test components that are included in the container recipe. Recipes require a minimum of one build component, and can have a maximum of 20 build and test components in any combination.
         :param container_type: Specifies the type of container, such as Docker.
         :param name: The name of the container recipe.
-        :param parent_image: The base image for the container recipe.
+        :param parent_image: The base image for customizations specified in the container recipe. This can contain an Image Builder image resource ARN or a container image URI, for example ``amazonlinux:latest`` .
         :param target_repository: The destination repository for the container image.
         :param version: The semantic version of the container recipe. .. epigraph:: The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them. *Assignment:* For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node. *Patterns:* You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01. *Filtering:* With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.
         :param description: The description of the container recipe.
@@ -1800,7 +1802,9 @@ class CfnContainerRecipeProps:
 
     @builtins.property
     def parent_image(self) -> builtins.str:
-        '''The base image for the container recipe.
+        '''The base image for customizations specified in the container recipe.
+
+        This can contain an Image Builder image resource ARN or a container image URI, for example ``amazonlinux:latest`` .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-containerrecipe.html#cfn-imagebuilder-containerrecipe-parentimage
         '''
@@ -1985,7 +1989,14 @@ class CfnDistributionConfiguration(
                     launch_template_id="launchTemplateId",
                     set_default_version=False
                 )],
-                license_configuration_arns=["licenseConfigurationArns"]
+                license_configuration_arns=["licenseConfigurationArns"],
+                ssm_parameter_configurations=[imagebuilder.CfnDistributionConfiguration.SsmParameterConfigurationProperty(
+                    parameter_name="parameterName",
+        
+                    # the properties below are optional
+                    ami_account_id="amiAccountId",
+                    data_type="dataType"
+                )]
             )],
             name="name",
         
@@ -2400,6 +2411,7 @@ class CfnDistributionConfiguration(
             "fast_launch_configurations": "fastLaunchConfigurations",
             "launch_template_configurations": "launchTemplateConfigurations",
             "license_configuration_arns": "licenseConfigurationArns",
+            "ssm_parameter_configurations": "ssmParameterConfigurations",
         },
     )
     class DistributionProperty:
@@ -2412,6 +2424,7 @@ class CfnDistributionConfiguration(
             fast_launch_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDistributionConfiguration.FastLaunchConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
             launch_template_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDistributionConfiguration.LaunchTemplateConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
             license_configuration_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
+            ssm_parameter_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDistributionConfiguration.SsmParameterConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         ) -> None:
             '''The distribution configuration distribution defines the settings for a specific Region in the Distribution Configuration.
 
@@ -2426,6 +2439,7 @@ class CfnDistributionConfiguration(
             :param fast_launch_configurations: The Windows faster-launching configurations to use for AMI distribution.
             :param launch_template_configurations: A group of launchTemplateConfiguration settings that apply to image distribution for specified accounts.
             :param license_configuration_arns: The License Manager Configuration to associate with the AMI in the specified Region. For more information, see the `LicenseConfiguration API <https://docs.aws.amazon.com/license-manager/latest/APIReference/API_LicenseConfiguration.html>`_ .
+            :param ssm_parameter_configurations: Contains settings to update AWS Systems Manager (SSM) Parameter Store Parameters with output AMI IDs from the build by target Region.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-distributionconfiguration-distribution.html
             :exampleMetadata: fixture=_generated
@@ -2463,7 +2477,14 @@ class CfnDistributionConfiguration(
                         launch_template_id="launchTemplateId",
                         set_default_version=False
                     )],
-                    license_configuration_arns=["licenseConfigurationArns"]
+                    license_configuration_arns=["licenseConfigurationArns"],
+                    ssm_parameter_configurations=[imagebuilder.CfnDistributionConfiguration.SsmParameterConfigurationProperty(
+                        parameter_name="parameterName",
+                
+                        # the properties below are optional
+                        ami_account_id="amiAccountId",
+                        data_type="dataType"
+                    )]
                 )
             '''
             if __debug__:
@@ -2474,6 +2495,7 @@ class CfnDistributionConfiguration(
                 check_type(argname="argument fast_launch_configurations", value=fast_launch_configurations, expected_type=type_hints["fast_launch_configurations"])
                 check_type(argname="argument launch_template_configurations", value=launch_template_configurations, expected_type=type_hints["launch_template_configurations"])
                 check_type(argname="argument license_configuration_arns", value=license_configuration_arns, expected_type=type_hints["license_configuration_arns"])
+                check_type(argname="argument ssm_parameter_configurations", value=ssm_parameter_configurations, expected_type=type_hints["ssm_parameter_configurations"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "region": region,
             }
@@ -2487,6 +2509,8 @@ class CfnDistributionConfiguration(
                 self._values["launch_template_configurations"] = launch_template_configurations
             if license_configuration_arns is not None:
                 self._values["license_configuration_arns"] = license_configuration_arns
+            if ssm_parameter_configurations is not None:
+                self._values["ssm_parameter_configurations"] = ssm_parameter_configurations
 
         @builtins.property
         def region(self) -> builtins.str:
@@ -2557,6 +2581,17 @@ class CfnDistributionConfiguration(
             result = self._values.get("license_configuration_arns")
             return typing.cast(typing.Optional[typing.List[builtins.str]], result)
 
+        @builtins.property
+        def ssm_parameter_configurations(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDistributionConfiguration.SsmParameterConfigurationProperty"]]]]:
+            '''Contains settings to update AWS Systems Manager (SSM) Parameter Store Parameters with output AMI IDs from the build by target Region.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-distributionconfiguration-distribution.html#cfn-imagebuilder-distributionconfiguration-distribution-ssmparameterconfigurations
+            '''
+            result = self._values.get("ssm_parameter_configurations")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDistributionConfiguration.SsmParameterConfigurationProperty"]]]], result)
+
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -3055,6 +3090,104 @@ class CfnDistributionConfiguration(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_imagebuilder.CfnDistributionConfiguration.SsmParameterConfigurationProperty",
+        jsii_struct_bases=[],
+        name_mapping={
+            "parameter_name": "parameterName",
+            "ami_account_id": "amiAccountId",
+            "data_type": "dataType",
+        },
+    )
+    class SsmParameterConfigurationProperty:
+        def __init__(
+            self,
+            *,
+            parameter_name: builtins.str,
+            ami_account_id: typing.Optional[builtins.str] = None,
+            data_type: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''Configuration for a single Parameter in the AWS Systems Manager (SSM) Parameter Store in a given Region.
+
+            :param parameter_name: This is the name of the Parameter in the target Region or account. The image distribution creates the Parameter if it doesn't already exist. Otherwise, it updates the parameter.
+            :param ami_account_id: Specify the account that will own the Parameter in a given Region. During distribution, this account must be specified in distribution settings as a target account for the Region.
+            :param data_type: The data type specifies what type of value the Parameter contains. We recommend that you use data type ``aws:ec2:image`` .
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-distributionconfiguration-ssmparameterconfiguration.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_imagebuilder as imagebuilder
+                
+                ssm_parameter_configuration_property = imagebuilder.CfnDistributionConfiguration.SsmParameterConfigurationProperty(
+                    parameter_name="parameterName",
+                
+                    # the properties below are optional
+                    ami_account_id="amiAccountId",
+                    data_type="dataType"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__7078c821101535ab38d1fc3a5eaf267586f8ba156c0c7208c49773a19d7406c9)
+                check_type(argname="argument parameter_name", value=parameter_name, expected_type=type_hints["parameter_name"])
+                check_type(argname="argument ami_account_id", value=ami_account_id, expected_type=type_hints["ami_account_id"])
+                check_type(argname="argument data_type", value=data_type, expected_type=type_hints["data_type"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "parameter_name": parameter_name,
+            }
+            if ami_account_id is not None:
+                self._values["ami_account_id"] = ami_account_id
+            if data_type is not None:
+                self._values["data_type"] = data_type
+
+        @builtins.property
+        def parameter_name(self) -> builtins.str:
+            '''This is the name of the Parameter in the target Region or account.
+
+            The image distribution creates the Parameter if it doesn't already exist. Otherwise, it updates the parameter.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-distributionconfiguration-ssmparameterconfiguration.html#cfn-imagebuilder-distributionconfiguration-ssmparameterconfiguration-parametername
+            '''
+            result = self._values.get("parameter_name")
+            assert result is not None, "Required property 'parameter_name' is missing"
+            return typing.cast(builtins.str, result)
+
+        @builtins.property
+        def ami_account_id(self) -> typing.Optional[builtins.str]:
+            '''Specify the account that will own the Parameter in a given Region.
+
+            During distribution, this account must be specified in distribution settings as a target account for the Region.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-distributionconfiguration-ssmparameterconfiguration.html#cfn-imagebuilder-distributionconfiguration-ssmparameterconfiguration-amiaccountid
+            '''
+            result = self._values.get("ami_account_id")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def data_type(self) -> typing.Optional[builtins.str]:
+            '''The data type specifies what type of value the Parameter contains.
+
+            We recommend that you use data type ``aws:ec2:image`` .
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-distributionconfiguration-ssmparameterconfiguration.html#cfn-imagebuilder-distributionconfiguration-ssmparameterconfiguration-datatype
+            '''
+            result = self._values.get("data_type")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "SsmParameterConfigurationProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_imagebuilder.CfnDistributionConfiguration.TargetContainerRepositoryProperty",
         jsii_struct_bases=[],
@@ -3191,7 +3324,14 @@ class CfnDistributionConfigurationProps:
                         launch_template_id="launchTemplateId",
                         set_default_version=False
                     )],
-                    license_configuration_arns=["licenseConfigurationArns"]
+                    license_configuration_arns=["licenseConfigurationArns"],
+                    ssm_parameter_configurations=[imagebuilder.CfnDistributionConfiguration.SsmParameterConfigurationProperty(
+                        parameter_name="parameterName",
+            
+                        # the properties below are optional
+                        ami_account_id="amiAccountId",
+                        data_type="dataType"
+                    )]
                 )],
                 name="name",
             
@@ -9871,6 +10011,7 @@ def _typecheckingstub__29d1f34d5faec16ba828ad2333ee9218a18df31808a5a350be9b29d04
     fast_launch_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDistributionConfiguration.FastLaunchConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     launch_template_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDistributionConfiguration.LaunchTemplateConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     license_configuration_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
+    ssm_parameter_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDistributionConfiguration.SsmParameterConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -9921,6 +10062,15 @@ def _typecheckingstub__0b4c1c669ce6e1367a73060d15f089faa5ce58e96063ee38204bf9af1
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__7078c821101535ab38d1fc3a5eaf267586f8ba156c0c7208c49773a19d7406c9(
+    *,
+    parameter_name: builtins.str,
+    ami_account_id: typing.Optional[builtins.str] = None,
+    data_type: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__fd67a7cda75ae308d03a62ceb5b017b8de54cd08fd47374326a441ec680438a5(
     *,
     repository_name: typing.Optional[builtins.str] = None,

aws_cdk/aws_kinesisanalytics/__init__.py

@@ -5252,7 +5252,7 @@ class CfnApplicationV2(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param runtime_environment: The runtime environment for the application.
+        :param runtime_environment: The runtime environment for the application. *Allowed values for ``RuntimeEnvironment`` :* ``SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19 | FLINK-1_20``
         :param service_execution_role: Specifies the IAM role that the application uses to access external resources.
         :param application_configuration: Use this parameter to configure the application.
         :param application_description: The description of the application. Default: - ""
@@ -8884,7 +8884,7 @@ class CfnApplicationV2Props:
     ) -> None:
         '''Properties for defining a ``CfnApplication``.
 
-        :param runtime_environment: The runtime environment for the application.
+        :param runtime_environment: The runtime environment for the application. *Allowed values for ``RuntimeEnvironment`` :* ``SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19 | FLINK-1_20``
         :param service_execution_role: Specifies the IAM role that the application uses to access external resources.
         :param application_configuration: Use this parameter to configure the application.
         :param application_description: The description of the application. Default: - ""
@@ -9106,6 +9106,8 @@ class CfnApplicationV2Props:
     def runtime_environment(self) -> builtins.str:
         '''The runtime environment for the application.
 
+        *Allowed values for ``RuntimeEnvironment`` :* ``SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19 | FLINK-1_20``
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-kinesisanalyticsv2-application.html#cfn-kinesisanalyticsv2-application-runtimeenvironment
         '''
         result = self._values.get("runtime_environment")

aws_cdk/aws_kinesisanalyticsv2/__init__.py

@@ -277,7 +277,7 @@ class CfnApplication(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param runtime_environment: The runtime environment for the application.
+        :param runtime_environment: The runtime environment for the application. *Allowed values for ``RuntimeEnvironment`` :* ``SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19 | FLINK-1_20``
         :param service_execution_role: Specifies the IAM role that the application uses to access external resources.
         :param application_configuration: Use this parameter to configure the application.
         :param application_description: The description of the application. Default: - ""
@@ -4773,7 +4773,7 @@ class CfnApplicationProps:
     ) -> None:
         '''Properties for defining a ``CfnApplication``.
 
-        :param runtime_environment: The runtime environment for the application.
+        :param runtime_environment: The runtime environment for the application. *Allowed values for ``RuntimeEnvironment`` :* ``SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19 | FLINK-1_20``
         :param service_execution_role: Specifies the IAM role that the application uses to access external resources.
         :param application_configuration: Use this parameter to configure the application.
         :param application_description: The description of the application. Default: - ""
@@ -4995,6 +4995,8 @@ class CfnApplicationProps:
     def runtime_environment(self) -> builtins.str:
         '''The runtime environment for the application.
 
+        *Allowed values for ``RuntimeEnvironment`` :* ``SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19 | FLINK-1_20``
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-kinesisanalyticsv2-application.html#cfn-kinesisanalyticsv2-application-runtimeenvironment
         '''
         result = self._values.get("runtime_environment")

aws_cdk/aws_medialive/__init__.py

@@ -124,7 +124,7 @@ class CfnChannel(
         :param input_specification: The input specification for this channel. It specifies the key characteristics of the inputs for this channel: the maximum bitrate, the resolution, and the codec.
         :param log_level: The verbosity for logging activity for this channel. Charges for logging (which are generated through Amazon CloudWatch Logging) are higher for higher verbosities.
         :param maintenance: Maintenance settings for this channel.
-        :param name: A name for this audio selector. The AudioDescription (in an output) references this name in order to identify a specific input audio to include in that output.
+        :param name: Name of channel.
         :param role_arn: The IAM role for MediaLive to assume when running this channel. The role is identified by its ARN.
         :param tags: A collection of tags for this channel. Each tag is a key-value pair.
         :param vpc: Settings to enable VPC mode in the channel, so that the endpoints for all outputs are in your VPC.
@@ -415,7 +415,7 @@ class CfnChannel(
     @builtins.property
     @jsii.member(jsii_name="name")
     def name(self) -> typing.Optional[builtins.str]:
-        '''A name for this audio selector.'''
+        '''Name of channel.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "name"))
 
     @name.setter
@@ -24566,7 +24566,7 @@ class CfnChannelProps:
         :param input_specification: The input specification for this channel. It specifies the key characteristics of the inputs for this channel: the maximum bitrate, the resolution, and the codec.
         :param log_level: The verbosity for logging activity for this channel. Charges for logging (which are generated through Amazon CloudWatch Logging) are higher for higher verbosities.
         :param maintenance: Maintenance settings for this channel.
-        :param name: A name for this audio selector. The AudioDescription (in an output) references this name in order to identify a specific input audio to include in that output.
+        :param name: Name of channel.
         :param role_arn: The IAM role for MediaLive to assume when running this channel. The role is identified by its ARN.
         :param tags: A collection of tags for this channel. Each tag is a key-value pair.
         :param vpc: Settings to enable VPC mode in the channel, so that the endpoints for all outputs are in your VPC.
@@ -24749,9 +24749,7 @@ class CfnChannelProps:
 
     @builtins.property
     def name(self) -> typing.Optional[builtins.str]:
-        '''A name for this audio selector.
-
-        The AudioDescription (in an output) references this name in order to identify a specific input audio to include in that output.
+        '''Name of channel.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-medialive-channel.html#cfn-medialive-channel-name
         '''

aws_cdk/aws_mediatailor/__init__.py

@@ -1685,6 +1685,9 @@ class CfnPlaybackConfiguration(
             video_content_source_url="videoContentSourceUrl",
         
             # the properties below are optional
+            ad_conditioning_configuration=mediatailor.CfnPlaybackConfiguration.AdConditioningConfigurationProperty(
+                streaming_media_file_conditioning="streamingMediaFileConditioning"
+            ),
             avail_suppression=mediatailor.CfnPlaybackConfiguration.AvailSuppressionProperty(
                 fill_policy="fillPolicy",
                 mode="mode",
@@ -1736,6 +1739,7 @@ class CfnPlaybackConfiguration(
         ad_decision_server_url: builtins.str,
         name: builtins.str,
         video_content_source_url: builtins.str,
+        ad_conditioning_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnPlaybackConfiguration.AdConditioningConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         avail_suppression: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnPlaybackConfiguration.AvailSuppressionProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         bumper: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnPlaybackConfiguration.BumperProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         cdn_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnPlaybackConfiguration.CdnConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -1755,6 +1759,7 @@ class CfnPlaybackConfiguration(
         :param ad_decision_server_url: The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing you can provide a static VAST URL. The maximum length is 25,000 characters.
         :param name: The identifier for the playback configuration.
         :param video_content_source_url: The URL prefix for the parent manifest for the stream, minus the asset ID. The maximum length is 512 characters.
+        :param ad_conditioning_configuration: The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.
         :param avail_suppression: The configuration for avail suppression, also known as ad suppression. For more information about ad suppression, see `Ad Suppression <https://docs.aws.amazon.com/mediatailor/latest/ug/ad-behavior.html>`_ .
         :param bumper: The configuration for bumpers. Bumpers are short audio or video clips that play at the start or before the end of an ad break. To learn more about bumpers, see `Bumpers <https://docs.aws.amazon.com/mediatailor/latest/ug/bumpers.html>`_ .
         :param cdn_configuration: The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.
@@ -1776,6 +1781,7 @@ class CfnPlaybackConfiguration(
             ad_decision_server_url=ad_decision_server_url,
             name=name,
             video_content_source_url=video_content_source_url,
+            ad_conditioning_configuration=ad_conditioning_configuration,
             avail_suppression=avail_suppression,
             bumper=bumper,
             cdn_configuration=cdn_configuration,
@@ -1923,6 +1929,24 @@ class CfnPlaybackConfiguration(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "videoContentSourceUrl", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="adConditioningConfiguration")
+    def ad_conditioning_configuration(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPlaybackConfiguration.AdConditioningConfigurationProperty"]]:
+        '''The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.'''
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPlaybackConfiguration.AdConditioningConfigurationProperty"]], jsii.get(self, "adConditioningConfiguration"))
+
+    @ad_conditioning_configuration.setter
+    def ad_conditioning_configuration(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPlaybackConfiguration.AdConditioningConfigurationProperty"]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__bb81abb7826e9e9444261d39e06ed23acbaea73a559203da5ca788273a1bbc94)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "adConditioningConfiguration", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="availSuppression")
     def avail_suppression(
@@ -2122,6 +2146,62 @@ class CfnPlaybackConfiguration(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "transcodeProfileName", value) # pyright: ignore[reportArgumentType]
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_mediatailor.CfnPlaybackConfiguration.AdConditioningConfigurationProperty",
+        jsii_struct_bases=[],
+        name_mapping={
+            "streaming_media_file_conditioning": "streamingMediaFileConditioning",
+        },
+    )
+    class AdConditioningConfigurationProperty:
+        def __init__(self, *, streaming_media_file_conditioning: builtins.str) -> None:
+            '''The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.
+
+            :param streaming_media_file_conditioning: For ads that have media files with streaming delivery and supported file extensions, indicates what transcoding action MediaTailor takes when it first receives these ads from the ADS. ``TRANSCODE`` indicates that MediaTailor must transcode the ads. ``NONE`` indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. For more information about ad conditioning see `Using preconditioned ads <https://docs.aws.amazon.com/mediatailor/latest/ug/precondition-ads.html>`_ in the AWS Elemental MediaTailor user guide.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-mediatailor-playbackconfiguration-adconditioningconfiguration.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_mediatailor as mediatailor
+                
+                ad_conditioning_configuration_property = mediatailor.CfnPlaybackConfiguration.AdConditioningConfigurationProperty(
+                    streaming_media_file_conditioning="streamingMediaFileConditioning"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__86f7802737ba8294b0aa8d203c7f9bc7ff38b98bf17f1f9066c772b203c711ea)
+                check_type(argname="argument streaming_media_file_conditioning", value=streaming_media_file_conditioning, expected_type=type_hints["streaming_media_file_conditioning"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "streaming_media_file_conditioning": streaming_media_file_conditioning,
+            }
+
+        @builtins.property
+        def streaming_media_file_conditioning(self) -> builtins.str:
+            '''For ads that have media files with streaming delivery and supported file extensions, indicates what transcoding action MediaTailor takes when it first receives these ads from the ADS.
+
+            ``TRANSCODE`` indicates that MediaTailor must transcode the ads. ``NONE`` indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. For more information about ad conditioning see `Using preconditioned ads <https://docs.aws.amazon.com/mediatailor/latest/ug/precondition-ads.html>`_ in the AWS Elemental MediaTailor user guide.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-mediatailor-playbackconfiguration-adconditioningconfiguration.html#cfn-mediatailor-playbackconfiguration-adconditioningconfiguration-streamingmediafileconditioning
+            '''
+            result = self._values.get("streaming_media_file_conditioning")
+            assert result is not None, "Required property 'streaming_media_file_conditioning' is missing"
+            return typing.cast(builtins.str, result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "AdConditioningConfigurationProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_mediatailor.CfnPlaybackConfiguration.AdMarkerPassthroughProperty",
         jsii_struct_bases=[],
@@ -2723,6 +2803,7 @@ class CfnPlaybackConfiguration(
         "ad_decision_server_url": "adDecisionServerUrl",
         "name": "name",
         "video_content_source_url": "videoContentSourceUrl",
+        "ad_conditioning_configuration": "adConditioningConfiguration",
         "avail_suppression": "availSuppression",
         "bumper": "bumper",
         "cdn_configuration": "cdnConfiguration",
@@ -2744,6 +2825,7 @@ class CfnPlaybackConfigurationProps:
         ad_decision_server_url: builtins.str,
         name: builtins.str,
         video_content_source_url: builtins.str,
+        ad_conditioning_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.AdConditioningConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         avail_suppression: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.AvailSuppressionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         bumper: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.BumperProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         cdn_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.CdnConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -2762,6 +2844,7 @@ class CfnPlaybackConfigurationProps:
         :param ad_decision_server_url: The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing you can provide a static VAST URL. The maximum length is 25,000 characters.
         :param name: The identifier for the playback configuration.
         :param video_content_source_url: The URL prefix for the parent manifest for the stream, minus the asset ID. The maximum length is 512 characters.
+        :param ad_conditioning_configuration: The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.
         :param avail_suppression: The configuration for avail suppression, also known as ad suppression. For more information about ad suppression, see `Ad Suppression <https://docs.aws.amazon.com/mediatailor/latest/ug/ad-behavior.html>`_ .
         :param bumper: The configuration for bumpers. Bumpers are short audio or video clips that play at the start or before the end of an ad break. To learn more about bumpers, see `Bumpers <https://docs.aws.amazon.com/mediatailor/latest/ug/bumpers.html>`_ .
         :param cdn_configuration: The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.
@@ -2792,6 +2875,9 @@ class CfnPlaybackConfigurationProps:
                 video_content_source_url="videoContentSourceUrl",
             
                 # the properties below are optional
+                ad_conditioning_configuration=mediatailor.CfnPlaybackConfiguration.AdConditioningConfigurationProperty(
+                    streaming_media_file_conditioning="streamingMediaFileConditioning"
+                ),
                 avail_suppression=mediatailor.CfnPlaybackConfiguration.AvailSuppressionProperty(
                     fill_policy="fillPolicy",
                     mode="mode",
@@ -2839,6 +2925,7 @@ class CfnPlaybackConfigurationProps:
             check_type(argname="argument ad_decision_server_url", value=ad_decision_server_url, expected_type=type_hints["ad_decision_server_url"])
             check_type(argname="argument name", value=name, expected_type=type_hints["name"])
             check_type(argname="argument video_content_source_url", value=video_content_source_url, expected_type=type_hints["video_content_source_url"])
+            check_type(argname="argument ad_conditioning_configuration", value=ad_conditioning_configuration, expected_type=type_hints["ad_conditioning_configuration"])
             check_type(argname="argument avail_suppression", value=avail_suppression, expected_type=type_hints["avail_suppression"])
             check_type(argname="argument bumper", value=bumper, expected_type=type_hints["bumper"])
             check_type(argname="argument cdn_configuration", value=cdn_configuration, expected_type=type_hints["cdn_configuration"])
@@ -2856,6 +2943,8 @@ class CfnPlaybackConfigurationProps:
             "name": name,
             "video_content_source_url": video_content_source_url,
         }
+        if ad_conditioning_configuration is not None:
+            self._values["ad_conditioning_configuration"] = ad_conditioning_configuration
         if avail_suppression is not None:
             self._values["avail_suppression"] = avail_suppression
         if bumper is not None:
@@ -2915,6 +3004,17 @@ class CfnPlaybackConfigurationProps:
         assert result is not None, "Required property 'video_content_source_url' is missing"
         return typing.cast(builtins.str, result)
 
+    @builtins.property
+    def ad_conditioning_configuration(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnPlaybackConfiguration.AdConditioningConfigurationProperty]]:
+        '''The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediatailor-playbackconfiguration.html#cfn-mediatailor-playbackconfiguration-adconditioningconfiguration
+        '''
+        result = self._values.get("ad_conditioning_configuration")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnPlaybackConfiguration.AdConditioningConfigurationProperty]], result)
+
     @builtins.property
     def avail_suppression(
         self,
@@ -4496,6 +4596,7 @@ def _typecheckingstub__3dcfb97a898a80ee6a7b069e26028183e8a797f0c48fdbd4fe6ecb8ad
     ad_decision_server_url: builtins.str,
     name: builtins.str,
     video_content_source_url: builtins.str,
+    ad_conditioning_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.AdConditioningConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     avail_suppression: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.AvailSuppressionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     bumper: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.BumperProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     cdn_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.CdnConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -4542,6 +4643,12 @@ def _typecheckingstub__75b50d6fe13101dc70996fb19d5c8a163f6176ddcd37a0ebe0b08f5f7
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__bb81abb7826e9e9444261d39e06ed23acbaea73a559203da5ca788273a1bbc94(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnPlaybackConfiguration.AdConditioningConfigurationProperty]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__ace1eb1809c3c05a0b25523b0f61020aa7d5a69057cdffb522c74d7881b0c1c8(
     value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnPlaybackConfiguration.AvailSuppressionProperty]],
 ) -> None:
@@ -4614,6 +4721,13 @@ def _typecheckingstub__ab6a880d781d782bb5f703943747735b9af031af290dd1ad2e9ebe273
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__86f7802737ba8294b0aa8d203c7f9bc7ff38b98bf17f1f9066c772b203c711ea(
+    *,
+    streaming_media_file_conditioning: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__c84cc8c470c35ea1870d24a6e58a722cc2d0952d699c858000349755866ccea6(
     *,
     enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
@@ -4682,6 +4796,7 @@ def _typecheckingstub__935886ab495203cc213786b925e7fd8fe4acd3f9db5864d4f1f5c0115
     ad_decision_server_url: builtins.str,
     name: builtins.str,
     video_content_source_url: builtins.str,
+    ad_conditioning_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.AdConditioningConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     avail_suppression: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.AvailSuppressionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     bumper: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.BumperProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     cdn_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPlaybackConfiguration.CdnConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,