aws-cdk-lib 2.165.0__py3-none-any.whl → 2.167.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

Files changed (60) hide show
  1. aws_cdk/__init__.py +1 -1
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.165.0.jsii.tgz → aws-cdk-lib@2.167.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_apigateway/__init__.py +9 -0
  5. aws_cdk/aws_appsync/__init__.py +2271 -359
  6. aws_cdk/aws_backup/__init__.py +57 -31
  7. aws_cdk/aws_bedrock/__init__.py +994 -197
  8. aws_cdk/aws_cleanrooms/__init__.py +66 -5
  9. aws_cdk/aws_cloudfront/__init__.py +21 -3
  10. aws_cdk/aws_cloudfront/experimental/__init__.py +3 -3
  11. aws_cdk/aws_codebuild/__init__.py +59 -29
  12. aws_cdk/aws_codepipeline/__init__.py +98 -5
  13. aws_cdk/aws_codestar/__init__.py +1 -1
  14. aws_cdk/aws_cognito/__init__.py +0 -8
  15. aws_cdk/aws_connect/__init__.py +1 -1
  16. aws_cdk/aws_datasync/__init__.py +60 -7
  17. aws_cdk/aws_devopsguru/__init__.py +2 -2
  18. aws_cdk/aws_dms/__init__.py +762 -0
  19. aws_cdk/aws_dynamodb/__init__.py +13 -8
  20. aws_cdk/aws_ec2/__init__.py +316 -11
  21. aws_cdk/aws_ecs/__init__.py +20 -7
  22. aws_cdk/aws_elasticache/__init__.py +16 -9
  23. aws_cdk/aws_elasticloadbalancingv2/__init__.py +73 -46
  24. aws_cdk/aws_emrserverless/__init__.py +35 -33
  25. aws_cdk/aws_events/__init__.py +25 -30
  26. aws_cdk/aws_gamelift/__init__.py +52 -40
  27. aws_cdk/aws_inspectorv2/__init__.py +6 -12
  28. aws_cdk/aws_kinesis/__init__.py +297 -1
  29. aws_cdk/aws_kms/__init__.py +2 -0
  30. aws_cdk/aws_lambda/__init__.py +339 -22
  31. aws_cdk/aws_lambda_nodejs/__init__.py +3 -3
  32. aws_cdk/aws_logs/__init__.py +214 -0
  33. aws_cdk/aws_m2/__init__.py +58 -58
  34. aws_cdk/aws_mediapackagev2/__init__.py +191 -0
  35. aws_cdk/aws_networkfirewall/__init__.py +14 -5
  36. aws_cdk/aws_nimblestudio/__init__.py +6 -103
  37. aws_cdk/aws_opensearchservice/__init__.py +969 -0
  38. aws_cdk/aws_pipes/__init__.py +1 -1
  39. aws_cdk/aws_qbusiness/__init__.py +2 -0
  40. aws_cdk/aws_quicksight/__init__.py +481 -10
  41. aws_cdk/aws_rds/__init__.py +667 -16
  42. aws_cdk/aws_route53/__init__.py +38 -12
  43. aws_cdk/aws_s3_assets/__init__.py +37 -0
  44. aws_cdk/aws_s3_deployment/__init__.py +18 -7
  45. aws_cdk/aws_sagemaker/__init__.py +61 -25
  46. aws_cdk/aws_secretsmanager/__init__.py +2 -1
  47. aws_cdk/aws_servicecatalog/__init__.py +52 -4
  48. aws_cdk/aws_ses/__init__.py +22 -1
  49. aws_cdk/aws_sqs/__init__.py +12 -9
  50. aws_cdk/aws_stepfunctions/__init__.py +8 -0
  51. aws_cdk/aws_synthetics/__init__.py +133 -1
  52. aws_cdk/aws_timestream/__init__.py +41 -0
  53. aws_cdk/aws_wisdom/__init__.py +2348 -54
  54. aws_cdk/triggers/__init__.py +3 -3
  55. {aws_cdk_lib-2.165.0.dist-info → aws_cdk_lib-2.167.0.dist-info}/METADATA +1 -1
  56. {aws_cdk_lib-2.165.0.dist-info → aws_cdk_lib-2.167.0.dist-info}/RECORD +60 -60
  57. {aws_cdk_lib-2.165.0.dist-info → aws_cdk_lib-2.167.0.dist-info}/WHEEL +1 -1
  58. {aws_cdk_lib-2.165.0.dist-info → aws_cdk_lib-2.167.0.dist-info}/LICENSE +0 -0
  59. {aws_cdk_lib-2.165.0.dist-info → aws_cdk_lib-2.167.0.dist-info}/NOTICE +0 -0
  60. {aws_cdk_lib-2.165.0.dist-info → aws_cdk_lib-2.167.0.dist-info}/top_level.txt +0 -0
@@ -2538,7 +2538,10 @@ class CfnPipeline(
2538
2538
  )
2539
2539
  )]
2540
2540
  )],
2541
- result="result"
2541
+ result="result",
2542
+ retry_configuration=codepipeline.CfnPipeline.RetryConfigurationProperty(
2543
+ retry_mode="retryMode"
2544
+ )
2542
2545
  ),
2543
2546
  on_success=codepipeline.CfnPipeline.SuccessConditionsProperty(
2544
2547
  conditions=[codepipeline.CfnPipeline.ConditionProperty(
@@ -3852,7 +3855,11 @@ class CfnPipeline(
3852
3855
  @jsii.data_type(
3853
3856
  jsii_type="aws-cdk-lib.aws_codepipeline.CfnPipeline.FailureConditionsProperty",
3854
3857
  jsii_struct_bases=[],
3855
- name_mapping={"conditions": "conditions", "result": "result"},
3858
+ name_mapping={
3859
+ "conditions": "conditions",
3860
+ "result": "result",
3861
+ "retry_configuration": "retryConfiguration",
3862
+ },
3856
3863
  )
3857
3864
  class FailureConditionsProperty:
3858
3865
  def __init__(
@@ -3860,11 +3867,13 @@ class CfnPipeline(
3860
3867
  *,
3861
3868
  conditions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnPipeline.ConditionProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
3862
3869
  result: typing.Optional[builtins.str] = None,
3870
+ retry_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnPipeline.RetryConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
3863
3871
  ) -> None:
3864
3872
  '''The configuration that specifies the result, such as rollback, to occur upon stage failure.
3865
3873
 
3866
3874
  :param conditions: The conditions that are configured as failure conditions.
3867
3875
  :param result: The specified result for when the failure conditions are met, such as rolling back the stage.
3876
+ :param retry_configuration: The retry configuration specifies automatic retry for a failed stage, along with the configured retry mode.
3868
3877
 
3869
3878
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-failureconditions.html
3870
3879
  :exampleMetadata: fixture=_generated
@@ -3896,18 +3905,24 @@ class CfnPipeline(
3896
3905
  )
3897
3906
  )]
3898
3907
  )],
3899
- result="result"
3908
+ result="result",
3909
+ retry_configuration=codepipeline.CfnPipeline.RetryConfigurationProperty(
3910
+ retry_mode="retryMode"
3911
+ )
3900
3912
  )
3901
3913
  '''
3902
3914
  if __debug__:
3903
3915
  type_hints = typing.get_type_hints(_typecheckingstub__24827e49ed35c3622e48ed5d5a7874646b28153667949aaac3a40638392631b8)
3904
3916
  check_type(argname="argument conditions", value=conditions, expected_type=type_hints["conditions"])
3905
3917
  check_type(argname="argument result", value=result, expected_type=type_hints["result"])
3918
+ check_type(argname="argument retry_configuration", value=retry_configuration, expected_type=type_hints["retry_configuration"])
3906
3919
  self._values: typing.Dict[builtins.str, typing.Any] = {}
3907
3920
  if conditions is not None:
3908
3921
  self._values["conditions"] = conditions
3909
3922
  if result is not None:
3910
3923
  self._values["result"] = result
3924
+ if retry_configuration is not None:
3925
+ self._values["retry_configuration"] = retry_configuration
3911
3926
 
3912
3927
  @builtins.property
3913
3928
  def conditions(
@@ -3929,6 +3944,17 @@ class CfnPipeline(
3929
3944
  result = self._values.get("result")
3930
3945
  return typing.cast(typing.Optional[builtins.str], result)
3931
3946
 
3947
+ @builtins.property
3948
+ def retry_configuration(
3949
+ self,
3950
+ ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPipeline.RetryConfigurationProperty"]]:
3951
+ '''The retry configuration specifies automatic retry for a failed stage, along with the configured retry mode.
3952
+
3953
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-failureconditions.html#cfn-codepipeline-pipeline-failureconditions-retryconfiguration
3954
+ '''
3955
+ result = self._values.get("retry_configuration")
3956
+ return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPipeline.RetryConfigurationProperty"]], result)
3957
+
3932
3958
  def __eq__(self, rhs: typing.Any) -> builtins.bool:
3933
3959
  return isinstance(rhs, self.__class__) and rhs._values == self._values
3934
3960
 
@@ -4725,6 +4751,59 @@ class CfnPipeline(
4725
4751
  k + "=" + repr(v) for k, v in self._values.items()
4726
4752
  )
4727
4753
 
4754
+ @jsii.data_type(
4755
+ jsii_type="aws-cdk-lib.aws_codepipeline.CfnPipeline.RetryConfigurationProperty",
4756
+ jsii_struct_bases=[],
4757
+ name_mapping={"retry_mode": "retryMode"},
4758
+ )
4759
+ class RetryConfigurationProperty:
4760
+ def __init__(self, *, retry_mode: typing.Optional[builtins.str] = None) -> None:
4761
+ '''The retry configuration specifies automatic retry for a failed stage, along with the configured retry mode.
4762
+
4763
+ :param retry_mode: The method that you want to configure for automatic stage retry on stage failure. You can specify to retry only failed action in the stage or all actions in the stage.
4764
+
4765
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-retryconfiguration.html
4766
+ :exampleMetadata: fixture=_generated
4767
+
4768
+ Example::
4769
+
4770
+ # The code below shows an example of how to instantiate this type.
4771
+ # The values are placeholders you should change.
4772
+ from aws_cdk import aws_codepipeline as codepipeline
4773
+
4774
+ retry_configuration_property = codepipeline.CfnPipeline.RetryConfigurationProperty(
4775
+ retry_mode="retryMode"
4776
+ )
4777
+ '''
4778
+ if __debug__:
4779
+ type_hints = typing.get_type_hints(_typecheckingstub__ffc8deb7765afd70d3fe572ffa86634cd8936e44aafd092f3182c532d39fd363)
4780
+ check_type(argname="argument retry_mode", value=retry_mode, expected_type=type_hints["retry_mode"])
4781
+ self._values: typing.Dict[builtins.str, typing.Any] = {}
4782
+ if retry_mode is not None:
4783
+ self._values["retry_mode"] = retry_mode
4784
+
4785
+ @builtins.property
4786
+ def retry_mode(self) -> typing.Optional[builtins.str]:
4787
+ '''The method that you want to configure for automatic stage retry on stage failure.
4788
+
4789
+ You can specify to retry only failed action in the stage or all actions in the stage.
4790
+
4791
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-retryconfiguration.html#cfn-codepipeline-pipeline-retryconfiguration-retrymode
4792
+ '''
4793
+ result = self._values.get("retry_mode")
4794
+ return typing.cast(typing.Optional[builtins.str], result)
4795
+
4796
+ def __eq__(self, rhs: typing.Any) -> builtins.bool:
4797
+ return isinstance(rhs, self.__class__) and rhs._values == self._values
4798
+
4799
+ def __ne__(self, rhs: typing.Any) -> builtins.bool:
4800
+ return not (rhs == self)
4801
+
4802
+ def __repr__(self) -> str:
4803
+ return "RetryConfigurationProperty(%s)" % ", ".join(
4804
+ k + "=" + repr(v) for k, v in self._values.items()
4805
+ )
4806
+
4728
4807
  @jsii.data_type(
4729
4808
  jsii_type="aws-cdk-lib.aws_codepipeline.CfnPipeline.RuleDeclarationProperty",
4730
4809
  jsii_struct_bases=[],
@@ -5104,7 +5183,10 @@ class CfnPipeline(
5104
5183
  )
5105
5184
  )]
5106
5185
  )],
5107
- result="result"
5186
+ result="result",
5187
+ retry_configuration=codepipeline.CfnPipeline.RetryConfigurationProperty(
5188
+ retry_mode="retryMode"
5189
+ )
5108
5190
  ),
5109
5191
  on_success=codepipeline.CfnPipeline.SuccessConditionsProperty(
5110
5192
  conditions=[codepipeline.CfnPipeline.ConditionProperty(
@@ -5609,7 +5691,10 @@ class CfnPipelineProps:
5609
5691
  )
5610
5692
  )]
5611
5693
  )],
5612
- result="result"
5694
+ result="result",
5695
+ retry_configuration=codepipeline.CfnPipeline.RetryConfigurationProperty(
5696
+ retry_mode="retryMode"
5697
+ )
5613
5698
  ),
5614
5699
  on_success=codepipeline.CfnPipeline.SuccessConditionsProperty(
5615
5700
  conditions=[codepipeline.CfnPipeline.ConditionProperty(
@@ -10804,6 +10889,7 @@ def _typecheckingstub__24827e49ed35c3622e48ed5d5a7874646b28153667949aaac3a406383
10804
10889
  *,
10805
10890
  conditions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPipeline.ConditionProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
10806
10891
  result: typing.Optional[builtins.str] = None,
10892
+ retry_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnPipeline.RetryConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
10807
10893
  ) -> None:
10808
10894
  """Type checking stubs"""
10809
10895
  pass
@@ -10882,6 +10968,13 @@ def _typecheckingstub__4824b4ebe4c9c0ddbf15b9dd3cf1a2ffc31a1e5dfc394ba57c68b45d7
10882
10968
  """Type checking stubs"""
10883
10969
  pass
10884
10970
 
10971
+ def _typecheckingstub__ffc8deb7765afd70d3fe572ffa86634cd8936e44aafd092f3182c532d39fd363(
10972
+ *,
10973
+ retry_mode: typing.Optional[builtins.str] = None,
10974
+ ) -> None:
10975
+ """Type checking stubs"""
10976
+ pass
10977
+
10885
10978
  def _typecheckingstub__8b4c62f005bd4f9080fa5e8c7f7671821e7ac1c9314d5d3b1130fbf53e40fa51(
10886
10979
  *,
10887
10980
  configuration: typing.Any = None,
@@ -79,7 +79,7 @@ class CfnGitHubRepository(
79
79
  ):
80
80
  '''The ``AWS::CodeStar::GitHubRepository`` resource creates a GitHub repository where users can store source code for use with AWS workflows.
81
81
 
82
- You must provide a location for the source code ZIP file in the AWS CloudFormation template, so the code can be uploaded to the created repository. You must have created a personal access token in GitHub to provide in the AWS CloudFormation template. AWS uses this token to connect to GitHub on your behalf. For more information about using a GitHub source repository with AWS CodeStar projects, see `AWS CodeStar Project Files and Resources <https://docs.aws.amazon.com/codestar/latest/userguide/templates.html#templates-whatis>`_ .
82
+ You must provide a location for the source code ZIP file in the AWS CloudFormation template, so the code can be uploaded to the created repository. You must have created a personal access token in GitHub to provide in the AWS CloudFormation template. AWS uses this token to connect to GitHub on your behalf.
83
83
 
84
84
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestar-githubrepository.html
85
85
  :cloudformationResource: AWS::CodeStar::GitHubRepository
@@ -8959,14 +8959,6 @@ class CfnUserPoolIdentityProvider(
8959
8959
  '''The CloudFormation resource type name for this resource class.'''
8960
8960
  return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
8961
8961
 
8962
- @builtins.property
8963
- @jsii.member(jsii_name="attrId")
8964
- def attr_id(self) -> builtins.str:
8965
- '''
8966
- :cloudformationAttribute: Id
8967
- '''
8968
- return typing.cast(builtins.str, jsii.get(self, "attrId"))
8969
-
8970
8962
  @builtins.property
8971
8963
  @jsii.member(jsii_name="cfnProperties")
8972
8964
  def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
@@ -13078,7 +13078,7 @@ class CfnUser(
13078
13078
 
13079
13079
  .. epigraph::
13080
13080
 
13081
- For Amazon Connect instances that are created with the ``EXISTING_DIRECTORY`` identity management type, ``FirstName`` , ``LastName`` , and ``Email`` cannot be updated from within Amazon Connect because they are managed by the directory.
13081
+ For Amazon Connect instances that are created with the ``EXISTING_DIRECTORY`` identity management type, ``FirstName`` , ``LastName`` , and ``Email`` cannot be updated from within Amazon Connect because they are managed by the directory. > The ``FirstName`` and ``LastName`` length constraints below apply only to instances using SAML for identity management. If you are using Amazon Connect for identity management, the length constraints are 1-255 for ``FirstName`` , and 1-256 for ``LastName`` .
13082
13082
 
13083
13083
  :param email: The email address. If you are using SAML for identity management and include this parameter, an error is returned.
13084
13084
  :param first_name: The first name. This is required if you are using Amazon Connect or SAML for identity management.
@@ -6787,6 +6787,7 @@ class CfnTask(
6787
6787
  key="key",
6788
6788
  value="value"
6789
6789
  )],
6790
+ task_mode="taskMode",
6790
6791
  task_report_config=datasync.CfnTask.TaskReportConfigProperty(
6791
6792
  destination=datasync.CfnTask.DestinationProperty(
6792
6793
  s3=datasync.CfnTask.S3Property(
@@ -6833,6 +6834,7 @@ class CfnTask(
6833
6834
  options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTask.OptionsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
6834
6835
  schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTask.TaskScheduleProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
6835
6836
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
6837
+ task_mode: typing.Optional[builtins.str] = None,
6836
6838
  task_report_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTask.TaskReportConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
6837
6839
  ) -> None:
6838
6840
  '''
@@ -6840,14 +6842,15 @@ class CfnTask(
6840
6842
  :param id: Construct identifier for this resource (unique in its scope).
6841
6843
  :param destination_location_arn: The Amazon Resource Name (ARN) of an AWS storage resource's location.
6842
6844
  :param source_location_arn: Specifies the ARN of your transfer's source location.
6843
- :param cloud_watch_log_group_arn: Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task. For more information, see `Monitoring DataSync with Amazon CloudWatch <https://docs.aws.amazon.com/datasync/latest/userguide/monitor-datasync.html>`_ .
6845
+ :param cloud_watch_log_group_arn: Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task. For Enhanced mode tasks, you don't need to specify anything. DataSync automatically sends logs to a CloudWatch log group named ``/aws/datasync`` . For more information, see `Monitoring data transfers with CloudWatch Logs <https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html>`_ .
6844
6846
  :param excludes: Specifies exclude filters that define the files, objects, and folders in your source location that you don't want DataSync to transfer. For more information and examples, see `Specifying what DataSync transfers by using filters <https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html>`_ .
6845
- :param includes: Specifies include filters define the files, objects, and folders in your source location that you want DataSync to transfer. For more information and examples, see `Specifying what DataSync transfers by using filters <https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html>`_ .
6847
+ :param includes: Specifies include filters that define the files, objects, and folders in your source location that you want DataSync to transfer. For more information and examples, see `Specifying what DataSync transfers by using filters <https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html>`_ .
6846
6848
  :param manifest_config: The configuration of the manifest that lists the files or objects that you want DataSync to transfer. For more information, see `Specifying what DataSync transfers by using a manifest <https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html>`_ .
6847
6849
  :param name: Specifies the name of your task.
6848
6850
  :param options: Specifies your task's settings, such as preserving file metadata, verifying data integrity, among other options.
6849
6851
  :param schedule: Specifies a schedule for when you want your task to run. For more information, see `Scheduling your task <https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html>`_ .
6850
6852
  :param tags: Specifies the tags that you want to apply to your task. *Tags* are key-value pairs that help you manage, filter, and search for your DataSync resources.
6853
+ :param task_mode: Specifies one of the following task modes for your data transfer:. - ``ENHANCED`` - Transfer virtually unlimited numbers of objects with higher performance than Basic mode. Enhanced mode tasks optimize the data transfer process by listing, preparing, transferring, and verifying data in parallel. Enhanced mode is currently available for transfers between Amazon S3 locations. .. epigraph:: To create an Enhanced mode task, the IAM role that you use to call the ``CreateTask`` operation must have the ``iam:CreateServiceLinkedRole`` permission. - ``BASIC`` (default) - Transfer files or objects between AWS storage and all other supported DataSync locations. Basic mode tasks are subject to `quotas <https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html>`_ on the number of files, objects, and directories in a dataset. Basic mode sequentially prepares, transfers, and verifies data, making it slower than Enhanced mode for most workloads. For more information, see `Understanding task mode differences <https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences>`_ .
6851
6854
  :param task_report_config: Specifies how you want to configure a task report, which provides detailed information about your DataSync transfer. For more information, see `Monitoring your DataSync transfers with task reports <https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html>`_ . When using this parameter, your caller identity (the role that you're using DataSync with) must have the ``iam:PassRole`` permission. The `AWSDataSyncFullAccess <https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess>`_ policy includes this permission.
6852
6855
  '''
6853
6856
  if __debug__:
@@ -6865,6 +6868,7 @@ class CfnTask(
6865
6868
  options=options,
6866
6869
  schedule=schedule,
6867
6870
  tags=tags,
6871
+ task_mode=task_mode,
6868
6872
  task_report_config=task_report_config,
6869
6873
  )
6870
6874
 
@@ -7009,7 +7013,7 @@ class CfnTask(
7009
7013
  def includes(
7010
7014
  self,
7011
7015
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnTask.FilterRuleProperty"]]]]:
7012
- '''Specifies include filters define the files, objects, and folders in your source location that you want DataSync to transfer.'''
7016
+ '''Specifies include filters that define the files, objects, and folders in your source location that you want DataSync to transfer.'''
7013
7017
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnTask.FilterRuleProperty"]]]], jsii.get(self, "includes"))
7014
7018
 
7015
7019
  @includes.setter
@@ -7102,6 +7106,19 @@ class CfnTask(
7102
7106
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
7103
7107
  jsii.set(self, "tagsRaw", value) # pyright: ignore[reportArgumentType]
7104
7108
 
7109
+ @builtins.property
7110
+ @jsii.member(jsii_name="taskMode")
7111
+ def task_mode(self) -> typing.Optional[builtins.str]:
7112
+ '''Specifies one of the following task modes for your data transfer:.'''
7113
+ return typing.cast(typing.Optional[builtins.str], jsii.get(self, "taskMode"))
7114
+
7115
+ @task_mode.setter
7116
+ def task_mode(self, value: typing.Optional[builtins.str]) -> None:
7117
+ if __debug__:
7118
+ type_hints = typing.get_type_hints(_typecheckingstub__6e99e4be24e51c3d44b26f48102cf77d9140bcbda1c9d60362e39294acbc3244)
7119
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
7120
+ jsii.set(self, "taskMode", value) # pyright: ignore[reportArgumentType]
7121
+
7105
7122
  @builtins.property
7106
7123
  @jsii.member(jsii_name="taskReportConfig")
7107
7124
  def task_report_config(
@@ -8647,6 +8664,7 @@ class CfnTask(
8647
8664
  "options": "options",
8648
8665
  "schedule": "schedule",
8649
8666
  "tags": "tags",
8667
+ "task_mode": "taskMode",
8650
8668
  "task_report_config": "taskReportConfig",
8651
8669
  },
8652
8670
  )
@@ -8664,20 +8682,22 @@ class CfnTaskProps:
8664
8682
  options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.OptionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
8665
8683
  schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.TaskScheduleProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
8666
8684
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
8685
+ task_mode: typing.Optional[builtins.str] = None,
8667
8686
  task_report_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.TaskReportConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
8668
8687
  ) -> None:
8669
8688
  '''Properties for defining a ``CfnTask``.
8670
8689
 
8671
8690
  :param destination_location_arn: The Amazon Resource Name (ARN) of an AWS storage resource's location.
8672
8691
  :param source_location_arn: Specifies the ARN of your transfer's source location.
8673
- :param cloud_watch_log_group_arn: Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task. For more information, see `Monitoring DataSync with Amazon CloudWatch <https://docs.aws.amazon.com/datasync/latest/userguide/monitor-datasync.html>`_ .
8692
+ :param cloud_watch_log_group_arn: Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task. For Enhanced mode tasks, you don't need to specify anything. DataSync automatically sends logs to a CloudWatch log group named ``/aws/datasync`` . For more information, see `Monitoring data transfers with CloudWatch Logs <https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html>`_ .
8674
8693
  :param excludes: Specifies exclude filters that define the files, objects, and folders in your source location that you don't want DataSync to transfer. For more information and examples, see `Specifying what DataSync transfers by using filters <https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html>`_ .
8675
- :param includes: Specifies include filters define the files, objects, and folders in your source location that you want DataSync to transfer. For more information and examples, see `Specifying what DataSync transfers by using filters <https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html>`_ .
8694
+ :param includes: Specifies include filters that define the files, objects, and folders in your source location that you want DataSync to transfer. For more information and examples, see `Specifying what DataSync transfers by using filters <https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html>`_ .
8676
8695
  :param manifest_config: The configuration of the manifest that lists the files or objects that you want DataSync to transfer. For more information, see `Specifying what DataSync transfers by using a manifest <https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html>`_ .
8677
8696
  :param name: Specifies the name of your task.
8678
8697
  :param options: Specifies your task's settings, such as preserving file metadata, verifying data integrity, among other options.
8679
8698
  :param schedule: Specifies a schedule for when you want your task to run. For more information, see `Scheduling your task <https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html>`_ .
8680
8699
  :param tags: Specifies the tags that you want to apply to your task. *Tags* are key-value pairs that help you manage, filter, and search for your DataSync resources.
8700
+ :param task_mode: Specifies one of the following task modes for your data transfer:. - ``ENHANCED`` - Transfer virtually unlimited numbers of objects with higher performance than Basic mode. Enhanced mode tasks optimize the data transfer process by listing, preparing, transferring, and verifying data in parallel. Enhanced mode is currently available for transfers between Amazon S3 locations. .. epigraph:: To create an Enhanced mode task, the IAM role that you use to call the ``CreateTask`` operation must have the ``iam:CreateServiceLinkedRole`` permission. - ``BASIC`` (default) - Transfer files or objects between AWS storage and all other supported DataSync locations. Basic mode tasks are subject to `quotas <https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html>`_ on the number of files, objects, and directories in a dataset. Basic mode sequentially prepares, transfers, and verifies data, making it slower than Enhanced mode for most workloads. For more information, see `Understanding task mode differences <https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences>`_ .
8681
8701
  :param task_report_config: Specifies how you want to configure a task report, which provides detailed information about your DataSync transfer. For more information, see `Monitoring your DataSync transfers with task reports <https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html>`_ . When using this parameter, your caller identity (the role that you're using DataSync with) must have the ``iam:PassRole`` permission. The `AWSDataSyncFullAccess <https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess>`_ policy includes this permission.
8682
8702
 
8683
8703
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-task.html
@@ -8743,6 +8763,7 @@ class CfnTaskProps:
8743
8763
  key="key",
8744
8764
  value="value"
8745
8765
  )],
8766
+ task_mode="taskMode",
8746
8767
  task_report_config=datasync.CfnTask.TaskReportConfigProperty(
8747
8768
  destination=datasync.CfnTask.DestinationProperty(
8748
8769
  s3=datasync.CfnTask.S3Property(
@@ -8785,6 +8806,7 @@ class CfnTaskProps:
8785
8806
  check_type(argname="argument options", value=options, expected_type=type_hints["options"])
8786
8807
  check_type(argname="argument schedule", value=schedule, expected_type=type_hints["schedule"])
8787
8808
  check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
8809
+ check_type(argname="argument task_mode", value=task_mode, expected_type=type_hints["task_mode"])
8788
8810
  check_type(argname="argument task_report_config", value=task_report_config, expected_type=type_hints["task_report_config"])
8789
8811
  self._values: typing.Dict[builtins.str, typing.Any] = {
8790
8812
  "destination_location_arn": destination_location_arn,
@@ -8806,6 +8828,8 @@ class CfnTaskProps:
8806
8828
  self._values["schedule"] = schedule
8807
8829
  if tags is not None:
8808
8830
  self._values["tags"] = tags
8831
+ if task_mode is not None:
8832
+ self._values["task_mode"] = task_mode
8809
8833
  if task_report_config is not None:
8810
8834
  self._values["task_report_config"] = task_report_config
8811
8835
 
@@ -8833,7 +8857,9 @@ class CfnTaskProps:
8833
8857
  def cloud_watch_log_group_arn(self) -> typing.Optional[builtins.str]:
8834
8858
  '''Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task.
8835
8859
 
8836
- For more information, see `Monitoring DataSync with Amazon CloudWatch <https://docs.aws.amazon.com/datasync/latest/userguide/monitor-datasync.html>`_ .
8860
+ For Enhanced mode tasks, you don't need to specify anything. DataSync automatically sends logs to a CloudWatch log group named ``/aws/datasync`` .
8861
+
8862
+ For more information, see `Monitoring data transfers with CloudWatch Logs <https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html>`_ .
8837
8863
 
8838
8864
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-task.html#cfn-datasync-task-cloudwatchloggrouparn
8839
8865
  '''
@@ -8857,7 +8883,7 @@ class CfnTaskProps:
8857
8883
  def includes(
8858
8884
  self,
8859
8885
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnTask.FilterRuleProperty]]]]:
8860
- '''Specifies include filters define the files, objects, and folders in your source location that you want DataSync to transfer.
8886
+ '''Specifies include filters that define the files, objects, and folders in your source location that you want DataSync to transfer.
8861
8887
 
8862
8888
  For more information and examples, see `Specifying what DataSync transfers by using filters <https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html>`_ .
8863
8889
 
@@ -8923,6 +8949,25 @@ class CfnTaskProps:
8923
8949
  result = self._values.get("tags")
8924
8950
  return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], result)
8925
8951
 
8952
+ @builtins.property
8953
+ def task_mode(self) -> typing.Optional[builtins.str]:
8954
+ '''Specifies one of the following task modes for your data transfer:.
8955
+
8956
+ - ``ENHANCED`` - Transfer virtually unlimited numbers of objects with higher performance than Basic mode. Enhanced mode tasks optimize the data transfer process by listing, preparing, transferring, and verifying data in parallel. Enhanced mode is currently available for transfers between Amazon S3 locations.
8957
+
8958
+ .. epigraph::
8959
+
8960
+ To create an Enhanced mode task, the IAM role that you use to call the ``CreateTask`` operation must have the ``iam:CreateServiceLinkedRole`` permission.
8961
+
8962
+ - ``BASIC`` (default) - Transfer files or objects between AWS storage and all other supported DataSync locations. Basic mode tasks are subject to `quotas <https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html>`_ on the number of files, objects, and directories in a dataset. Basic mode sequentially prepares, transfers, and verifies data, making it slower than Enhanced mode for most workloads.
8963
+
8964
+ For more information, see `Understanding task mode differences <https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences>`_ .
8965
+
8966
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-task.html#cfn-datasync-task-taskmode
8967
+ '''
8968
+ result = self._values.get("task_mode")
8969
+ return typing.cast(typing.Optional[builtins.str], result)
8970
+
8926
8971
  @builtins.property
8927
8972
  def task_report_config(
8928
8973
  self,
@@ -10190,6 +10235,7 @@ def _typecheckingstub__9add9673a1f0ceb078949e967bce91066ff7e0441dae95d55c11c4a50
10190
10235
  options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.OptionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
10191
10236
  schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.TaskScheduleProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
10192
10237
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
10238
+ task_mode: typing.Optional[builtins.str] = None,
10193
10239
  task_report_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.TaskReportConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
10194
10240
  ) -> None:
10195
10241
  """Type checking stubs"""
@@ -10267,6 +10313,12 @@ def _typecheckingstub__b6a7067dff337df84908e53f4652767faada60769f6c9d1eed4c84d05
10267
10313
  """Type checking stubs"""
10268
10314
  pass
10269
10315
 
10316
+ def _typecheckingstub__6e99e4be24e51c3d44b26f48102cf77d9140bcbda1c9d60362e39294acbc3244(
10317
+ value: typing.Optional[builtins.str],
10318
+ ) -> None:
10319
+ """Type checking stubs"""
10320
+ pass
10321
+
10270
10322
  def _typecheckingstub__06ecaf368f7ae42942552393e7a68a01ddc8712caa5620400a489d0b07baae6e(
10271
10323
  value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTask.TaskReportConfigProperty]],
10272
10324
  ) -> None:
@@ -10413,6 +10465,7 @@ def _typecheckingstub__5632ab868186e470f4d8f0c14e3f12b71107be017f54f3194a076b9da
10413
10465
  options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.OptionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
10414
10466
  schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.TaskScheduleProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
10415
10467
  tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
10468
+ task_mode: typing.Optional[builtins.str] = None,
10416
10469
  task_report_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTask.TaskReportConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
10417
10470
  ) -> None:
10418
10471
  """Type checking stubs"""
@@ -879,7 +879,7 @@ class CfnResourceCollection(
879
879
 
880
880
  The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix ``Devops-guru-`` . The tag *key* might be ``DevOps-Guru-deployment-application`` or ``devops-guru-rds-application`` . When you create a *key* , the case of characters in the *key* can be whatever you choose. After you create a *key* , it is case-sensitive. For example, DevOps Guru works with a *key* named ``devops-guru-rds`` and a *key* named ``DevOps-Guru-RDS`` , and these act as two different *keys* . Possible *key* / *value* pairs in your application might be ``Devops-Guru-production-application/RDS`` or ``Devops-Guru-production-application/containers`` .
881
881
 
882
- :param app_boundary_key: An AWS tag *key* that is used to identify the AWS resources that DevOps Guru analyzes. All AWS resources in your account and Region tagged with this *key* make up your DevOps Guru application and analysis boundary. .. epigraph:: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix ``Devops-guru-`` . The tag *key* might be ``DevOps-Guru-deployment-application`` or ``devops-guru-rds-application`` . When you create a *key* , the case of characters in the *key* can be whatever you choose. After you create a *key* , it is case-sensitive. For example, DevOps Guru works with a *key* named ``devops-guru-rds`` and a *key* named ``DevOps-Guru-RDS`` , and these act as two different *keys* . Possible *key* / *value* pairs in your application might be ``Devops-Guru-production-application/RDS`` or ``Devops-Guru-production-application/containers`` .
882
+ :param app_boundary_key: An AWS tag *key* that is used to identify the AWS resources that DevOps Guru analyzes. All AWS resources in your account and Region tagged with this *key* make up your DevOps Guru application and analysis boundary. .. epigraph:: When you create a *key* , the case of characters in the *key* can be whatever you choose. After you create a *key* , it is case-sensitive. For example, DevOps Guru works with a *key* named ``devops-guru-rds`` and a *key* named ``DevOps-Guru-RDS`` , and these act as two different *keys* . Possible *key* / *value* pairs in your application might be ``Devops-Guru-production-application/RDS`` or ``Devops-Guru-production-application/containers`` .
883
883
  :param tag_values: The values in an AWS tag collection. The tag's *value* is a field used to associate a string with the tag *key* (for example, ``111122223333`` , ``Production`` , or a team name). The *key* and *value* are the tag's *key* pair. Omitting the tag *value* is the same as using an empty string. Like tag *keys* , tag *values* are case-sensitive. You can specify a maximum of 256 characters for a tag value. The tag value is a required property when *AppBoundaryKey* is specified.
884
884
 
885
885
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsguru-resourcecollection-tagcollection.html
@@ -913,7 +913,7 @@ class CfnResourceCollection(
913
913
  All AWS resources in your account and Region tagged with this *key* make up your DevOps Guru application and analysis boundary.
914
914
  .. epigraph::
915
915
 
916
- The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix ``Devops-guru-`` . The tag *key* might be ``DevOps-Guru-deployment-application`` or ``devops-guru-rds-application`` . When you create a *key* , the case of characters in the *key* can be whatever you choose. After you create a *key* , it is case-sensitive. For example, DevOps Guru works with a *key* named ``devops-guru-rds`` and a *key* named ``DevOps-Guru-RDS`` , and these act as two different *keys* . Possible *key* / *value* pairs in your application might be ``Devops-Guru-production-application/RDS`` or ``Devops-Guru-production-application/containers`` .
916
+ When you create a *key* , the case of characters in the *key* can be whatever you choose. After you create a *key* , it is case-sensitive. For example, DevOps Guru works with a *key* named ``devops-guru-rds`` and a *key* named ``DevOps-Guru-RDS`` , and these act as two different *keys* . Possible *key* / *value* pairs in your application might be ``Devops-Guru-production-application/RDS`` or ``Devops-Guru-production-application/containers`` .
917
917
 
918
918
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsguru-resourcecollection-tagcollection.html#cfn-devopsguru-resourcecollection-tagcollection-appboundarykey
919
919
  '''