aws-cdk-lib 2.179.0__py3-none-any.whl → 2.180.0__py3-none-any.whl

aws_cdk/aws_groundstation/__init__.py

@@ -3030,6 +3030,7 @@ class CfnMissionProfile(
             contact_pre_pass_duration_seconds=123,
             streams_kms_key=groundstation.CfnMissionProfile.StreamsKmsKeyProperty(
                 kms_alias_arn="kmsAliasArn",
+                kms_alias_name="kmsAliasName",
                 kms_key_arn="kmsKeyArn"
             ),
             streams_kms_role="streamsKmsRole",
@@ -3364,18 +3365,24 @@ class CfnMissionProfile(
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_groundstation.CfnMissionProfile.StreamsKmsKeyProperty",
         jsii_struct_bases=[],
-        name_mapping={"kms_alias_arn": "kmsAliasArn", "kms_key_arn": "kmsKeyArn"},
+        name_mapping={
+            "kms_alias_arn": "kmsAliasArn",
+            "kms_alias_name": "kmsAliasName",
+            "kms_key_arn": "kmsKeyArn",
+        },
     )
     class StreamsKmsKeyProperty:
         def __init__(
             self,
             *,
             kms_alias_arn: typing.Optional[builtins.str] = None,
+            kms_alias_name: typing.Optional[builtins.str] = None,
             kms_key_arn: typing.Optional[builtins.str] = None,
         ) -> None:
             '''KMS key info.
 
             :param kms_alias_arn: KMS Alias Arn.
+            :param kms_alias_name: KMS Alias Name.
             :param kms_key_arn: KMS Key Arn.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-missionprofile-streamskmskey.html
@@ -3389,16 +3396,20 @@ class CfnMissionProfile(
                 
                 streams_kms_key_property = groundstation.CfnMissionProfile.StreamsKmsKeyProperty(
                     kms_alias_arn="kmsAliasArn",
+                    kms_alias_name="kmsAliasName",
                     kms_key_arn="kmsKeyArn"
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__9b72d6af08de28c6ebdf730f46ed7f026b1f417a505f1cd3c52737731cc4f6d0)
                 check_type(argname="argument kms_alias_arn", value=kms_alias_arn, expected_type=type_hints["kms_alias_arn"])
+                check_type(argname="argument kms_alias_name", value=kms_alias_name, expected_type=type_hints["kms_alias_name"])
                 check_type(argname="argument kms_key_arn", value=kms_key_arn, expected_type=type_hints["kms_key_arn"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
             if kms_alias_arn is not None:
                 self._values["kms_alias_arn"] = kms_alias_arn
+            if kms_alias_name is not None:
+                self._values["kms_alias_name"] = kms_alias_name
             if kms_key_arn is not None:
                 self._values["kms_key_arn"] = kms_key_arn
 
@@ -3411,6 +3422,15 @@ class CfnMissionProfile(
             result = self._values.get("kms_alias_arn")
             return typing.cast(typing.Optional[builtins.str], result)
 
+        @builtins.property
+        def kms_alias_name(self) -> typing.Optional[builtins.str]:
+            '''KMS Alias Name.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-missionprofile-streamskmskey.html#cfn-groundstation-missionprofile-streamskmskey-kmsaliasname
+            '''
+            result = self._values.get("kms_alias_name")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         @builtins.property
         def kms_key_arn(self) -> typing.Optional[builtins.str]:
             '''KMS Key Arn.
@@ -3496,6 +3516,7 @@ class CfnMissionProfileProps:
                 contact_pre_pass_duration_seconds=123,
                 streams_kms_key=groundstation.CfnMissionProfile.StreamsKmsKeyProperty(
                     kms_alias_arn="kmsAliasArn",
+                    kms_alias_name="kmsAliasName",
                     kms_key_arn="kmsKeyArn"
                 ),
                 streams_kms_role="streamsKmsRole",
@@ -4054,6 +4075,7 @@ def _typecheckingstub__b247611cb700acbb2d198be2f48ab39f22bafbf3844a6363be6523b5e
 def _typecheckingstub__9b72d6af08de28c6ebdf730f46ed7f026b1f417a505f1cd3c52737731cc4f6d0(
     *,
     kms_alias_arn: typing.Optional[builtins.str] = None,
+    kms_alias_name: typing.Optional[builtins.str] = None,
     kms_key_arn: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""

aws_cdk/aws_iam/__init__.py

@@ -10819,21 +10819,21 @@ class RoleProps:
 
         Example::
 
-            # Option 3: Create a new role that allows the account root principal to assume. Add this role in the `system:masters` and witch to this role from the AWS console.
-            # cluster: eks.Cluster
-            
+            lambda_role = iam.Role(self, "Role",
+                assumed_by=iam.ServicePrincipal("lambda.amazonaws.com"),
+                description="Example role..."
+            )
             
-            console_read_only_role = iam.Role(self, "ConsoleReadOnlyRole",
-                assumed_by=iam.ArnPrincipal("arn_for_trusted_principal")
+            stream = kinesis.Stream(self, "MyEncryptedStream",
+                encryption=kinesis.StreamEncryption.KMS
+            )
+            stream_consumer = kinesis.StreamConsumer(self, "MyStreamConsumer",
+                stream_consumer_name="MyStreamConsumer",
+                stream=stream
             )
-            console_read_only_role.add_to_policy(iam.PolicyStatement(
-                actions=["eks:AccessKubernetesApi", "eks:Describe*", "eks:List*"
-                ],
-                resources=[cluster.cluster_arn]
-            ))
             
-            # Add this role to system:masters RBAC group
-            cluster.aws_auth.add_masters_role(console_read_only_role)
+            # give lambda permissions to read stream via the stream consumer
+            stream_consumer.grant_read(lambda_role)
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__9c9223cb9fa6dff45ee4fd7013629ab18542c2499a83f542c5405968fad2287c)

aws_cdk/aws_iot/__init__.py

@@ -7540,6 +7540,13 @@ class CfnLogging(
 ):
     '''Configure logging.
 
+    .. epigraph::
+
+       If you already set the log function of AWS IoT Core , you can't deploy the AWS Cloud Development Kit (AWS CDK) to change the logging settings. You can change the logging settings by either:
+
+       - Importing a role into your AWS CloudFormation stack, such as with the `infrastructure as code generator (IaC generator) <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html>`_ .
+       - `Deleting the existing role <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html#roles-managingrole-deleting-console>`_ .
+
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iot-logging.html
     :cloudformationResource: AWS::IoT::Logging
     :exampleMetadata: fixture=_generated

aws_cdk/aws_ivs/__init__.py

@@ -142,7 +142,7 @@ class CfnChannel(
         :param container_format: Indicates which content-packaging format is used (MPEG-TS or fMP4). If multitrackInputConfiguration is specified and enabled is true, then containerFormat is required and must be set to FRAGMENTED_MP4. Otherwise, containerFormat may be set to TS or FRAGMENTED_MP4. Default: TS. Default: - "TS"
         :param insecure_ingest: Whether the channel allows insecure ingest. Default: - false
         :param latency_mode: Channel latency mode. Default: - "LOW"
-        :param multitrack_input_configuration: 
+        :param multitrack_input_configuration: Object specifying multitrack input configuration. Default: no multitrack input configuration is specified.
         :param name: Channel. Default: - "-"
         :param preset: Optional transcode preset for the channel. This is selectable only for ADVANCED_HD and ADVANCED_SD channel types. For those channel types, the default preset is HIGHER_BANDWIDTH_DELIVERY. For other channel types (BASIC and STANDARD), preset is the empty string ("").
         :param recording_configuration_arn: Recording Configuration ARN. A value other than an empty string indicates that recording is enabled. Default: "" (recording is disabled). Default: - ""
@@ -303,6 +303,7 @@ class CfnChannel(
     def multitrack_input_configuration(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannel.MultitrackInputConfigurationProperty"]]:
+        '''Object specifying multitrack input configuration.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannel.MultitrackInputConfigurationProperty"]], jsii.get(self, "multitrackInputConfiguration"))
 
     @multitrack_input_configuration.setter
@@ -397,7 +398,8 @@ class CfnChannel(
             maximum_resolution: typing.Optional[builtins.str] = None,
             policy: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
+            '''A complex type that specifies multitrack input configuration.
+
             :param enabled: Indicates whether multitrack input is enabled. Can be set to true only if channel type is STANDARD. Setting enabled to true with any other channel type will cause an exception. If true, then policy, maximumResolution, and containerFormat are required, and containerFormat must be set to FRAGMENTED_MP4. Default: false. Default: - false
             :param maximum_resolution: Maximum resolution for multitrack input. Required if enabled is true.
             :param policy: Indicates whether multitrack input is allowed or required. Required if enabled is true.
@@ -516,7 +518,7 @@ class CfnChannelProps:
         :param container_format: Indicates which content-packaging format is used (MPEG-TS or fMP4). If multitrackInputConfiguration is specified and enabled is true, then containerFormat is required and must be set to FRAGMENTED_MP4. Otherwise, containerFormat may be set to TS or FRAGMENTED_MP4. Default: TS. Default: - "TS"
         :param insecure_ingest: Whether the channel allows insecure ingest. Default: - false
         :param latency_mode: Channel latency mode. Default: - "LOW"
-        :param multitrack_input_configuration: 
+        :param multitrack_input_configuration: Object specifying multitrack input configuration. Default: no multitrack input configuration is specified.
         :param name: Channel. Default: - "-"
         :param preset: Optional transcode preset for the channel. This is selectable only for ADVANCED_HD and ADVANCED_SD channel types. For those channel types, the default preset is HIGHER_BANDWIDTH_DELIVERY. For other channel types (BASIC and STANDARD), preset is the empty string ("").
         :param recording_configuration_arn: Recording Configuration ARN. A value other than an empty string indicates that recording is enabled. Default: "" (recording is disabled). Default: - ""
@@ -640,7 +642,10 @@ class CfnChannelProps:
     def multitrack_input_configuration(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnChannel.MultitrackInputConfigurationProperty]]:
-        '''
+        '''Object specifying multitrack input configuration.
+
+        Default: no multitrack input configuration is specified.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ivs-channel.html#cfn-ivs-channel-multitrackinputconfiguration
         '''
         result = self._values.get("multitrack_input_configuration")
@@ -1529,7 +1534,7 @@ class CfnPlaybackKeyPair(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param name: Playback-key-pair name. The value does not need to be unique.
-        :param public_key_material: The public portion of a customer-generated key pair.
+        :param public_key_material: The public portion of a customer-generated key pair. Note that this field is required to create the AWS::IVS::PlaybackKeyPair resource.
         :param tags: An array of key-value pairs to apply to this resource. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ivs-playbackkeypair-tag.html>`_ .
         '''
         if __debug__:
@@ -1665,7 +1670,7 @@ class CfnPlaybackKeyPairProps:
         '''Properties for defining a ``CfnPlaybackKeyPair``.
 
         :param name: Playback-key-pair name. The value does not need to be unique.
-        :param public_key_material: The public portion of a customer-generated key pair.
+        :param public_key_material: The public portion of a customer-generated key pair. Note that this field is required to create the AWS::IVS::PlaybackKeyPair resource.
         :param tags: An array of key-value pairs to apply to this resource. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ivs-playbackkeypair-tag.html>`_ .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ivs-playbackkeypair.html
@@ -1714,6 +1719,8 @@ class CfnPlaybackKeyPairProps:
     def public_key_material(self) -> typing.Optional[builtins.str]:
         '''The public portion of a customer-generated key pair.
 
+        Note that this field is required to create the AWS::IVS::PlaybackKeyPair resource.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ivs-playbackkeypair.html#cfn-ivs-playbackkeypair-publickeymaterial
         '''
         result = self._values.get("public_key_material")
@@ -2114,7 +2121,7 @@ class CfnPublicKey(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param name: Public key name. The value does not need to be unique.
-        :param public_key_material: The public portion of a customer-generated key pair.
+        :param public_key_material: The public portion of a customer-generated key pair. Note that this field is required to create the AWS::IVS::PublicKey resource.
         :param tags: An array of key-value pairs to apply to this resource.
         '''
         if __debug__:
@@ -2250,7 +2257,7 @@ class CfnPublicKeyProps:
         '''Properties for defining a ``CfnPublicKey``.
 
         :param name: Public key name. The value does not need to be unique.
-        :param public_key_material: The public portion of a customer-generated key pair.
+        :param public_key_material: The public portion of a customer-generated key pair. Note that this field is required to create the AWS::IVS::PublicKey resource.
         :param tags: An array of key-value pairs to apply to this resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ivs-publickey.html
@@ -2299,6 +2306,8 @@ class CfnPublicKeyProps:
     def public_key_material(self) -> typing.Optional[builtins.str]:
         '''The public portion of a customer-generated key pair.
 
+        Note that this field is required to create the AWS::IVS::PublicKey resource.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ivs-publickey.html#cfn-ivs-publickey-publickeymaterial
         '''
         result = self._values.get("public_key_material")