aws-cdk-lib 2.145.0__py3-none-any.whl → 2.147.0__py3-none-any.whl

aws_cdk/aws_ecs/__init__.py

@@ -6422,6 +6422,10 @@ class CfnCluster(
                         s3_key_prefix="s3KeyPrefix"
                     ),
                     logging="logging"
+                ),
+                managed_storage_configuration=ecs.CfnCluster.ManagedStorageConfigurationProperty(
+                    fargate_ephemeral_storage_kms_key_id="fargateEphemeralStorageKmsKeyId",
+                    kms_key_id="kmsKeyId"
                 )
             ),
             default_capacity_provider_strategy=[ecs.CfnCluster.CapacityProviderStrategyItemProperty(
@@ -6458,7 +6462,7 @@ class CfnCluster(
         :param capacity_providers: The short name of one or more capacity providers to associate with the cluster. A capacity provider must be associated with a cluster before it can be included as part of the default capacity provider strategy of the cluster or used in a capacity provider strategy when calling the `CreateService <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html>`_ or `RunTask <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html>`_ actions. If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must be created but not associated with another cluster. New Auto Scaling group capacity providers can be created with the `CreateCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html>`_ API operation. To use a AWS Fargate capacity provider, specify either the ``FARGATE`` or ``FARGATE_SPOT`` capacity providers. The AWS Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used. The `PutCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProvider.html>`_ API operation is used to update the list of available capacity providers for a cluster after the cluster is created.
         :param cluster_name: A user-generated string that you use to identify your cluster. If you don't specify a name, AWS CloudFormation generates a unique physical ID for the name.
         :param cluster_settings: The settings to use when creating a cluster. This parameter is used to turn on CloudWatch Container Insights for a cluster.
-        :param configuration: The execute command configuration for the cluster.
+        :param configuration: The execute command and managed storage configuration for the cluster.
         :param default_capacity_provider_strategy: The default capacity provider strategy for the cluster. When services or tasks are run in the cluster with no launch type or capacity provider strategy specified, the default capacity provider strategy is used.
         :param service_connect_defaults: Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the ``enabled`` parameter to ``true`` in the ``ServiceConnectConfiguration`` . You can set the namespace of each service individually in the ``ServiceConnectConfiguration`` to override this default parameter. Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see `Service Connect <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
         :param tags: The metadata that you apply to the cluster to help you categorize and organize them. Each tag consists of a key and an optional value. You define both. The following basic restrictions apply to tags: - Maximum number of tags per resource - 50 - For each resource, each tag key must be unique, and each tag key can have only one value. - Maximum key length - 128 Unicode characters in UTF-8 - Maximum value length - 256 Unicode characters in UTF-8 - If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : /
@@ -6581,7 +6585,7 @@ class CfnCluster(
     def configuration(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ClusterConfigurationProperty"]]:
-        '''The execute command configuration for the cluster.'''
+        '''The execute command and managed storage configuration for the cluster.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ClusterConfigurationProperty"]], jsii.get(self, "configuration"))
 
     @configuration.setter
@@ -6745,17 +6749,22 @@ class CfnCluster(
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_ecs.CfnCluster.ClusterConfigurationProperty",
         jsii_struct_bases=[],
-        name_mapping={"execute_command_configuration": "executeCommandConfiguration"},
+        name_mapping={
+            "execute_command_configuration": "executeCommandConfiguration",
+            "managed_storage_configuration": "managedStorageConfiguration",
+        },
     )
     class ClusterConfigurationProperty:
         def __init__(
             self,
             *,
             execute_command_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.ExecuteCommandConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+            managed_storage_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.ManagedStorageConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''The execute command configuration for the cluster.
+            '''The execute command and managed storage configuration for the cluster.
 
             :param execute_command_configuration: The details of the execute command configuration.
+            :param managed_storage_configuration: The details of the managed storage configuration.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-clusterconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -6777,15 +6786,22 @@ class CfnCluster(
                             s3_key_prefix="s3KeyPrefix"
                         ),
                         logging="logging"
+                    ),
+                    managed_storage_configuration=ecs.CfnCluster.ManagedStorageConfigurationProperty(
+                        fargate_ephemeral_storage_kms_key_id="fargateEphemeralStorageKmsKeyId",
+                        kms_key_id="kmsKeyId"
                     )
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__d329e717aee636e9b40a663cb42030119882fdc5e5e743ac1d055ce0cbbadb3c)
                 check_type(argname="argument execute_command_configuration", value=execute_command_configuration, expected_type=type_hints["execute_command_configuration"])
+                check_type(argname="argument managed_storage_configuration", value=managed_storage_configuration, expected_type=type_hints["managed_storage_configuration"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
             if execute_command_configuration is not None:
                 self._values["execute_command_configuration"] = execute_command_configuration
+            if managed_storage_configuration is not None:
+                self._values["managed_storage_configuration"] = managed_storage_configuration
 
         @builtins.property
         def execute_command_configuration(
@@ -6798,6 +6814,17 @@ class CfnCluster(
             result = self._values.get("execute_command_configuration")
             return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ExecuteCommandConfigurationProperty"]], result)
 
+        @builtins.property
+        def managed_storage_configuration(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ManagedStorageConfigurationProperty"]]:
+            '''The details of the managed storage configuration.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-clusterconfiguration.html#cfn-ecs-cluster-clusterconfiguration-managedstorageconfiguration
+            '''
+            result = self._values.get("managed_storage_configuration")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ManagedStorageConfigurationProperty"]], result)
+
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -7127,6 +7154,79 @@ class CfnCluster(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_ecs.CfnCluster.ManagedStorageConfigurationProperty",
+        jsii_struct_bases=[],
+        name_mapping={
+            "fargate_ephemeral_storage_kms_key_id": "fargateEphemeralStorageKmsKeyId",
+            "kms_key_id": "kmsKeyId",
+        },
+    )
+    class ManagedStorageConfigurationProperty:
+        def __init__(
+            self,
+            *,
+            fargate_ephemeral_storage_kms_key_id: typing.Optional[builtins.str] = None,
+            kms_key_id: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''The managed storage configuration for the cluster.
+
+            :param fargate_ephemeral_storage_kms_key_id: Specify the AWS Key Management Service key ID for the Fargate ephemeral storage.
+            :param kms_key_id: Specify a AWS Key Management Service key ID to encrypt the managed storage.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-managedstorageconfiguration.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_ecs as ecs
+                
+                managed_storage_configuration_property = ecs.CfnCluster.ManagedStorageConfigurationProperty(
+                    fargate_ephemeral_storage_kms_key_id="fargateEphemeralStorageKmsKeyId",
+                    kms_key_id="kmsKeyId"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__ef7d3c502531d23e5b8dc81508f368488fbd4f169753407ac2ce4d3a7e39be73)
+                check_type(argname="argument fargate_ephemeral_storage_kms_key_id", value=fargate_ephemeral_storage_kms_key_id, expected_type=type_hints["fargate_ephemeral_storage_kms_key_id"])
+                check_type(argname="argument kms_key_id", value=kms_key_id, expected_type=type_hints["kms_key_id"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if fargate_ephemeral_storage_kms_key_id is not None:
+                self._values["fargate_ephemeral_storage_kms_key_id"] = fargate_ephemeral_storage_kms_key_id
+            if kms_key_id is not None:
+                self._values["kms_key_id"] = kms_key_id
+
+        @builtins.property
+        def fargate_ephemeral_storage_kms_key_id(self) -> typing.Optional[builtins.str]:
+            '''Specify the AWS Key Management Service key ID for the Fargate ephemeral storage.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-managedstorageconfiguration.html#cfn-ecs-cluster-managedstorageconfiguration-fargateephemeralstoragekmskeyid
+            '''
+            result = self._values.get("fargate_ephemeral_storage_kms_key_id")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def kms_key_id(self) -> typing.Optional[builtins.str]:
+            '''Specify a AWS Key Management Service key ID to encrypt the managed storage.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-managedstorageconfiguration.html#cfn-ecs-cluster-managedstorageconfiguration-kmskeyid
+            '''
+            result = self._values.get("kms_key_id")
+            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 "ManagedStorageConfigurationProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_ecs.CfnCluster.ServiceConnectDefaultsProperty",
         jsii_struct_bases=[],
@@ -7563,7 +7663,7 @@ class CfnClusterProps:
         :param capacity_providers: The short name of one or more capacity providers to associate with the cluster. A capacity provider must be associated with a cluster before it can be included as part of the default capacity provider strategy of the cluster or used in a capacity provider strategy when calling the `CreateService <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html>`_ or `RunTask <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html>`_ actions. If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must be created but not associated with another cluster. New Auto Scaling group capacity providers can be created with the `CreateCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html>`_ API operation. To use a AWS Fargate capacity provider, specify either the ``FARGATE`` or ``FARGATE_SPOT`` capacity providers. The AWS Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used. The `PutCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProvider.html>`_ API operation is used to update the list of available capacity providers for a cluster after the cluster is created.
         :param cluster_name: A user-generated string that you use to identify your cluster. If you don't specify a name, AWS CloudFormation generates a unique physical ID for the name.
         :param cluster_settings: The settings to use when creating a cluster. This parameter is used to turn on CloudWatch Container Insights for a cluster.
-        :param configuration: The execute command configuration for the cluster.
+        :param configuration: The execute command and managed storage configuration for the cluster.
         :param default_capacity_provider_strategy: The default capacity provider strategy for the cluster. When services or tasks are run in the cluster with no launch type or capacity provider strategy specified, the default capacity provider strategy is used.
         :param service_connect_defaults: Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the ``enabled`` parameter to ``true`` in the ``ServiceConnectConfiguration`` . You can set the namespace of each service individually in the ``ServiceConnectConfiguration`` to override this default parameter. Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see `Service Connect <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
         :param tags: The metadata that you apply to the cluster to help you categorize and organize them. Each tag consists of a key and an optional value. You define both. The following basic restrictions apply to tags: - Maximum number of tags per resource - 50 - For each resource, each tag key must be unique, and each tag key can have only one value. - Maximum key length - 128 Unicode characters in UTF-8 - Maximum value length - 256 Unicode characters in UTF-8 - If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : /
@@ -7595,6 +7695,10 @@ class CfnClusterProps:
                             s3_key_prefix="s3KeyPrefix"
                         ),
                         logging="logging"
+                    ),
+                    managed_storage_configuration=ecs.CfnCluster.ManagedStorageConfigurationProperty(
+                        fargate_ephemeral_storage_kms_key_id="fargateEphemeralStorageKmsKeyId",
+                        kms_key_id="kmsKeyId"
                     )
                 ),
                 default_capacity_provider_strategy=[ecs.CfnCluster.CapacityProviderStrategyItemProperty(
@@ -7681,7 +7785,7 @@ class CfnClusterProps:
     def configuration(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.ClusterConfigurationProperty]]:
-        '''The execute command configuration for the cluster.
+        '''The execute command and managed storage configuration for the cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-cluster.html#cfn-ecs-cluster-configuration
         '''
@@ -15653,8 +15757,8 @@ class CfnTaskDefinition(
 
             The supported resource types are GPUs and Elastic Inference accelerators. For more information, see `Working with GPUs on Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-gpu.html>`_ or `Working with Amazon Elastic Inference on Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html>`_ in the *Amazon Elastic Container Service Developer Guide*
 
-            :param type: The type of resource to assign to a container. The supported values are ``GPU`` or ``InferenceAccelerator`` .
-            :param value: The value for the specified resource type. If the ``GPU`` type is used, the value is the number of physical ``GPUs`` the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on. If the ``InferenceAccelerator`` type is used, the ``value`` matches the ``deviceName`` for an `InferenceAccelerator <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html>`_ specified in a task definition.
+            :param type: The type of resource to assign to a container.
+            :param value: The value for the specified resource type. When the type is ``GPU`` , the value is the number of physical ``GPUs`` the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on. When the type is ``InferenceAccelerator`` , the ``value`` matches the ``deviceName`` for an `InferenceAccelerator <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html>`_ specified in a task definition.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-resourcerequirement.html
             :exampleMetadata: fixture=_generated
@@ -15683,8 +15787,6 @@ class CfnTaskDefinition(
         def type(self) -> builtins.str:
             '''The type of resource to assign to a container.
 
-            The supported values are ``GPU`` or ``InferenceAccelerator`` .
-
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-resourcerequirement.html#cfn-ecs-taskdefinition-resourcerequirement-type
             '''
             result = self._values.get("type")
@@ -15695,9 +15797,9 @@ class CfnTaskDefinition(
         def value(self) -> builtins.str:
             '''The value for the specified resource type.
 
-            If the ``GPU`` type is used, the value is the number of physical ``GPUs`` the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on.
+            When the type is ``GPU`` , the value is the number of physical ``GPUs`` the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on.
 
-            If the ``InferenceAccelerator`` type is used, the ``value`` matches the ``deviceName`` for an `InferenceAccelerator <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html>`_ specified in a task definition.
+            When the type is ``InferenceAccelerator`` , the ``value`` matches the ``deviceName`` for an `InferenceAccelerator <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html>`_ specified in a task definition.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-resourcerequirement.html#cfn-ecs-taskdefinition-resourcerequirement-value
             '''
@@ -41288,6 +41390,7 @@ def _typecheckingstub__c0111db321c8b52d6283d3435e19f561034b11c2a7a4a80e235d2ee03
 def _typecheckingstub__d329e717aee636e9b40a663cb42030119882fdc5e5e743ac1d055ce0cbbadb3c(
     *,
     execute_command_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCluster.ExecuteCommandConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    managed_storage_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCluster.ManagedStorageConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -41320,6 +41423,14 @@ def _typecheckingstub__c05052099f204719b48aff84daacc7380c4e383137e6a2a3c00551dee
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__ef7d3c502531d23e5b8dc81508f368488fbd4f169753407ac2ce4d3a7e39be73(
+    *,
+    fargate_ephemeral_storage_kms_key_id: typing.Optional[builtins.str] = None,
+    kms_key_id: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__406d33f45440b3838cc9c39ff62fb2d038305a2814d49c398a3ffa7e3abbd9cd(
     *,
     namespace: typing.Optional[builtins.str] = None,