aws-cdk-lib 2.115.0__py3-none-any.whl → 2.116.1__py3-none-any.whl

aws_cdk/aws_ecs/__init__.py

@@ -618,6 +618,32 @@ service = ecs.ExternalService(self, "Service",
 `Services` by default will create a security group if not provided.
 If you'd like to specify which security groups to use you can override the `securityGroups` property.
 
+By default, the service will use the revision of the passed task definition generated when the `TaskDefinition`
+is deployed by CloudFormation. However, this may not be desired if the revision is externally managed,
+for example through CodeDeploy.
+
+To set a specific revision number or the special `latest` revision, use the `taskDefinitionRevision` parameter:
+
+```python
+# cluster: ecs.Cluster
+# task_definition: ecs.TaskDefinition
+
+
+ecs.ExternalService(self, "Service",
+    cluster=cluster,
+    task_definition=task_definition,
+    desired_count=5,
+    task_definition_revision=ecs.TaskDefinitionRevision.of(1)
+)
+
+ecs.ExternalService(self, "Service",
+    cluster=cluster,
+    task_definition=task_definition,
+    desired_count=5,
+    task_definition_revision=ecs.TaskDefinitionRevision.LATEST
+)
+```
+
 ### Deployment circuit breaker and rollback
 
 Amazon ECS [deployment circuit breaker](https://aws.amazon.com/tw/blogs/containers/announcing-amazon-ecs-deployment-circuit-breaker/)
@@ -1124,6 +1150,31 @@ task_definition.add_container("TheContainer",
 )
 ```
 
+When forwarding logs to CloudWatch Logs using Fluent Bit, you can set the retention period for the newly created Log Group by specifying the `log_retention_days` parameter.
+If a Fluent Bit container has not been added, CDK will automatically add it to the task definition, and the necessary IAM permissions will be added to the task role.
+If you are adding the Fluent Bit container manually, ensure to add the `logs:PutRetentionPolicy` policy to the task role.
+
+```python
+task_definition = ecs.Ec2TaskDefinition(self, "TaskDef")
+task_definition.add_container("TheContainer",
+    image=ecs.ContainerImage.from_registry("example-image"),
+    memory_limit_mi_b=256,
+    logging=ecs.LogDrivers.firelens(
+        options={
+            "Name": "cloudwatch",
+            "region": "us-west-2",
+            "log_group_name": "firelens-fluent-bit",
+            "log_stream_prefix": "from-fluent-bit",
+            "auto_create_group": "true",
+            "log_retention_days": "1"
+        }
+    )
+)
+```
+
+> Visit [Fluent Bit CloudWatch Configuration Parameters](https://docs.fluentbit.io/manual/pipeline/outputs/cloudwatch#configuration-parameters)
+> for more details.
+
 ### Generic Log Driver
 
 A generic log driver object exists to provide a lower level abstraction of the log driver configuration.
@@ -4158,6 +4209,7 @@ class BaseLogDriverProps:
         "propagate_tags": "propagateTags",
         "service_connect_configuration": "serviceConnectConfiguration",
         "service_name": "serviceName",
+        "task_definition_revision": "taskDefinitionRevision",
     },
 )
 class BaseServiceOptions:
@@ -4179,6 +4231,7 @@ class BaseServiceOptions:
         propagate_tags: typing.Optional["PropagatedTagSource"] = None,
         service_connect_configuration: typing.Optional[typing.Union["ServiceConnectProps", typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional["TaskDefinitionRevision"] = None,
     ) -> None:
         '''The properties for the base Ec2Service or FargateService service.
 
@@ -4197,6 +4250,7 @@ class BaseServiceOptions:
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
 
         :exampleMetadata: fixture=_generated
 
@@ -4212,6 +4266,7 @@ class BaseServiceOptions:
             # container_definition: ecs.ContainerDefinition
             # log_driver: ecs.LogDriver
             # namespace: servicediscovery.INamespace
+            # task_definition_revision: ecs.TaskDefinitionRevision
             
             base_service_options = ecs.BaseServiceOptions(
                 cluster=cluster,
@@ -4265,7 +4320,8 @@ class BaseServiceOptions:
                         port=123
                     )]
                 ),
-                service_name="serviceName"
+                service_name="serviceName",
+                task_definition_revision=task_definition_revision
             )
         '''
         if isinstance(circuit_breaker, dict):
@@ -4295,6 +4351,7 @@ class BaseServiceOptions:
             check_type(argname="argument propagate_tags", value=propagate_tags, expected_type=type_hints["propagate_tags"])
             check_type(argname="argument service_connect_configuration", value=service_connect_configuration, expected_type=type_hints["service_connect_configuration"])
             check_type(argname="argument service_name", value=service_name, expected_type=type_hints["service_name"])
+            check_type(argname="argument task_definition_revision", value=task_definition_revision, expected_type=type_hints["task_definition_revision"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "cluster": cluster,
         }
@@ -4326,6 +4383,8 @@ class BaseServiceOptions:
             self._values["service_connect_configuration"] = service_connect_configuration
         if service_name is not None:
             self._values["service_name"] = service_name
+        if task_definition_revision is not None:
+            self._values["task_definition_revision"] = task_definition_revision
 
     @builtins.property
     def cluster(self) -> "ICluster":
@@ -4479,6 +4538,15 @@ class BaseServiceOptions:
         result = self._values.get("service_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def task_definition_revision(self) -> typing.Optional["TaskDefinitionRevision"]:
+        '''Revision number for the task definition or ``latest`` to use the latest active task revision.
+
+        :default: - Uses the revision of the passed task definition deployed by CloudFormation
+        '''
+        result = self._values.get("task_definition_revision")
+        return typing.cast(typing.Optional["TaskDefinitionRevision"], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -4510,6 +4578,7 @@ class BaseServiceOptions:
         "propagate_tags": "propagateTags",
         "service_connect_configuration": "serviceConnectConfiguration",
         "service_name": "serviceName",
+        "task_definition_revision": "taskDefinitionRevision",
         "launch_type": "launchType",
     },
 )
@@ -4532,6 +4601,7 @@ class BaseServiceProps(BaseServiceOptions):
         propagate_tags: typing.Optional["PropagatedTagSource"] = None,
         service_connect_configuration: typing.Optional[typing.Union["ServiceConnectProps", typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional["TaskDefinitionRevision"] = None,
         launch_type: "LaunchType",
     ) -> None:
         '''Complete base service properties that are required to be supplied by the implementation of the BaseService class.
@@ -4551,6 +4621,7 @@ class BaseServiceProps(BaseServiceOptions):
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
         :param launch_type: The launch type on which to run your service. LaunchType will be omitted if capacity provider strategies are specified on the service.
 
         :exampleMetadata: fixture=_generated
@@ -4567,6 +4638,7 @@ class BaseServiceProps(BaseServiceOptions):
             # container_definition: ecs.ContainerDefinition
             # log_driver: ecs.LogDriver
             # namespace: servicediscovery.INamespace
+            # task_definition_revision: ecs.TaskDefinitionRevision
             
             base_service_props = ecs.BaseServiceProps(
                 cluster=cluster,
@@ -4621,7 +4693,8 @@ class BaseServiceProps(BaseServiceOptions):
                         port=123
                     )]
                 ),
-                service_name="serviceName"
+                service_name="serviceName",
+                task_definition_revision=task_definition_revision
             )
         '''
         if isinstance(circuit_breaker, dict):
@@ -4651,6 +4724,7 @@ class BaseServiceProps(BaseServiceOptions):
             check_type(argname="argument propagate_tags", value=propagate_tags, expected_type=type_hints["propagate_tags"])
             check_type(argname="argument service_connect_configuration", value=service_connect_configuration, expected_type=type_hints["service_connect_configuration"])
             check_type(argname="argument service_name", value=service_name, expected_type=type_hints["service_name"])
+            check_type(argname="argument task_definition_revision", value=task_definition_revision, expected_type=type_hints["task_definition_revision"])
             check_type(argname="argument launch_type", value=launch_type, expected_type=type_hints["launch_type"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "cluster": cluster,
@@ -4684,6 +4758,8 @@ class BaseServiceProps(BaseServiceOptions):
             self._values["service_connect_configuration"] = service_connect_configuration
         if service_name is not None:
             self._values["service_name"] = service_name
+        if task_definition_revision is not None:
+            self._values["task_definition_revision"] = task_definition_revision
 
     @builtins.property
     def cluster(self) -> "ICluster":
@@ -4837,6 +4913,15 @@ class BaseServiceProps(BaseServiceOptions):
         result = self._values.get("service_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def task_definition_revision(self) -> typing.Optional["TaskDefinitionRevision"]:
+        '''Revision number for the task definition or ``latest`` to use the latest active task revision.
+
+        :default: - Uses the revision of the passed task definition deployed by CloudFormation
+        '''
+        result = self._values.get("task_definition_revision")
+        return typing.cast(typing.Optional["TaskDefinitionRevision"], result)
+
     @builtins.property
     def launch_type(self) -> "LaunchType":
         '''The launch type on which to run your service.
@@ -20312,6 +20397,7 @@ class Ec2ServiceAttributes:
         "propagate_tags": "propagateTags",
         "service_connect_configuration": "serviceConnectConfiguration",
         "service_name": "serviceName",
+        "task_definition_revision": "taskDefinitionRevision",
         "task_definition": "taskDefinition",
         "assign_public_ip": "assignPublicIp",
         "daemon": "daemon",
@@ -20340,6 +20426,7 @@ class Ec2ServiceProps(BaseServiceOptions):
         propagate_tags: typing.Optional["PropagatedTagSource"] = None,
         service_connect_configuration: typing.Optional[typing.Union["ServiceConnectProps", typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional["TaskDefinitionRevision"] = None,
         task_definition: "TaskDefinition",
         assign_public_ip: typing.Optional[builtins.bool] = None,
         daemon: typing.Optional[builtins.bool] = None,
@@ -20365,6 +20452,7 @@ class Ec2ServiceProps(BaseServiceOptions):
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
         :param task_definition: The task definition to use for tasks in the service. [disable-awslint:ref-via-interface]
         :param assign_public_ip: Specifies whether the task's elastic network interface receives a public IP address. If true, each task will receive a public IP address. This property is only used for tasks that use the awsvpc network mode. Default: false
         :param daemon: Specifies whether the service will use the daemon scheduling strategy. If true, the service scheduler deploys exactly one task on each container instance in your cluster. When you are using this strategy, do not specify a desired number of tasks orany task placement strategies. Default: false
@@ -20419,6 +20507,7 @@ class Ec2ServiceProps(BaseServiceOptions):
             check_type(argname="argument propagate_tags", value=propagate_tags, expected_type=type_hints["propagate_tags"])
             check_type(argname="argument service_connect_configuration", value=service_connect_configuration, expected_type=type_hints["service_connect_configuration"])
             check_type(argname="argument service_name", value=service_name, expected_type=type_hints["service_name"])
+            check_type(argname="argument task_definition_revision", value=task_definition_revision, expected_type=type_hints["task_definition_revision"])
             check_type(argname="argument task_definition", value=task_definition, expected_type=type_hints["task_definition"])
             check_type(argname="argument assign_public_ip", value=assign_public_ip, expected_type=type_hints["assign_public_ip"])
             check_type(argname="argument daemon", value=daemon, expected_type=type_hints["daemon"])
@@ -20458,6 +20547,8 @@ class Ec2ServiceProps(BaseServiceOptions):
             self._values["service_connect_configuration"] = service_connect_configuration
         if service_name is not None:
             self._values["service_name"] = service_name
+        if task_definition_revision is not None:
+            self._values["task_definition_revision"] = task_definition_revision
         if assign_public_ip is not None:
             self._values["assign_public_ip"] = assign_public_ip
         if daemon is not None:
@@ -20623,6 +20714,15 @@ class Ec2ServiceProps(BaseServiceOptions):
         result = self._values.get("service_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def task_definition_revision(self) -> typing.Optional["TaskDefinitionRevision"]:
+        '''Revision number for the task definition or ``latest`` to use the latest active task revision.
+
+        :default: - Uses the revision of the passed task definition deployed by CloudFormation
+        '''
+        result = self._values.get("task_definition_revision")
+        return typing.cast(typing.Optional["TaskDefinitionRevision"], result)
+
     @builtins.property
     def task_definition(self) -> "TaskDefinition":
         '''The task definition to use for tasks in the service.
@@ -22201,6 +22301,7 @@ class ExternalServiceAttributes:
         "propagate_tags": "propagateTags",
         "service_connect_configuration": "serviceConnectConfiguration",
         "service_name": "serviceName",
+        "task_definition_revision": "taskDefinitionRevision",
         "task_definition": "taskDefinition",
         "security_groups": "securityGroups",
     },
@@ -22224,6 +22325,7 @@ class ExternalServiceProps(BaseServiceOptions):
         propagate_tags: typing.Optional["PropagatedTagSource"] = None,
         service_connect_configuration: typing.Optional[typing.Union["ServiceConnectProps", typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional["TaskDefinitionRevision"] = None,
         task_definition: "TaskDefinition",
         security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
     ) -> None:
@@ -22244,6 +22346,7 @@ class ExternalServiceProps(BaseServiceOptions):
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
         :param task_definition: The task definition to use for tasks in the service. [disable-awslint:ref-via-interface]
         :param security_groups: The security groups to associate with the service. If you do not specify a security group, a new security group is created. Default: - A new security group is created.
 
@@ -22288,6 +22391,7 @@ class ExternalServiceProps(BaseServiceOptions):
             check_type(argname="argument propagate_tags", value=propagate_tags, expected_type=type_hints["propagate_tags"])
             check_type(argname="argument service_connect_configuration", value=service_connect_configuration, expected_type=type_hints["service_connect_configuration"])
             check_type(argname="argument service_name", value=service_name, expected_type=type_hints["service_name"])
+            check_type(argname="argument task_definition_revision", value=task_definition_revision, expected_type=type_hints["task_definition_revision"])
             check_type(argname="argument task_definition", value=task_definition, expected_type=type_hints["task_definition"])
             check_type(argname="argument security_groups", value=security_groups, expected_type=type_hints["security_groups"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -22322,6 +22426,8 @@ class ExternalServiceProps(BaseServiceOptions):
             self._values["service_connect_configuration"] = service_connect_configuration
         if service_name is not None:
             self._values["service_name"] = service_name
+        if task_definition_revision is not None:
+            self._values["task_definition_revision"] = task_definition_revision
         if security_groups is not None:
             self._values["security_groups"] = security_groups
 
@@ -22477,6 +22583,15 @@ class ExternalServiceProps(BaseServiceOptions):
         result = self._values.get("service_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def task_definition_revision(self) -> typing.Optional["TaskDefinitionRevision"]:
+        '''Revision number for the task definition or ``latest`` to use the latest active task revision.
+
+        :default: - Uses the revision of the passed task definition deployed by CloudFormation
+        '''
+        result = self._values.get("task_definition_revision")
+        return typing.cast(typing.Optional["TaskDefinitionRevision"], result)
+
     @builtins.property
     def task_definition(self) -> "TaskDefinition":
         '''The task definition to use for tasks in the service.
@@ -22965,6 +23080,7 @@ class FargateServiceAttributes:
         "propagate_tags": "propagateTags",
         "service_connect_configuration": "serviceConnectConfiguration",
         "service_name": "serviceName",
+        "task_definition_revision": "taskDefinitionRevision",
         "task_definition": "taskDefinition",
         "assign_public_ip": "assignPublicIp",
         "platform_version": "platformVersion",
@@ -22991,6 +23107,7 @@ class FargateServiceProps(BaseServiceOptions):
         propagate_tags: typing.Optional["PropagatedTagSource"] = None,
         service_connect_configuration: typing.Optional[typing.Union["ServiceConnectProps", typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional["TaskDefinitionRevision"] = None,
         task_definition: "TaskDefinition",
         assign_public_ip: typing.Optional[builtins.bool] = None,
         platform_version: typing.Optional[FargatePlatformVersion] = None,
@@ -23014,6 +23131,7 @@ class FargateServiceProps(BaseServiceOptions):
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
         :param task_definition: The task definition to use for tasks in the service. [disable-awslint:ref-via-interface]
         :param assign_public_ip: Specifies whether the task's elastic network interface receives a public IP address. If true, each task will receive a public IP address. Default: false
         :param platform_version: The platform version on which to run your service. If one is not specified, the LATEST platform version is used by default. For more information, see `AWS Fargate Platform Versions <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html>`_ in the Amazon Elastic Container Service Developer Guide. Default: Latest
@@ -23081,6 +23199,7 @@ class FargateServiceProps(BaseServiceOptions):
             check_type(argname="argument propagate_tags", value=propagate_tags, expected_type=type_hints["propagate_tags"])
             check_type(argname="argument service_connect_configuration", value=service_connect_configuration, expected_type=type_hints["service_connect_configuration"])
             check_type(argname="argument service_name", value=service_name, expected_type=type_hints["service_name"])
+            check_type(argname="argument task_definition_revision", value=task_definition_revision, expected_type=type_hints["task_definition_revision"])
             check_type(argname="argument task_definition", value=task_definition, expected_type=type_hints["task_definition"])
             check_type(argname="argument assign_public_ip", value=assign_public_ip, expected_type=type_hints["assign_public_ip"])
             check_type(argname="argument platform_version", value=platform_version, expected_type=type_hints["platform_version"])
@@ -23118,6 +23237,8 @@ class FargateServiceProps(BaseServiceOptions):
             self._values["service_connect_configuration"] = service_connect_configuration
         if service_name is not None:
             self._values["service_name"] = service_name
+        if task_definition_revision is not None:
+            self._values["task_definition_revision"] = task_definition_revision
         if assign_public_ip is not None:
             self._values["assign_public_ip"] = assign_public_ip
         if platform_version is not None:
@@ -23279,6 +23400,15 @@ class FargateServiceProps(BaseServiceOptions):
         result = self._values.get("service_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def task_definition_revision(self) -> typing.Optional["TaskDefinitionRevision"]:
+        '''Revision number for the task definition or ``latest`` to use the latest active task revision.
+
+        :default: - Uses the revision of the passed task definition deployed by CloudFormation
+        '''
+        result = self._values.get("task_definition_revision")
+        return typing.cast(typing.Optional["TaskDefinitionRevision"], result)
+
     @builtins.property
     def task_definition(self) -> "TaskDefinition":
         '''The task definition to use for tasks in the service.
@@ -32957,6 +33087,60 @@ class TaskDefinitionProps(CommonTaskDefinitionProps):
         )
 
 
+class TaskDefinitionRevision(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_ecs.TaskDefinitionRevision",
+):
+    '''Represents revision of a task definition, either a specific numbered revision or the ``latest`` revision.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # cluster: ecs.Cluster
+        # task_definition: ecs.TaskDefinition
+        
+        
+        ecs.ExternalService(self, "Service",
+            cluster=cluster,
+            task_definition=task_definition,
+            desired_count=5,
+            task_definition_revision=ecs.TaskDefinitionRevision.of(1)
+        )
+        
+        ecs.ExternalService(self, "Service",
+            cluster=cluster,
+            task_definition=task_definition,
+            desired_count=5,
+            task_definition_revision=ecs.TaskDefinitionRevision.LATEST
+        )
+    '''
+
+    @jsii.member(jsii_name="of")
+    @builtins.classmethod
+    def of(cls, revision: jsii.Number) -> "TaskDefinitionRevision":
+        '''Specific revision of a task.
+
+        :param revision: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__7eb4392d369b1ada588a4a28382655efb27785bd3db7f861ca8ea5100f9d1c41)
+            check_type(argname="argument revision", value=revision, expected_type=type_hints["revision"])
+        return typing.cast("TaskDefinitionRevision", jsii.sinvoke(cls, "of", [revision]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="LATEST")
+    def LATEST(cls) -> "TaskDefinitionRevision":
+        '''The most recent revision of a task.'''
+        return typing.cast("TaskDefinitionRevision", jsii.sget(cls, "LATEST"))
+
+    @builtins.property
+    @jsii.member(jsii_name="revision")
+    def revision(self) -> builtins.str:
+        '''The string representation of this revision.'''
+        return typing.cast(builtins.str, jsii.get(self, "revision"))
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_ecs.Tmpfs",
     jsii_struct_bases=[],
@@ -35971,6 +36155,7 @@ class Ec2Service(
         propagate_tags: typing.Optional[PropagatedTagSource] = None,
         service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
     ) -> None:
         '''Constructs a new instance of the Ec2Service class.
 
@@ -35998,6 +36183,7 @@ class Ec2Service(
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__1e578461670bd6cdf856f914534e1feff8905e31d33cd7aea2b9f51512de5cea)
@@ -36026,6 +36212,7 @@ class Ec2Service(
             propagate_tags=propagate_tags,
             service_connect_configuration=service_connect_configuration,
             service_name=service_name,
+            task_definition_revision=task_definition_revision,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -36289,6 +36476,7 @@ class ExternalService(
         propagate_tags: typing.Optional[PropagatedTagSource] = None,
         service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
     ) -> None:
         '''Constructs a new instance of the ExternalService class.
 
@@ -36311,6 +36499,7 @@ class ExternalService(
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__6ceef4de126cbb6bd6f379ba0b53be2fb61c35761f50685b5d228c682b979cc7)
@@ -36334,6 +36523,7 @@ class ExternalService(
             propagate_tags=propagate_tags,
             service_connect_configuration=service_connect_configuration,
             service_name=service_name,
+            task_definition_revision=task_definition_revision,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -36732,6 +36922,7 @@ class FargateService(
         propagate_tags: typing.Optional[PropagatedTagSource] = None,
         service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
         service_name: typing.Optional[builtins.str] = None,
+        task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
     ) -> None:
         '''Constructs a new instance of the FargateService class.
 
@@ -36757,6 +36948,7 @@ class FargateService(
         :param propagate_tags: Specifies whether to propagate the tags from the task definition or the service to the tasks in the service. Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or PropagatedTagSource.NONE Default: PropagatedTagSource.NONE
         :param service_connect_configuration: Configuration for Service Connect. Default: No ports are advertised via Service Connect on this service, and the service cannot make requests to other services via Service Connect.
         :param service_name: The name of the service. Default: - CloudFormation-generated name.
+        :param task_definition_revision: Revision number for the task definition or ``latest`` to use the latest active task revision. Default: - Uses the revision of the passed task definition deployed by CloudFormation
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__0ddac6b19472d00f74c1777e699ce5b239dc49e62ff4ab4674c917bbed10c538)
@@ -36783,6 +36975,7 @@ class FargateService(
             propagate_tags=propagate_tags,
             service_connect_configuration=service_connect_configuration,
             service_name=service_name,
+            task_definition_revision=task_definition_revision,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -37178,6 +37371,7 @@ __all__ = [
     "TaskDefinition",
     "TaskDefinitionAttributes",
     "TaskDefinitionProps",
+    "TaskDefinitionRevision",
     "Tmpfs",
     "TmpfsMountOption",
     "TrackCustomMetricProps",
@@ -37398,6 +37592,7 @@ def _typecheckingstub__c2e0ba28c74987301a54b0d197b791a6a94084b5f40d15304ffabf113
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -37419,6 +37614,7 @@ def _typecheckingstub__3ecfd95265b873c2042a9d5cb8465a48f9e325e2271c18461e2b26633
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
     launch_type: LaunchType,
 ) -> None:
     """Type checking stubs"""
@@ -39151,6 +39347,7 @@ def _typecheckingstub__95634258086aa3448fbdfd9896017a2cbeb858f382deb61186bb9e22b
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
     task_definition: TaskDefinition,
     assign_public_ip: typing.Optional[builtins.bool] = None,
     daemon: typing.Optional[builtins.bool] = None,
@@ -39344,6 +39541,7 @@ def _typecheckingstub__3cc413964caae89bfcfbcabff8356ffe5c054f46824be99731a77b64e
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
     task_definition: TaskDefinition,
     security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
 ) -> None:
@@ -39398,6 +39596,7 @@ def _typecheckingstub__8290283f61f3e2d289b7e7f81cad1a5d1e9ed9dbc07ccce2b57604682
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
     task_definition: TaskDefinition,
     assign_public_ip: typing.Optional[builtins.bool] = None,
     platform_version: typing.Optional[FargatePlatformVersion] = None,
@@ -40392,6 +40591,12 @@ def _typecheckingstub__94a3565a38b8645ada9c86c3d7ac059ba028553c5ec103fcd16884f75
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__7eb4392d369b1ada588a4a28382655efb27785bd3db7f861ca8ea5100f9d1c41(
+    revision: jsii.Number,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__e9f01a54937cae960dd3b2636cb2a5869c5064352cf4035ff1a0a0dfb4fa3b8a(
     *,
     container_path: builtins.str,
@@ -40805,6 +41010,7 @@ def _typecheckingstub__1e578461670bd6cdf856f914534e1feff8905e31d33cd7aea2b9f5151
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -40899,6 +41105,7 @@ def _typecheckingstub__6ceef4de126cbb6bd6f379ba0b53be2fb61c35761f50685b5d228c682
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -41001,6 +41208,7 @@ def _typecheckingstub__0ddac6b19472d00f74c1777e699ce5b239dc49e62ff4ab4674c917bbe
     propagate_tags: typing.Optional[PropagatedTagSource] = None,
     service_connect_configuration: typing.Optional[typing.Union[ServiceConnectProps, typing.Dict[builtins.str, typing.Any]]] = None,
     service_name: typing.Optional[builtins.str] = None,
+    task_definition_revision: typing.Optional[TaskDefinitionRevision] = None,
 ) -> None:
     """Type checking stubs"""
     pass