aws-cdk-lib 2.75.1__py3-none-any.whl → 2.76.0__py3-none-any.whl

aws_cdk/aws_events_targets/__init__.py

@@ -59,7 +59,7 @@ queue = sqs.Queue(self, "Queue")
 
 rule.add_target(targets.LambdaFunction(fn,
     dead_letter_queue=queue,  # Optional: add a dead letter queue
-    max_event_age=cdk.Duration.hours(2),  # Optional: set the maxEventAge retry policy
+    max_event_age=Duration.hours(2),  # Optional: set the maxEventAge retry policy
     retry_attempts=2
 ))
 ```
@@ -92,16 +92,15 @@ A rule target input can also be specified to modify the event that is sent to th
 Unlike other event targets, CloudWatchLogs requires a specific input template format.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 import aws_cdk.aws_logs as logs
 # log_group: logs.LogGroup
 # rule: events.Rule
 
 
 rule.add_target(targets.CloudWatchLogGroup(log_group,
-    log_event=targets.LogGroupTargetInput(
-        timestamp=events.EventField.from("$.time"),
-        message=events.EventField.from("$.detail-type")
+    log_event=targets.LogGroupTargetInput.from_object(
+        timestamp=events.EventField.from_path("$.time"),
+        message=events.EventField.from_path("$.detail-type")
     )
 ))
 ```
@@ -110,14 +109,13 @@ If you want to use static values to overwrite the `message` make sure that you p
 value.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 import aws_cdk.aws_logs as logs
 # log_group: logs.LogGroup
 # rule: events.Rule
 
 
 rule.add_target(targets.CloudWatchLogGroup(log_group,
-    log_event=targets.LogGroupTargetInput(
+    log_event=targets.LogGroupTargetInput.from_object(
         message=JSON.stringify({
             "CustomField": "CustomValue"
         })
@@ -192,7 +190,7 @@ import aws_cdk.aws_stepfunctions as sfn
 
 
 rule = events.Rule(self, "Rule",
-    schedule=events.Schedule.rate(cdk.Duration.minutes(1))
+    schedule=events.Schedule.rate(Duration.minutes(1))
 )
 
 dlq = sqs.Queue(self, "DeadLetterQueue")
@@ -201,7 +199,7 @@ role = iam.Role(self, "Role",
     assumed_by=iam.ServicePrincipal("events.amazonaws.com")
 )
 state_machine = sfn.StateMachine(self, "SM",
-    definition=sfn.Wait(self, "Hello", time=sfn.WaitTime.duration(cdk.Duration.seconds(10)))
+    definition=sfn.Wait(self, "Hello", time=sfn.WaitTime.duration(Duration.seconds(10)))
 )
 
 rule.add_target(targets.SfnStateMachine(state_machine,
@@ -223,17 +221,17 @@ to the target.
 
 ```python
 # Example automatically generated from non-compiling source. May contain errors.
-import aws_cdk.aws_batch as batch
+import aws_cdk.aws_batch_alpha as batch
 from aws_cdk.aws_ecs import ContainerImage
 
 
 job_queue = batch.JobQueue(self, "MyQueue",
-    compute_environments=[{
-        "compute_environment": batch.ComputeEnvironment(self, "ComputeEnvironment",
+    compute_environments=[batch.OrderedComputeEnvironment(
+        compute_environment=batch.ComputeEnvironment(self, "ComputeEnvironment",
             managed=False
         ),
-        "order": 1
-    }
+        order=1
+    )
     ]
 )
 
@@ -246,14 +244,14 @@ job_definition = batch.JobDefinition(self, "MyJob",
 queue = sqs.Queue(self, "Queue")
 
 rule = events.Rule(self, "Rule",
-    schedule=events.Schedule.rate(cdk.Duration.hours(1))
+    schedule=events.Schedule.rate(Duration.hours(1))
 )
 
 rule.add_target(targets.BatchJob(job_queue.job_queue_arn, job_queue, job_definition.job_definition_arn, job_definition,
     dead_letter_queue=queue,
     event=events.RuleTargetInput.from_object({"SomeParam": "SomeValue"}),
     retry_attempts=2,
-    max_event_age=cdk.Duration.hours(2)
+    max_event_age=Duration.hours(2)
 ))
 ```
 
@@ -269,7 +267,7 @@ import aws_cdk.aws_lambda as lambda_
 
 
 rule = events.Rule(self, "Rule",
-    schedule=events.Schedule.rate(cdk.Duration.minutes(1))
+    schedule=events.Schedule.rate(Duration.minutes(1))
 )
 
 fn = lambda_.Function(self, "MyFunc",
@@ -318,7 +316,7 @@ destination = events.ApiDestination(self, "Destination",
 )
 
 rule = events.Rule(self, "Rule",
-    schedule=events.Schedule.rate(cdk.Duration.minutes(1)),
+    schedule=events.Schedule.rate(Duration.minutes(1)),
     targets=[targets.ApiDestination(destination)]
 )
 ```
@@ -337,6 +335,46 @@ rule = events.Rule(self, "Rule",
 rule.add_target(targets.EventBus(
     events.EventBus.from_event_bus_arn(self, "External", "arn:aws:events:eu-west-1:999999999999:event-bus/test-bus")))
 ```
+
+## Run an ECS Task
+
+Use the `EcsTask` target to run an ECS Task.
+
+The code snippet below creates a scheduled event rule that will run the task described in `taskDefinition` every hour.
+
+### Tagging Tasks
+
+By default, ECS tasks run from EventBridge targets will not have tags applied to
+them. You can set the `propagateTags` field to propagate the tags set on the task
+definition to the task initialized by the event trigger.
+
+If you want to set tags independent of those applied to the TaskDefinition, you
+can use the `tags` array. Both of these fields can be used together or separately
+to set tags on the triggered task.
+
+```python
+# Example automatically generated from non-compiling source. May contain errors.
+import aws_cdk.aws_ecs as ecs
+# cluster: ecs.ICluster
+# task_definition: ecs.TaskDefinition
+
+
+rule = events.Rule(self, "Rule",
+    schedule=events.Schedule.rate(cdk.Duration.hours(1))
+)
+
+rule.add_target(
+    targets.EcsTask(
+        cluster=cluster,
+        task_definition=task_definition,
+        propagate_tags=ecs.PropagatedTagSource.TASK_DEFINITION,
+        tags=[targets.Tag(
+            key="my-tag",
+            value="my-tag-value"
+        )
+        ]
+    ))
+```
 '''
 import abc
 import builtins
@@ -365,6 +403,7 @@ from ..aws_ecs import (
     FargatePlatformVersion as _FargatePlatformVersion_55d8be5c,
     ICluster as _ICluster_16cddd09,
     ITaskDefinition as _ITaskDefinition_889ba4d8,
+    PropagatedTagSource as _PropagatedTagSource_ad4e874a,
 )
 from ..aws_events import (
     IApiDestination as _IApiDestination_44cdeedd,
@@ -410,7 +449,7 @@ class ApiDestination(
         )
         
         rule = events.Rule(self, "Rule",
-            schedule=events.Schedule.rate(cdk.Duration.minutes(1)),
+            schedule=events.Schedule.rate(Duration.minutes(1)),
             targets=[targets.ApiDestination(destination)]
         )
     '''
@@ -489,7 +528,7 @@ class ApiGateway(
         
         
         rule = events.Rule(self, "Rule",
-            schedule=events.Schedule.rate(cdk.Duration.minutes(1))
+            schedule=events.Schedule.rate(Duration.minutes(1))
         )
         
         fn = lambda_.Function(self, "MyFunc",
@@ -976,17 +1015,17 @@ class BatchJob(
     Example::
 
         # Example automatically generated from non-compiling source. May contain errors.
-        import aws_cdk.aws_batch as batch
+        import aws_cdk.aws_batch_alpha as batch
         from aws_cdk.aws_ecs import ContainerImage
         
         
         job_queue = batch.JobQueue(self, "MyQueue",
-            compute_environments=[{
-                "compute_environment": batch.ComputeEnvironment(self, "ComputeEnvironment",
+            compute_environments=[batch.OrderedComputeEnvironment(
+                compute_environment=batch.ComputeEnvironment(self, "ComputeEnvironment",
                     managed=False
                 ),
-                "order": 1
-            }
+                order=1
+            )
             ]
         )
         
@@ -999,14 +1038,14 @@ class BatchJob(
         queue = sqs.Queue(self, "Queue")
         
         rule = events.Rule(self, "Rule",
-            schedule=events.Schedule.rate(cdk.Duration.hours(1))
+            schedule=events.Schedule.rate(Duration.hours(1))
         )
         
         rule.add_target(targets.BatchJob(job_queue.job_queue_arn, job_queue, job_definition.job_definition_arn, job_definition,
             dead_letter_queue=queue,
             event=events.RuleTargetInput.from_object({"SomeParam": "SomeValue"}),
             retry_attempts=2,
-            max_event_age=cdk.Duration.hours(2)
+            max_event_age=Duration.hours(2)
         ))
     '''
 
@@ -1085,14 +1124,13 @@ class CloudWatchLogGroup(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         import aws_cdk.aws_logs as logs
         # log_group: logs.LogGroup
         # rule: events.Rule
         
         
         rule.add_target(targets.CloudWatchLogGroup(log_group,
-            log_event=targets.LogGroupTargetInput(
+            log_event=targets.LogGroupTargetInput.from_object(
                 message=JSON.stringify({
                     "CustomField": "CustomValue"
                 })
@@ -1445,26 +1483,31 @@ class EcsTask(
 ):
     '''Start a task on an ECS cluster.
 
-    :exampleMetadata: fixture=basic infused
+    :exampleMetadata: infused
 
     Example::
 
-        from aws_cdk.aws_events import Rule, Schedule
-        from aws_cdk.aws_events_targets import EcsTask
-        from aws_cdk.aws_ecs import Cluster, TaskDefinition
-        from aws_cdk.aws_iam import Role
-        
-        # cluster: Cluster
-        # task_definition: TaskDefinition
-        # role: Role
-        
+        # Example automatically generated from non-compiling source. May contain errors.
+        import aws_cdk.aws_ecs as ecs
+        # cluster: ecs.ICluster
+        # task_definition: ecs.TaskDefinition
         
-        ecs_task_target = EcsTask(cluster=cluster, task_definition=task_definition, role=role)
         
-        Rule(self, "ScheduleRule",
-            schedule=Schedule.cron(minute="0", hour="4"),
-            targets=[ecs_task_target]
+        rule = events.Rule(self, "Rule",
+            schedule=events.Schedule.rate(cdk.Duration.hours(1))
         )
+        
+        rule.add_target(
+            targets.EcsTask(
+                cluster=cluster,
+                task_definition=task_definition,
+                propagate_tags=ecs.PropagatedTagSource.TASK_DEFINITION,
+                tags=[targets.Tag(
+                    key="my-tag",
+                    value="my-tag-value"
+                )
+                ]
+            ))
     '''
 
     def __init__(
@@ -1474,9 +1517,11 @@ class EcsTask(
         task_definition: _ITaskDefinition_889ba4d8,
         container_overrides: typing.Optional[typing.Sequence[typing.Union[ContainerOverride, typing.Dict[builtins.str, typing.Any]]]] = None,
         platform_version: typing.Optional[_FargatePlatformVersion_55d8be5c] = None,
+        propagate_tags: typing.Optional[_PropagatedTagSource_ad4e874a] = None,
         role: typing.Optional[_IRole_235f5d8e] = None,
         security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
         subnet_selection: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union["Tag", typing.Dict[builtins.str, typing.Any]]]] = None,
         task_count: typing.Optional[jsii.Number] = None,
         dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
         max_event_age: typing.Optional[_Duration_4839e8c3] = None,
@@ -1487,9 +1532,11 @@ class EcsTask(
         :param task_definition: Task Definition of the task that should be started.
         :param container_overrides: Container setting overrides. Key is the name of the container to override, value is the values you want to override.
         :param platform_version: The platform version on which to run your task. Unless you have specific compatibility requirements, you don't need to specify this. Default: - ECS will set the Fargate platform version to 'LATEST'
+        :param propagate_tags: Specifies whether to propagate the tags from the task definition to the task. If no value is specified, the tags are not propagated. Default: - Tags will not be propagated
         :param role: Existing IAM role to run the ECS task. Default: A new IAM role is created
         :param security_groups: Existing security groups to use for the task's ENIs. (Only applicable in case the TaskDefinition is configured for AwsVpc networking) Default: A new security group is created
         :param subnet_selection: In what subnets to place the task's ENIs. (Only applicable in case the TaskDefinition is configured for AwsVpc networking) Default: Private subnets
+        :param tags: The metadata that you apply to the task to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. Default: - No additional tags are applied to the task
         :param task_count: How many tasks should be started when this event is triggered. Default: 1
         :param dead_letter_queue: The SQS queue to be used as deadLetterQueue. Check out the `considerations for using a dead-letter queue <https://docs.aws.amazon.com/eventbridge/latest/userguide/rule-dlq.html#dlq-considerations>`_. The events not successfully delivered are automatically retried for a specified period of time, depending on the retry policy of the target. If an event is not delivered before all retry attempts are exhausted, it will be sent to the dead letter queue. Default: - no dead-letter queue
         :param max_event_age: The maximum age of a request that Lambda sends to a function for processing. Minimum value of 60. Maximum value of 86400. Default: Duration.hours(24)
@@ -1500,9 +1547,11 @@ class EcsTask(
             task_definition=task_definition,
             container_overrides=container_overrides,
             platform_version=platform_version,
+            propagate_tags=propagate_tags,
             role=role,
             security_groups=security_groups,
             subnet_selection=subnet_selection,
+            tags=tags,
             task_count=task_count,
             dead_letter_queue=dead_letter_queue,
             max_event_age=max_event_age,
@@ -1957,7 +2006,7 @@ class LambdaFunction(
         
         rule.add_target(targets.LambdaFunction(fn,
             dead_letter_queue=queue,  # Optional: add a dead letter queue
-            max_event_age=cdk.Duration.hours(2),  # Optional: set the maxEventAge retry policy
+            max_event_age=Duration.hours(2),  # Optional: set the maxEventAge retry policy
             retry_attempts=2
         ))
     '''
@@ -2018,16 +2067,15 @@ class LogGroupTargetInput(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         import aws_cdk.aws_logs as logs
         # log_group: logs.LogGroup
         # rule: events.Rule
         
         
         rule.add_target(targets.CloudWatchLogGroup(log_group,
-            log_event=targets.LogGroupTargetInput(
-                timestamp=events.EventField.from("$.time"),
-                message=events.EventField.from("$.detail-type")
+            log_event=targets.LogGroupTargetInput.from_object(
+                timestamp=events.EventField.from_path("$.time"),
+                message=events.EventField.from_path("$.detail-type")
             )
         ))
     '''
@@ -2098,21 +2146,21 @@ class LogGroupTargetInputOptions:
         :param message: The value provided here will be used in the Log "message" field. This field must be a string. If an object is passed (e.g. JSON data) it will not throw an error, but the message that makes it to CloudWatch logs will be incorrect. This is a likely scenario if doing something like: EventField.fromPath('$.detail') since in most cases the ``detail`` field contains JSON data. Default: EventField.detailType
         :param timestamp: The timestamp that will appear in the CloudWatch Logs record. Default: EventField.time
 
-        :exampleMetadata: fixture=_generated
+        :exampleMetadata: infused
 
         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_events_targets as events_targets
+            import aws_cdk.aws_logs as logs
+            # log_group: logs.LogGroup
+            # rule: events.Rule
             
-            # message: Any
-            # timestamp: Any
             
-            log_group_target_input_options = events_targets.LogGroupTargetInputOptions(
-                message=message,
-                timestamp=timestamp
-            )
+            rule.add_target(targets.CloudWatchLogGroup(log_group,
+                log_event=targets.LogGroupTargetInput.from_object(
+                    timestamp=events.EventField.from_path("$.time"),
+                    message=events.EventField.from_path("$.detail-type")
+                )
+            ))
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__12b2a1770edaa7f8ba5d731e85339d65d757aa25fd54d6c6be4746c6a4f4a070)
@@ -2176,7 +2224,7 @@ class SfnStateMachine(
         
         
         rule = events.Rule(self, "Rule",
-            schedule=events.Schedule.rate(cdk.Duration.minutes(1))
+            schedule=events.Schedule.rate(Duration.minutes(1))
         )
         
         dlq = sqs.Queue(self, "DeadLetterQueue")
@@ -2185,7 +2233,7 @@ class SfnStateMachine(
             assumed_by=iam.ServicePrincipal("events.amazonaws.com")
         )
         state_machine = sfn.StateMachine(self, "SM",
-            definition=sfn.Wait(self, "Hello", time=sfn.WaitTime.duration(cdk.Duration.seconds(10)))
+            definition=sfn.Wait(self, "Hello", time=sfn.WaitTime.duration(Duration.seconds(10)))
         )
         
         rule.add_target(targets.SfnStateMachine(state_machine,
@@ -2388,6 +2436,68 @@ class SqsQueue(
         return typing.cast(_IQueue_7ed6f679, jsii.get(self, "queue"))
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_events_targets.Tag",
+    jsii_struct_bases=[],
+    name_mapping={"key": "key", "value": "value"},
+)
+class Tag:
+    def __init__(self, *, key: builtins.str, value: builtins.str) -> None:
+        '''Metadata that you apply to a resource to help categorize and organize the resource.
+
+        Each tag consists of a key and an optional value, both of which you define.
+
+        :param key: Key is the name of the tag.
+        :param value: Value is the metadata contents of the tag.
+
+        :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_events_targets as events_targets
+            
+            tag = events_targets.Tag(
+                key="key",
+                value="value"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__a813f48d70b31d8149568e4c733eee0b3ddf93c3d8ee22172032406da2f91b10)
+            check_type(argname="argument key", value=key, expected_type=type_hints["key"])
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "key": key,
+            "value": value,
+        }
+
+    @builtins.property
+    def key(self) -> builtins.str:
+        '''Key is the name of the tag.'''
+        result = self._values.get("key")
+        assert result is not None, "Required property 'key' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def value(self) -> builtins.str:
+        '''Value is the metadata contents of the tag.'''
+        result = self._values.get("value")
+        assert result is not None, "Required property 'value' 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 "Tag(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_events_targets.TargetBaseProps",
     jsii_struct_bases=[],
@@ -2821,7 +2931,7 @@ class ApiGatewayProps(TargetBaseProps):
             
             
             rule = events.Rule(self, "Rule",
-                schedule=events.Schedule.rate(cdk.Duration.minutes(1))
+                schedule=events.Schedule.rate(Duration.minutes(1))
             )
             
             fn = lambda_.Function(self, "MyFunc",
@@ -3054,17 +3164,17 @@ class BatchJobProps(TargetBaseProps):
         Example::
 
             # Example automatically generated from non-compiling source. May contain errors.
-            import aws_cdk.aws_batch as batch
+            import aws_cdk.aws_batch_alpha as batch
             from aws_cdk.aws_ecs import ContainerImage
             
             
             job_queue = batch.JobQueue(self, "MyQueue",
-                compute_environments=[{
-                    "compute_environment": batch.ComputeEnvironment(self, "ComputeEnvironment",
+                compute_environments=[batch.OrderedComputeEnvironment(
+                    compute_environment=batch.ComputeEnvironment(self, "ComputeEnvironment",
                         managed=False
                     ),
-                    "order": 1
-                }
+                    order=1
+                )
                 ]
             )
             
@@ -3077,14 +3187,14 @@ class BatchJobProps(TargetBaseProps):
             queue = sqs.Queue(self, "Queue")
             
             rule = events.Rule(self, "Rule",
-                schedule=events.Schedule.rate(cdk.Duration.hours(1))
+                schedule=events.Schedule.rate(Duration.hours(1))
             )
             
             rule.add_target(targets.BatchJob(job_queue.job_queue_arn, job_queue, job_definition.job_definition_arn, job_definition,
                 dead_letter_queue=queue,
                 event=events.RuleTargetInput.from_object({"SomeParam": "SomeValue"}),
                 retry_attempts=2,
-                max_event_age=cdk.Duration.hours(2)
+                max_event_age=Duration.hours(2)
             ))
         '''
         if __debug__:
@@ -3478,9 +3588,11 @@ class CodePipelineTargetOptions(TargetBaseProps):
         "task_definition": "taskDefinition",
         "container_overrides": "containerOverrides",
         "platform_version": "platformVersion",
+        "propagate_tags": "propagateTags",
         "role": "role",
         "security_groups": "securityGroups",
         "subnet_selection": "subnetSelection",
+        "tags": "tags",
         "task_count": "taskCount",
     },
 )
@@ -3495,9 +3607,11 @@ class EcsTaskProps(TargetBaseProps):
         task_definition: _ITaskDefinition_889ba4d8,
         container_overrides: typing.Optional[typing.Sequence[typing.Union[ContainerOverride, typing.Dict[builtins.str, typing.Any]]]] = None,
         platform_version: typing.Optional[_FargatePlatformVersion_55d8be5c] = None,
+        propagate_tags: typing.Optional[_PropagatedTagSource_ad4e874a] = None,
         role: typing.Optional[_IRole_235f5d8e] = None,
         security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
         subnet_selection: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union[Tag, typing.Dict[builtins.str, typing.Any]]]] = None,
         task_count: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''Properties to define an ECS Event Task.
@@ -3509,31 +3623,38 @@ class EcsTaskProps(TargetBaseProps):
         :param task_definition: Task Definition of the task that should be started.
         :param container_overrides: Container setting overrides. Key is the name of the container to override, value is the values you want to override.
         :param platform_version: The platform version on which to run your task. Unless you have specific compatibility requirements, you don't need to specify this. Default: - ECS will set the Fargate platform version to 'LATEST'
+        :param propagate_tags: Specifies whether to propagate the tags from the task definition to the task. If no value is specified, the tags are not propagated. Default: - Tags will not be propagated
         :param role: Existing IAM role to run the ECS task. Default: A new IAM role is created
         :param security_groups: Existing security groups to use for the task's ENIs. (Only applicable in case the TaskDefinition is configured for AwsVpc networking) Default: A new security group is created
         :param subnet_selection: In what subnets to place the task's ENIs. (Only applicable in case the TaskDefinition is configured for AwsVpc networking) Default: Private subnets
+        :param tags: The metadata that you apply to the task to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. Default: - No additional tags are applied to the task
         :param task_count: How many tasks should be started when this event is triggered. Default: 1
 
-        :exampleMetadata: fixture=basic infused
+        :exampleMetadata: infused
 
         Example::
 
-            from aws_cdk.aws_events import Rule, Schedule
-            from aws_cdk.aws_events_targets import EcsTask
-            from aws_cdk.aws_ecs import Cluster, TaskDefinition
-            from aws_cdk.aws_iam import Role
-            
-            # cluster: Cluster
-            # task_definition: TaskDefinition
-            # role: Role
-            
+            # Example automatically generated from non-compiling source. May contain errors.
+            import aws_cdk.aws_ecs as ecs
+            # cluster: ecs.ICluster
+            # task_definition: ecs.TaskDefinition
             
-            ecs_task_target = EcsTask(cluster=cluster, task_definition=task_definition, role=role)
             
-            Rule(self, "ScheduleRule",
-                schedule=Schedule.cron(minute="0", hour="4"),
-                targets=[ecs_task_target]
+            rule = events.Rule(self, "Rule",
+                schedule=events.Schedule.rate(cdk.Duration.hours(1))
             )
+            
+            rule.add_target(
+                targets.EcsTask(
+                    cluster=cluster,
+                    task_definition=task_definition,
+                    propagate_tags=ecs.PropagatedTagSource.TASK_DEFINITION,
+                    tags=[targets.Tag(
+                        key="my-tag",
+                        value="my-tag-value"
+                    )
+                    ]
+                ))
         '''
         if isinstance(subnet_selection, dict):
             subnet_selection = _SubnetSelection_e57d76df(**subnet_selection)
@@ -3546,9 +3667,11 @@ class EcsTaskProps(TargetBaseProps):
             check_type(argname="argument task_definition", value=task_definition, expected_type=type_hints["task_definition"])
             check_type(argname="argument container_overrides", value=container_overrides, expected_type=type_hints["container_overrides"])
             check_type(argname="argument platform_version", value=platform_version, expected_type=type_hints["platform_version"])
+            check_type(argname="argument propagate_tags", value=propagate_tags, expected_type=type_hints["propagate_tags"])
             check_type(argname="argument role", value=role, expected_type=type_hints["role"])
             check_type(argname="argument security_groups", value=security_groups, expected_type=type_hints["security_groups"])
             check_type(argname="argument subnet_selection", value=subnet_selection, expected_type=type_hints["subnet_selection"])
+            check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
             check_type(argname="argument task_count", value=task_count, expected_type=type_hints["task_count"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "cluster": cluster,
@@ -3564,12 +3687,16 @@ class EcsTaskProps(TargetBaseProps):
             self._values["container_overrides"] = container_overrides
         if platform_version is not None:
             self._values["platform_version"] = platform_version
+        if propagate_tags is not None:
+            self._values["propagate_tags"] = propagate_tags
         if role is not None:
             self._values["role"] = role
         if security_groups is not None:
             self._values["security_groups"] = security_groups
         if subnet_selection is not None:
             self._values["subnet_selection"] = subnet_selection
+        if tags is not None:
+            self._values["tags"] = tags
         if task_count is not None:
             self._values["task_count"] = task_count
 
@@ -3647,6 +3774,17 @@ class EcsTaskProps(TargetBaseProps):
         result = self._values.get("platform_version")
         return typing.cast(typing.Optional[_FargatePlatformVersion_55d8be5c], result)
 
+    @builtins.property
+    def propagate_tags(self) -> typing.Optional[_PropagatedTagSource_ad4e874a]:
+        '''Specifies whether to propagate the tags from the task definition to the task.
+
+        If no value is specified, the tags are not propagated.
+
+        :default: - Tags will not be propagated
+        '''
+        result = self._values.get("propagate_tags")
+        return typing.cast(typing.Optional[_PropagatedTagSource_ad4e874a], result)
+
     @builtins.property
     def role(self) -> typing.Optional[_IRole_235f5d8e]:
         '''Existing IAM role to run the ECS task.
@@ -3678,6 +3816,17 @@ class EcsTaskProps(TargetBaseProps):
         result = self._values.get("subnet_selection")
         return typing.cast(typing.Optional[_SubnetSelection_e57d76df], result)
 
+    @builtins.property
+    def tags(self) -> typing.Optional[typing.List[Tag]]:
+        '''The metadata that you apply to the task to help you categorize and organize them.
+
+        Each tag consists of a key and an optional value, both of which you define.
+
+        :default: - No additional tags are applied to the task
+        '''
+        result = self._values.get("tags")
+        return typing.cast(typing.Optional[typing.List[Tag]], result)
+
     @builtins.property
     def task_count(self) -> typing.Optional[jsii.Number]:
         '''How many tasks should be started when this event is triggered.
@@ -3748,7 +3897,7 @@ class LambdaFunctionProps(TargetBaseProps):
             
             rule.add_target(targets.LambdaFunction(fn,
                 dead_letter_queue=queue,  # Optional: add a dead letter queue
-                max_event_age=cdk.Duration.hours(2),  # Optional: set the maxEventAge retry policy
+                max_event_age=Duration.hours(2),  # Optional: set the maxEventAge retry policy
                 retry_attempts=2
             ))
         '''
@@ -3861,16 +4010,15 @@ class LogGroupProps(TargetBaseProps):
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             import aws_cdk.aws_logs as logs
             # log_group: logs.LogGroup
             # rule: events.Rule
             
             
             rule.add_target(targets.CloudWatchLogGroup(log_group,
-                log_event=targets.LogGroupTargetInput(
-                    timestamp=events.EventField.from("$.time"),
-                    message=events.EventField.from("$.detail-type")
+                log_event=targets.LogGroupTargetInput.from_object(
+                    timestamp=events.EventField.from_path("$.time"),
+                    message=events.EventField.from_path("$.detail-type")
                 )
             ))
         '''
@@ -4006,7 +4154,7 @@ class SfnStateMachineProps(TargetBaseProps):
             
             
             rule = events.Rule(self, "Rule",
-                schedule=events.Schedule.rate(cdk.Duration.minutes(1))
+                schedule=events.Schedule.rate(Duration.minutes(1))
             )
             
             dlq = sqs.Queue(self, "DeadLetterQueue")
@@ -4015,7 +4163,7 @@ class SfnStateMachineProps(TargetBaseProps):
                 assumed_by=iam.ServicePrincipal("events.amazonaws.com")
             )
             state_machine = sfn.StateMachine(self, "SM",
-                definition=sfn.Wait(self, "Hello", time=sfn.WaitTime.duration(cdk.Duration.seconds(10)))
+                definition=sfn.Wait(self, "Hello", time=sfn.WaitTime.duration(Duration.seconds(10)))
             )
             
             rule.add_target(targets.SfnStateMachine(state_machine,
@@ -4398,6 +4546,7 @@ __all__ = [
     "SnsTopicProps",
     "SqsQueue",
     "SqsQueueProps",
+    "Tag",
     "TargetBaseProps",
     "TaskEnvironmentVariable",
 ]
@@ -4738,6 +4887,14 @@ def _typecheckingstub__d7bbb7c546d67f5f999da3b2a71dc36c03ae5d8723a592b50de5b0193
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__a813f48d70b31d8149568e4c733eee0b3ddf93c3d8ee22172032406da2f91b10(
+    *,
+    key: builtins.str,
+    value: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__5c149bf0de902d492c0a50daf03a233ef8286c2fb8799f305c9e4b91ffc8d577(
     *,
     dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
@@ -4829,9 +4986,11 @@ def _typecheckingstub__3624031da4f9372e2ccdb3e422123cc459d01922cc36bab5b96caa98f
     task_definition: _ITaskDefinition_889ba4d8,
     container_overrides: typing.Optional[typing.Sequence[typing.Union[ContainerOverride, typing.Dict[builtins.str, typing.Any]]]] = None,
     platform_version: typing.Optional[_FargatePlatformVersion_55d8be5c] = None,
+    propagate_tags: typing.Optional[_PropagatedTagSource_ad4e874a] = None,
     role: typing.Optional[_IRole_235f5d8e] = None,
     security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
     subnet_selection: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
+    tags: typing.Optional[typing.Sequence[typing.Union[Tag, typing.Dict[builtins.str, typing.Any]]]] = None,
     task_count: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""