aws-cdk-lib 2.172.0__py3-none-any.whl → 2.173.1__py3-none-any.whl

aws_cdk/aws_stepfunctions_tasks/__init__.py

@@ -1367,18 +1367,34 @@ tasks.GlueStartJobRun(self, "Task",
 )
 ```
 
-You can configure workers by setting the `workerType` and `numberOfWorkers` properties.
+You can configure workers by setting the `workerTypeV2` and `numberOfWorkers` properties.
+`workerType` is deprecated and no longer recommended. Use `workerTypeV2` which is
+a ENUM-like class for more powerful worker configuration around using pre-defined values or
+dynamic values.
 
 ```python
 tasks.GlueStartJobRun(self, "Task",
     glue_job_name="my-glue-job",
     worker_configuration=tasks.WorkerConfigurationProperty(
-        worker_type=tasks.WorkerType.G_1X,  # Worker type
+        worker_type_v2=tasks.WorkerTypeV2.G_1X,  # Worker type
         number_of_workers=2
     )
 )
 ```
 
+To configure the worker type or number of workers dynamically from StateMachine's input,
+you can configure it using JSON Path values using `workerTypeV2` like this:
+
+```python
+tasks.GlueStartJobRun(self, "Glue Job Task",
+    glue_job_name="my-glue-job",
+    worker_configuration=tasks.WorkerConfigurationProperty(
+        worker_type_v2=tasks.WorkerTypeV2.of(sfn.JsonPath.string_at("$.glue_jobs_configs.executor_type")),
+        number_of_workers=sfn.JsonPath.number_at("$.glue_jobs_configs.max_number_workers")
+    )
+)
+```
+
 You can choose the execution class by setting the `executionClass` property.
 
 ```python
@@ -25316,7 +25332,7 @@ class GlueStartJobRun(
         tasks.GlueStartJobRun(self, "Task",
             glue_job_name="my-glue-job",
             worker_configuration=tasks.WorkerConfigurationProperty(
-                worker_type=tasks.WorkerType.G_1X,  # Worker type
+                worker_type_v2=tasks.WorkerTypeV2.G_1X,  # Worker type
                 number_of_workers=2
             )
         )
@@ -25481,7 +25497,7 @@ class GlueStartJobRunProps(_TaskStateBaseProps_3a62b6d0):
             tasks.GlueStartJobRun(self, "Task",
                 glue_job_name="my-glue-job",
                 worker_configuration=tasks.WorkerConfigurationProperty(
-                    worker_type=tasks.WorkerType.G_1X,  # Worker type
+                    worker_type_v2=tasks.WorkerTypeV2.G_1X,  # Worker type
                     number_of_workers=2
                 )
             )
@@ -35469,19 +35485,25 @@ class VpcConfig:
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.WorkerConfigurationProperty",
     jsii_struct_bases=[],
-    name_mapping={"number_of_workers": "numberOfWorkers", "worker_type": "workerType"},
+    name_mapping={
+        "number_of_workers": "numberOfWorkers",
+        "worker_type": "workerType",
+        "worker_type_v2": "workerTypeV2",
+    },
 )
 class WorkerConfigurationProperty:
     def __init__(
         self,
         *,
         number_of_workers: jsii.Number,
-        worker_type: "WorkerType",
+        worker_type: typing.Optional["WorkerType"] = None,
+        worker_type_v2: typing.Optional["WorkerTypeV2"] = None,
     ) -> None:
         '''Properties for the worker configuration.
 
         :param number_of_workers: The number of workers of a defined ``WorkerType`` that are allocated when a job runs.
-        :param worker_type: The type of predefined worker that is allocated when a job runs.
+        :param worker_type: (deprecated) The type of predefined worker that is allocated when a job runs. Default: - must choose one of ``workerType`` or ``workerTypeV2``
+        :param worker_type_v2: The type of predefined worker that is allocated when a job runs. Can be one of the predefined values or dynamic values using ``WorkerTypeV2.of(...)``. Default: - must choose one of ``workerType`` or ``workerTypeV2``
 
         :exampleMetadata: infused
 
@@ -35490,7 +35512,7 @@ class WorkerConfigurationProperty:
             tasks.GlueStartJobRun(self, "Task",
                 glue_job_name="my-glue-job",
                 worker_configuration=tasks.WorkerConfigurationProperty(
-                    worker_type=tasks.WorkerType.G_1X,  # Worker type
+                    worker_type_v2=tasks.WorkerTypeV2.G_1X,  # Worker type
                     number_of_workers=2
                 )
             )
@@ -35499,10 +35521,14 @@ class WorkerConfigurationProperty:
             type_hints = typing.get_type_hints(_typecheckingstub__c763ebaff9b2187b4078dfe282a5c758a12f2af6fb159d07e51c1920e8b7c50f)
             check_type(argname="argument number_of_workers", value=number_of_workers, expected_type=type_hints["number_of_workers"])
             check_type(argname="argument worker_type", value=worker_type, expected_type=type_hints["worker_type"])
+            check_type(argname="argument worker_type_v2", value=worker_type_v2, expected_type=type_hints["worker_type_v2"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "number_of_workers": number_of_workers,
-            "worker_type": worker_type,
         }
+        if worker_type is not None:
+            self._values["worker_type"] = worker_type
+        if worker_type_v2 is not None:
+            self._values["worker_type_v2"] = worker_type_v2
 
     @builtins.property
     def number_of_workers(self) -> jsii.Number:
@@ -35512,11 +35538,29 @@ class WorkerConfigurationProperty:
         return typing.cast(jsii.Number, result)
 
     @builtins.property
-    def worker_type(self) -> "WorkerType":
-        '''The type of predefined worker that is allocated when a job runs.'''
+    def worker_type(self) -> typing.Optional["WorkerType"]:
+        '''(deprecated) The type of predefined worker that is allocated when a job runs.
+
+        :default: - must choose one of ``workerType`` or ``workerTypeV2``
+
+        :deprecated: Use ``workerTypeV2`` for more flexibility in defining worker types.
+
+        :stability: deprecated
+        '''
         result = self._values.get("worker_type")
-        assert result is not None, "Required property 'worker_type' is missing"
-        return typing.cast("WorkerType", result)
+        return typing.cast(typing.Optional["WorkerType"], result)
+
+    @builtins.property
+    def worker_type_v2(self) -> typing.Optional["WorkerTypeV2"]:
+        '''The type of predefined worker that is allocated when a job runs.
+
+        Can be one of the
+        predefined values or dynamic values using ``WorkerTypeV2.of(...)``.
+
+        :default: - must choose one of ``workerType`` or ``workerTypeV2``
+        '''
+        result = self._values.get("worker_type_v2")
+        return typing.cast(typing.Optional["WorkerTypeV2"], result)
 
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -35532,54 +35576,157 @@ class WorkerConfigurationProperty:
 
 @jsii.enum(jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.WorkerType")
 class WorkerType(enum.Enum):
-    '''The type of predefined worker that is allocated when a job runs.
-
-    If you need to use a WorkerType that doesn't exist as a static member, you
-    can instantiate a ``WorkerType`` object, e.g: ``WorkerType.of('other type')``.
-
-    :exampleMetadata: infused
+    '''(deprecated) The type of predefined worker that is allocated when a job runs.
 
-    Example::
+    :deprecated: Use ``workerTypeV2`` property for ``WorkerConfigurationProperty``
 
-        tasks.GlueStartJobRun(self, "Task",
-            glue_job_name="my-glue-job",
-            worker_configuration=tasks.WorkerConfigurationProperty(
-                worker_type=tasks.WorkerType.G_1X,  # Worker type
-                number_of_workers=2
-            )
-        )
+    :stability: deprecated
     '''
 
     STANDARD = "STANDARD"
-    '''Each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.'''
+    '''(deprecated) Each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.
+
+    :stability: deprecated
+    '''
     G_025X = "G_025X"
-    '''Each worker maps to 0.25 DPU (2 vCPU, 4 GB of memory, 64 GB disk), and provides 1 executor per worker. Suitable for low volume streaming jobs.'''
+    '''(deprecated) Each worker maps to 0.25 DPU (2 vCPU, 4 GB of memory, 64 GB disk), and provides 1 executor per worker. Suitable for low volume streaming jobs.
+
+    :stability: deprecated
+    '''
     G_1X = "G_1X"
-    '''Each worker maps to 1 DPU (4 vCPU, 16 GB of memory, 64 GB disk), and provides 1 executor per worker.
+    '''(deprecated) Each worker maps to 1 DPU (4 vCPU, 16 GB of memory, 64 GB disk), and provides 1 executor per worker.
 
     Suitable for memory-intensive jobs.
+
+    :stability: deprecated
     '''
     G_2X = "G_2X"
-    '''Each worker maps to 2 DPU (8 vCPU, 32 GB of memory, 128 GB disk), and provides 1 executor per worker.
+    '''(deprecated) Each worker maps to 2 DPU (8 vCPU, 32 GB of memory, 128 GB disk), and provides 1 executor per worker.
 
     Suitable for memory-intensive jobs.
+
+    :stability: deprecated
     '''
     G_4X = "G_4X"
-    '''Each worker maps to 4 DPU (16 vCPU, 64 GB of memory, 256 GB disk), and provides 1 executor per worker.
+    '''(deprecated) Each worker maps to 4 DPU (16 vCPU, 64 GB of memory, 256 GB disk), and provides 1 executor per worker.
 
     We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for AWS Glue version 3.0 or later jobs.
+
+    :stability: deprecated
     '''
     G_8X = "G_8X"
-    '''Each worker maps to 8 DPU (32 vCPU, 128 GB of memory, 512 GB disk), and provides 1 executor per worker.
+    '''(deprecated) Each worker maps to 8 DPU (32 vCPU, 128 GB of memory, 512 GB disk), and provides 1 executor per worker.
 
     We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for AWS Glue version 3.0 or later jobs.
+
+    :stability: deprecated
     '''
     Z_2X = "Z_2X"
-    '''Each worker maps to 2 high-memory DPU [M-DPU] (8 vCPU, 64 GB of memory, 128 GB disk).
+    '''(deprecated) Each worker maps to 2 high-memory DPU [M-DPU] (8 vCPU, 64 GB of memory, 128 GB disk).
 
     Supported in Ray jobs.
+
+    :stability: deprecated
+    '''
+
+
+class WorkerTypeV2(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.WorkerTypeV2",
+):
+    '''The type of predefined worker that is allocated when a job runs.
+
+    If you need to use a WorkerTypeV2 that doesn't exist as a static member, you
+    can instantiate a ``WorkerTypeV2`` object, e.g: ``WorkerTypeV2.of('other type')``.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        tasks.GlueStartJobRun(self, "Task",
+            glue_job_name="my-glue-job",
+            worker_configuration=tasks.WorkerConfigurationProperty(
+                worker_type_v2=tasks.WorkerTypeV2.G_1X,  # Worker type
+                number_of_workers=2
+            )
+        )
     '''
 
+    @jsii.member(jsii_name="of")
+    @builtins.classmethod
+    def of(cls, worker_type: builtins.str) -> "WorkerTypeV2":
+        '''Custom worker type.
+
+        :param worker_type: custom worker type.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__c157d3b8646990517aed57ee3a35b7f7c6278bddb8cec4b54a9428f91ca2e0de)
+            check_type(argname="argument worker_type", value=worker_type, expected_type=type_hints["worker_type"])
+        return typing.cast("WorkerTypeV2", jsii.sinvoke(cls, "of", [worker_type]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="G_025X")
+    def G_025_X(cls) -> "WorkerTypeV2":
+        '''Each worker maps to 0.25 DPU (2 vCPU, 4 GB of memory, 64 GB disk), and provides 1 executor per worker. Suitable for low volume streaming jobs.'''
+        return typing.cast("WorkerTypeV2", jsii.sget(cls, "G_025X"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="G_1X")
+    def G_1_X(cls) -> "WorkerTypeV2":
+        '''Each worker maps to 1 DPU (4 vCPU, 16 GB of memory, 64 GB disk), and provides 1 executor per worker.
+
+        Suitable for memory-intensive jobs.
+        '''
+        return typing.cast("WorkerTypeV2", jsii.sget(cls, "G_1X"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="G_2X")
+    def G_2_X(cls) -> "WorkerTypeV2":
+        '''Each worker maps to 2 DPU (8 vCPU, 32 GB of memory, 128 GB disk), and provides 1 executor per worker.
+
+        Suitable for memory-intensive jobs.
+        '''
+        return typing.cast("WorkerTypeV2", jsii.sget(cls, "G_2X"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="G_4X")
+    def G_4_X(cls) -> "WorkerTypeV2":
+        '''Each worker maps to 4 DPU (16 vCPU, 64 GB of memory, 256 GB disk), and provides 1 executor per worker.
+
+        We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for AWS Glue version 3.0 or later jobs.
+        '''
+        return typing.cast("WorkerTypeV2", jsii.sget(cls, "G_4X"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="G_8X")
+    def G_8_X(cls) -> "WorkerTypeV2":
+        '''Each worker maps to 8 DPU (32 vCPU, 128 GB of memory, 512 GB disk), and provides 1 executor per worker.
+
+        We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for AWS Glue version 3.0 or later jobs.
+        '''
+        return typing.cast("WorkerTypeV2", jsii.sget(cls, "G_8X"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="STANDARD")
+    def STANDARD(cls) -> "WorkerTypeV2":
+        '''Each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.'''
+        return typing.cast("WorkerTypeV2", jsii.sget(cls, "STANDARD"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="Z_2X")
+    def Z_2_X(cls) -> "WorkerTypeV2":
+        '''Each worker maps to 2 high-memory DPU [M-DPU] (8 vCPU, 64 GB of memory, 128 GB disk).
+
+        Supported in Ray jobs.
+        '''
+        return typing.cast("WorkerTypeV2", jsii.sget(cls, "Z_2X"))
+
+    @builtins.property
+    @jsii.member(jsii_name="name")
+    def name(self) -> builtins.str:
+        '''The name of this WorkerType, as expected by Job resource.'''
+        return typing.cast(builtins.str, jsii.get(self, "name"))
+
 
 @jsii.implements(IContainerDefinition)
 class ContainerDefinition(
@@ -35995,6 +36142,7 @@ __all__ = [
     "VpcConfig",
     "WorkerConfigurationProperty",
     "WorkerType",
+    "WorkerTypeV2",
 ]
 
 publication.publish()
@@ -39339,7 +39487,14 @@ def _typecheckingstub__1fbc90a211c2213a59cd0f58f282d9d8472f9b488d20c54956f06975b
 def _typecheckingstub__c763ebaff9b2187b4078dfe282a5c758a12f2af6fb159d07e51c1920e8b7c50f(
     *,
     number_of_workers: jsii.Number,
-    worker_type: WorkerType,
+    worker_type: typing.Optional[WorkerType] = None,
+    worker_type_v2: typing.Optional[WorkerTypeV2] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__c157d3b8646990517aed57ee3a35b7f7c6278bddb8cec4b54a9428f91ca2e0de(
+    worker_type: builtins.str,
 ) -> None:
     """Type checking stubs"""
     pass

aws_cdk/aws_synthetics/__init__.py

@@ -1358,7 +1358,7 @@ class CfnCanary(
         :param artifact_config: A structure that contains the configuration for canary artifacts, including the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.
         :param delete_lambda_resources_on_canary_deletion: (deprecated) Deletes associated lambda resources created by Synthetics if set to True. Default is False
         :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
-        :param provisioned_resource_cleanup: Setting to control if provisioned resources created by Synthetics are deleted alongside the canary. Default is AUTOMATIC.
+        :param provisioned_resource_cleanup: Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. If it is ``AUTOMATIC`` , the Lambda functions and layers will be deleted when the canary is deleted. If the value of this parameter is ``OFF`` , then the value of the ``DeleteLambda`` parameter of the `DeleteCanary <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DeleteCanary.html>`_ operation determines whether the Lambda functions and layers will be deleted.
         :param resources_to_replicate_tags: To have the tags that you apply to this canary also be applied to the Lambda function that the canary uses, specify this property with the value ``lambda-function`` . If you do this, CloudWatch Synthetics will keep the tags of the canary and the Lambda function synchronized. Any future changes you make to the canary's tags will also be applied to the function.
         :param run_config: A structure that contains input information for a canary run. If you omit this structure, the frequency of the canary is used as canary's timeout value, up to a maximum of 900 seconds.
         :param start_canary_after_creation: Specify TRUE to have the canary start making runs immediately after it is created. A canary that you create using CloudFormation can't be used to monitor the CloudFormation stack that creates the canary or to roll back that stack if there is a failure.
@@ -1606,7 +1606,7 @@ class CfnCanary(
     @builtins.property
     @jsii.member(jsii_name="provisionedResourceCleanup")
     def provisioned_resource_cleanup(self) -> typing.Optional[builtins.str]:
-        '''Setting to control if provisioned resources created by Synthetics are deleted alongside the canary.'''
+        '''Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "provisionedResourceCleanup"))
 
     @provisioned_resource_cleanup.setter
@@ -2556,7 +2556,7 @@ class CfnCanaryProps:
         :param artifact_config: A structure that contains the configuration for canary artifacts, including the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.
         :param delete_lambda_resources_on_canary_deletion: (deprecated) Deletes associated lambda resources created by Synthetics if set to True. Default is False
         :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
-        :param provisioned_resource_cleanup: Setting to control if provisioned resources created by Synthetics are deleted alongside the canary. Default is AUTOMATIC.
+        :param provisioned_resource_cleanup: Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. If it is ``AUTOMATIC`` , the Lambda functions and layers will be deleted when the canary is deleted. If the value of this parameter is ``OFF`` , then the value of the ``DeleteLambda`` parameter of the `DeleteCanary <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DeleteCanary.html>`_ operation determines whether the Lambda functions and layers will be deleted.
         :param resources_to_replicate_tags: To have the tags that you apply to this canary also be applied to the Lambda function that the canary uses, specify this property with the value ``lambda-function`` . If you do this, CloudWatch Synthetics will keep the tags of the canary and the Lambda function synchronized. Any future changes you make to the canary's tags will also be applied to the function.
         :param run_config: A structure that contains input information for a canary run. If you omit this structure, the frequency of the canary is used as canary's timeout value, up to a maximum of 900 seconds.
         :param start_canary_after_creation: Specify TRUE to have the canary start making runs immediately after it is created. A canary that you create using CloudFormation can't be used to monitor the CloudFormation stack that creates the canary or to roll back that stack if there is a failure.
@@ -2813,9 +2813,11 @@ class CfnCanaryProps:
 
     @builtins.property
     def provisioned_resource_cleanup(self) -> typing.Optional[builtins.str]:
-        '''Setting to control if provisioned resources created by Synthetics are deleted alongside the canary.
+        '''Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted.
 
-        Default is AUTOMATIC.
+        If it is ``AUTOMATIC`` , the Lambda functions and layers will be deleted when the canary is deleted.
+
+        If the value of this parameter is ``OFF`` , then the value of the ``DeleteLambda`` parameter of the `DeleteCanary <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DeleteCanary.html>`_ operation determines whether the Lambda functions and layers will be deleted.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-provisionedresourcecleanup
         '''