aws-cdk-lib 2.138.0__py3-none-any.whl → 2.139.1__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 (37) hide show
  1. aws_cdk/_jsii/__init__.py +1 -1
  2. aws_cdk/_jsii/{aws-cdk-lib@2.138.0.jsii.tgz → aws-cdk-lib@2.139.1.jsii.tgz} +0 -0
  3. aws_cdk/aws_apigateway/__init__.py +29 -16
  4. aws_cdk/aws_appconfig/__init__.py +289 -44
  5. aws_cdk/aws_appintegrations/__init__.py +55 -6
  6. aws_cdk/aws_autoscaling/__init__.py +62 -60
  7. aws_cdk/aws_backup/__init__.py +34 -42
  8. aws_cdk/aws_batch/__init__.py +9 -3
  9. aws_cdk/aws_bedrock/__init__.py +4144 -0
  10. aws_cdk/aws_cloudwatch/__init__.py +120 -0
  11. aws_cdk/aws_datazone/__init__.py +22 -0
  12. aws_cdk/aws_dms/__init__.py +2 -4
  13. aws_cdk/aws_ec2/__init__.py +123 -84
  14. aws_cdk/aws_ecr/__init__.py +630 -0
  15. aws_cdk/aws_ecs/__init__.py +121 -19
  16. aws_cdk/aws_efs/__init__.py +592 -0
  17. aws_cdk/aws_elasticloadbalancingv2/__init__.py +23 -8
  18. aws_cdk/aws_events_targets/__init__.py +17 -4
  19. aws_cdk/aws_kms/__init__.py +44 -0
  20. aws_cdk/aws_lambda/__init__.py +9 -0
  21. aws_cdk/aws_oam/__init__.py +204 -0
  22. aws_cdk/aws_rds/__init__.py +15 -11
  23. aws_cdk/aws_redshiftserverless/__init__.py +157 -0
  24. aws_cdk/aws_securitylake/__init__.py +160 -105
  25. aws_cdk/aws_ses_actions/__init__.py +155 -0
  26. aws_cdk/aws_ssm/__init__.py +5 -2
  27. aws_cdk/aws_timestream/__init__.py +1045 -0
  28. aws_cdk/aws_transfer/__init__.py +15 -6
  29. aws_cdk/aws_wisdom/__init__.py +2 -2
  30. aws_cdk/custom_resources/__init__.py +440 -0
  31. aws_cdk/cx_api/__init__.py +17 -0
  32. {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.1.dist-info}/METADATA +1 -1
  33. {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.1.dist-info}/RECORD +37 -37
  34. {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.1.dist-info}/LICENSE +0 -0
  35. {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.1.dist-info}/NOTICE +0 -0
  36. {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.1.dist-info}/WHEEL +0 -0
  37. {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.1.dist-info}/top_level.txt +0 -0
@@ -70,7 +70,12 @@ class CfnAwsLogSource(
70
70
  metaclass=jsii.JSIIMeta,
71
71
  jsii_type="aws-cdk-lib.aws_securitylake.CfnAwsLogSource",
72
72
  ):
73
- '''Resource Type definition for AWS::SecurityLake::AwsLogSource.
73
+ '''Adds a natively supported AWS service as an AWS source.
74
+
75
+ Enables source types for member accounts in required AWS Regions, based on the parameters you specify. You can choose any source type in any Region for either accounts that are part of a trusted organization or standalone accounts. Once you add an AWS service as a source, Security Lake starts collecting logs and events from it.
76
+ .. epigraph::
77
+
78
+ If you want to create multiple sources using ``AWS::SecurityLake::AwsLogSource`` , you must use the ``DependsOn`` attribute to create the sources sequentially. With the ``DependsOn`` attribute you can specify that the creation of a specific ``AWSLogSource`` follows another. When you add a ``DependsOn`` attribute to a resource, that resource is created only after the creation of the resource specified in the ``DependsOn`` attribute. For an example, see `Add AWS log sources <https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-awslogsource.html#aws-resource-securitylake-awslogsource--examples>`_ .
74
79
 
75
80
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-awslogsource.html
76
81
  :cloudformationResource: AWS::SecurityLake::AwsLogSource
@@ -105,10 +110,10 @@ class CfnAwsLogSource(
105
110
  '''
106
111
  :param scope: Scope in which this resource is defined.
107
112
  :param id: Construct identifier for this resource (unique in its scope).
108
- :param data_lake_arn: The ARN for the data lake.
109
- :param source_name: The name for a AWS source. This must be a Regionally unique value.
110
- :param source_version: The version for a AWS source. This must be a Regionally unique value.
111
- :param accounts: AWS account where you want to collect logs from.
113
+ :param data_lake_arn: The Amazon Resource Name (ARN) used to create the data lake.
114
+ :param source_name: The name for a AWS source. This must be a Regionally unique value. For the list of sources supported by Amazon Security Lake see `Collecting data from AWS services <https://docs.aws.amazon.com//security-lake/latest/userguide/internal-sources.html>`_ in the Amazon Security Lake User Guide.
115
+ :param source_version: The version for a AWS source. For more details about source versions supported by Amazon Security Lake see `OCSF source identification <https://docs.aws.amazon.com//security-lake/latest/userguide/open-cybersecurity-schema-framework.html#ocsf-source-identification>`_ in the Amazon Security Lake User Guide. This must be a Regionally unique value.
116
+ :param accounts: Specify the AWS account information where you want to enable Security Lake.
112
117
  '''
113
118
  if __debug__:
114
119
  type_hints = typing.get_type_hints(_typecheckingstub__c67fc1d68d61ef9dead7d443499c1a142da192386efc06474b3758994937de6b)
@@ -161,7 +166,7 @@ class CfnAwsLogSource(
161
166
  @builtins.property
162
167
  @jsii.member(jsii_name="dataLakeArn")
163
168
  def data_lake_arn(self) -> builtins.str:
164
- '''The ARN for the data lake.'''
169
+ '''The Amazon Resource Name (ARN) used to create the data lake.'''
165
170
  return typing.cast(builtins.str, jsii.get(self, "dataLakeArn"))
166
171
 
167
172
  @data_lake_arn.setter
@@ -200,7 +205,7 @@ class CfnAwsLogSource(
200
205
  @builtins.property
201
206
  @jsii.member(jsii_name="accounts")
202
207
  def accounts(self) -> typing.Optional[typing.List[builtins.str]]:
203
- '''AWS account where you want to collect logs from.'''
208
+ '''Specify the AWS account information where you want to enable Security Lake.'''
204
209
  return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "accounts"))
205
210
 
206
211
  @accounts.setter
@@ -232,10 +237,10 @@ class CfnAwsLogSourceProps:
232
237
  ) -> None:
233
238
  '''Properties for defining a ``CfnAwsLogSource``.
234
239
 
235
- :param data_lake_arn: The ARN for the data lake.
236
- :param source_name: The name for a AWS source. This must be a Regionally unique value.
237
- :param source_version: The version for a AWS source. This must be a Regionally unique value.
238
- :param accounts: AWS account where you want to collect logs from.
240
+ :param data_lake_arn: The Amazon Resource Name (ARN) used to create the data lake.
241
+ :param source_name: The name for a AWS source. This must be a Regionally unique value. For the list of sources supported by Amazon Security Lake see `Collecting data from AWS services <https://docs.aws.amazon.com//security-lake/latest/userguide/internal-sources.html>`_ in the Amazon Security Lake User Guide.
242
+ :param source_version: The version for a AWS source. For more details about source versions supported by Amazon Security Lake see `OCSF source identification <https://docs.aws.amazon.com//security-lake/latest/userguide/open-cybersecurity-schema-framework.html#ocsf-source-identification>`_ in the Amazon Security Lake User Guide. This must be a Regionally unique value.
243
+ :param accounts: Specify the AWS account information where you want to enable Security Lake.
239
244
 
240
245
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-awslogsource.html
241
246
  :exampleMetadata: fixture=_generated
@@ -271,7 +276,7 @@ class CfnAwsLogSourceProps:
271
276
 
272
277
  @builtins.property
273
278
  def data_lake_arn(self) -> builtins.str:
274
- '''The ARN for the data lake.
279
+ '''The Amazon Resource Name (ARN) used to create the data lake.
275
280
 
276
281
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-awslogsource.html#cfn-securitylake-awslogsource-datalakearn
277
282
  '''
@@ -283,7 +288,7 @@ class CfnAwsLogSourceProps:
283
288
  def source_name(self) -> builtins.str:
284
289
  '''The name for a AWS source.
285
290
 
286
- This must be a Regionally unique value.
291
+ This must be a Regionally unique value. For the list of sources supported by Amazon Security Lake see `Collecting data from AWS services <https://docs.aws.amazon.com//security-lake/latest/userguide/internal-sources.html>`_ in the Amazon Security Lake User Guide.
287
292
 
288
293
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-awslogsource.html#cfn-securitylake-awslogsource-sourcename
289
294
  '''
@@ -295,7 +300,7 @@ class CfnAwsLogSourceProps:
295
300
  def source_version(self) -> builtins.str:
296
301
  '''The version for a AWS source.
297
302
 
298
- This must be a Regionally unique value.
303
+ For more details about source versions supported by Amazon Security Lake see `OCSF source identification <https://docs.aws.amazon.com//security-lake/latest/userguide/open-cybersecurity-schema-framework.html#ocsf-source-identification>`_ in the Amazon Security Lake User Guide. This must be a Regionally unique value.
299
304
 
300
305
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-awslogsource.html#cfn-securitylake-awslogsource-sourceversion
301
306
  '''
@@ -305,7 +310,7 @@ class CfnAwsLogSourceProps:
305
310
 
306
311
  @builtins.property
307
312
  def accounts(self) -> typing.Optional[typing.List[builtins.str]]:
308
- '''AWS account where you want to collect logs from.
313
+ '''Specify the AWS account information where you want to enable Security Lake.
309
314
 
310
315
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-awslogsource.html#cfn-securitylake-awslogsource-accounts
311
316
  '''
@@ -330,7 +335,11 @@ class CfnDataLake(
330
335
  metaclass=jsii.JSIIMeta,
331
336
  jsii_type="aws-cdk-lib.aws_securitylake.CfnDataLake",
332
337
  ):
333
- '''Resource Type definition for AWS::SecurityLake::DataLake.
338
+ '''Initializes an Amazon Security Lake instance with the provided (or default) configuration.
339
+
340
+ You can enable Security Lake in AWS Regions with customized settings before enabling log collection in Regions. To specify particular Regions, configure these Regions using the ``configurations`` parameter. If you have already enabled Security Lake in a Region when you call this command, the command will update the Region if you provide new configuration parameters. If you have not already enabled Security Lake in the Region when you call this API, it will set up the data lake in the Region with the specified configurations.
341
+
342
+ When you enable Security Lake , it starts ingesting security data after the ``CreateAwsLogSource`` call. This includes ingesting security data from sources, storing data, and making data accessible to subscribers. Security Lake also enables all the existing settings and resources that it stores or maintains for your AWS account in the current Region, including security log and event data. For more information, see the `Amazon Security Lake User Guide <https://docs.aws.amazon.com//security-lake/latest/userguide/what-is-security-lake.html>`_ .
334
343
 
335
344
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-datalake.html
336
345
  :cloudformationResource: AWS::SecurityLake::DataLake
@@ -381,11 +390,11 @@ class CfnDataLake(
381
390
  '''
382
391
  :param scope: Scope in which this resource is defined.
383
392
  :param id: Construct identifier for this resource (unique in its scope).
384
- :param encryption_configuration: Provides encryption details of Amazon Security Lake object.
385
- :param lifecycle_configuration: Provides lifecycle details of Amazon Security Lake object.
386
- :param meta_store_manager_role_arn: The Amazon Resource Name (ARN) used to index AWS Glue table partitions that are generated by the ingestion and normalization of AWS log sources and custom sources.
393
+ :param encryption_configuration: Provides encryption details of the Amazon Security Lake object.
394
+ :param lifecycle_configuration: You can customize Security Lake to store data in your preferred AWS Regions for your preferred amount of time. Lifecycle management can help you comply with different compliance requirements. For more details, see `Lifecycle management <https://docs.aws.amazon.com//security-lake/latest/userguide/lifecycle-management.html>`_ in the Amazon Security Lake User Guide.
395
+ :param meta_store_manager_role_arn: The Amazon Resource Name (ARN) used to create and update the AWS Glue table. This table contains partitions generated by the ingestion and normalization of AWS log sources and custom sources.
387
396
  :param replication_configuration: Provides replication details of Amazon Security Lake object.
388
- :param tags:
397
+ :param tags: An array of objects, one for each tag to associate with the data lake configuration. For each tag, you must specify both a tag key and a tag value. A tag value cannot be null, but it can be an empty string.
389
398
  '''
390
399
  if __debug__:
391
400
  type_hints = typing.get_type_hints(_typecheckingstub__ff487a50882ee11f396717fb970b445f3274af88108d1c1d390543dfb1fdf534)
@@ -434,7 +443,7 @@ class CfnDataLake(
434
443
  @builtins.property
435
444
  @jsii.member(jsii_name="attrArn")
436
445
  def attr_arn(self) -> builtins.str:
437
- '''The Amazon Resource Name (ARN) created by you to provide to the subscriber.
446
+ '''The Amazon Resource Name (ARN) of the data lake.
438
447
 
439
448
  :cloudformationAttribute: Arn
440
449
  '''
@@ -443,7 +452,7 @@ class CfnDataLake(
443
452
  @builtins.property
444
453
  @jsii.member(jsii_name="attrS3BucketArn")
445
454
  def attr_s3_bucket_arn(self) -> builtins.str:
446
- '''The ARN for the Amazon Security Lake Amazon S3 bucket.
455
+ '''The Amazon Resource Name (ARN) of the Amazon S3 bucket.
447
456
 
448
457
  :cloudformationAttribute: S3BucketArn
449
458
  '''
@@ -465,7 +474,7 @@ class CfnDataLake(
465
474
  def encryption_configuration(
466
475
  self,
467
476
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataLake.EncryptionConfigurationProperty"]]:
468
- '''Provides encryption details of Amazon Security Lake object.'''
477
+ '''Provides encryption details of the Amazon Security Lake object.'''
469
478
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataLake.EncryptionConfigurationProperty"]], jsii.get(self, "encryptionConfiguration"))
470
479
 
471
480
  @encryption_configuration.setter
@@ -483,7 +492,7 @@ class CfnDataLake(
483
492
  def lifecycle_configuration(
484
493
  self,
485
494
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataLake.LifecycleConfigurationProperty"]]:
486
- '''Provides lifecycle details of Amazon Security Lake object.'''
495
+ '''You can customize Security Lake to store data in your preferred AWS Regions for your preferred amount of time.'''
487
496
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataLake.LifecycleConfigurationProperty"]], jsii.get(self, "lifecycleConfiguration"))
488
497
 
489
498
  @lifecycle_configuration.setter
@@ -499,7 +508,7 @@ class CfnDataLake(
499
508
  @builtins.property
500
509
  @jsii.member(jsii_name="metaStoreManagerRoleArn")
501
510
  def meta_store_manager_role_arn(self) -> typing.Optional[builtins.str]:
502
- '''The Amazon Resource Name (ARN) used to index AWS Glue table partitions that are generated by the ingestion and normalization of AWS log sources and custom sources.'''
511
+ '''The Amazon Resource Name (ARN) used to create and update the AWS Glue table.'''
503
512
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "metaStoreManagerRoleArn"))
504
513
 
505
514
  @meta_store_manager_role_arn.setter
@@ -530,6 +539,7 @@ class CfnDataLake(
530
539
  @builtins.property
531
540
  @jsii.member(jsii_name="tags")
532
541
  def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
542
+ '''An array of objects, one for each tag to associate with the data lake configuration.'''
533
543
  return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
534
544
 
535
545
  @tags.setter
@@ -546,9 +556,11 @@ class CfnDataLake(
546
556
  )
547
557
  class EncryptionConfigurationProperty:
548
558
  def __init__(self, *, kms_key_id: typing.Optional[builtins.str] = None) -> None:
549
- '''Provides encryption details of Amazon Security Lake object.
559
+ '''Provides encryption details of the Amazon Security Lake object.
560
+
561
+ The AWS shared responsibility model applies to data protection in Amazon Security Lake . As described in this model, AWS is responsible for protecting the global infrastructure that runs all of the AWS Cloud. You are responsible for maintaining control over your content that is hosted on this infrastructure. For more details, see `Data protection <https://docs.aws.amazon.com//security-lake/latest/userguide/data-protection.html>`_ in the Amazon Security Lake User Guide.
550
562
 
551
- :param kms_key_id: The id of KMS encryption key used by Amazon Security Lake to encrypt the Security Lake object.
563
+ :param kms_key_id: The ID of KMS encryption key used by Amazon Security Lake to encrypt the Security Lake object.
552
564
 
553
565
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-encryptionconfiguration.html
554
566
  :exampleMetadata: fixture=_generated
@@ -572,7 +584,7 @@ class CfnDataLake(
572
584
 
573
585
  @builtins.property
574
586
  def kms_key_id(self) -> typing.Optional[builtins.str]:
575
- '''The id of KMS encryption key used by Amazon Security Lake to encrypt the Security Lake object.
587
+ '''The ID of KMS encryption key used by Amazon Security Lake to encrypt the Security Lake object.
576
588
 
577
589
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-encryptionconfiguration.html#cfn-securitylake-datalake-encryptionconfiguration-kmskeyid
578
590
  '''
@@ -597,9 +609,11 @@ class CfnDataLake(
597
609
  )
598
610
  class ExpirationProperty:
599
611
  def __init__(self, *, days: typing.Optional[jsii.Number] = None) -> None:
600
- '''Provides data expiration details of Amazon Security Lake object.
612
+ '''Provides data expiration details of the Amazon Security Lake object.
613
+
614
+ You can specify your preferred Amazon S3 storage class and the time period for S3 objects to stay in that storage class before they expire. For more information about Amazon S3 Lifecycle configurations, see `Managing your storage lifecycle <https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html>`_ in the *Amazon Simple Storage Service User Guide* .
601
615
 
602
- :param days: Number of days before data expires in the Amazon Security Lake object.
616
+ :param days: The number of days before data expires in the Amazon Security Lake object.
603
617
 
604
618
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-expiration.html
605
619
  :exampleMetadata: fixture=_generated
@@ -623,7 +637,7 @@ class CfnDataLake(
623
637
 
624
638
  @builtins.property
625
639
  def days(self) -> typing.Optional[jsii.Number]:
626
- '''Number of days before data expires in the Amazon Security Lake object.
640
+ '''The number of days before data expires in the Amazon Security Lake object.
627
641
 
628
642
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-expiration.html#cfn-securitylake-datalake-expiration-days
629
643
  '''
@@ -655,8 +669,15 @@ class CfnDataLake(
655
669
  ) -> None:
656
670
  '''Provides lifecycle details of Amazon Security Lake object.
657
671
 
658
- :param expiration: Provides data expiration details of Amazon Security Lake object.
659
- :param transitions: Provides data storage transition details of Amazon Security Lake object.
672
+ To manage your data so that it is stored cost effectively, you can configure retention settings for the data. You can specify your preferred Amazon S3 storage class and the time period for Amazon S3 objects to stay in that storage class before they transition to a different storage class or expire. For more information about Amazon S3 Lifecycle configurations, see `Managing your storage lifecycle <https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html>`_ in the *Amazon Simple Storage Service User Guide* .
673
+
674
+ In Security Lake , you specify retention settings at the Region level. For example, you might choose to transition all S3 objects in a specific AWS Region to the ``S3 Standard-IA`` storage class 30 days after they're written to the data lake. The default Amazon S3 storage class is S3 Standard.
675
+ .. epigraph::
676
+
677
+ Security Lake doesn't support Amazon S3 Object Lock. When the data lake buckets are created, S3 Object Lock is disabled by default. Enabling S3 Object Lock with default retention mode interrupts the delivery of normalized log data to the data lake.
678
+
679
+ :param expiration: Provides data expiration details of the Amazon Security Lake object.
680
+ :param transitions: Provides data storage transition details of Amazon Security Lake object. By configuring these settings, you can specify your preferred Amazon S3 storage class and the time period for S3 objects to stay in that storage class before they transition to a different storage class.
660
681
 
661
682
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-lifecycleconfiguration.html
662
683
  :exampleMetadata: fixture=_generated
@@ -691,7 +712,7 @@ class CfnDataLake(
691
712
  def expiration(
692
713
  self,
693
714
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataLake.ExpirationProperty"]]:
694
- '''Provides data expiration details of Amazon Security Lake object.
715
+ '''Provides data expiration details of the Amazon Security Lake object.
695
716
 
696
717
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-lifecycleconfiguration.html#cfn-securitylake-datalake-lifecycleconfiguration-expiration
697
718
  '''
@@ -704,6 +725,8 @@ class CfnDataLake(
704
725
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataLake.TransitionsProperty"]]]]:
705
726
  '''Provides data storage transition details of Amazon Security Lake object.
706
727
 
728
+ By configuring these settings, you can specify your preferred Amazon S3 storage class and the time period for S3 objects to stay in that storage class before they transition to a different storage class.
729
+
707
730
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-lifecycleconfiguration.html#cfn-securitylake-datalake-lifecycleconfiguration-transitions
708
731
  '''
709
732
  result = self._values.get("transitions")
@@ -732,10 +755,10 @@ class CfnDataLake(
732
755
  regions: typing.Optional[typing.Sequence[builtins.str]] = None,
733
756
  role_arn: typing.Optional[builtins.str] = None,
734
757
  ) -> None:
735
- '''Provides replication details of Amazon Security Lake object.
758
+ '''Provides replication configuration details for objects stored in the Amazon Security Lake data lake.
736
759
 
737
- :param regions: Replication enables automatic, asynchronous copying of objects across Amazon S3 buckets. Amazon S3 buckets that are configured for object replication can be owned by the same AWS account or by different accounts. You can replicate objects to a single destination bucket or to multiple destination buckets. The destination buckets can be in different AWS Regions or within the same Region as the source bucket.
738
- :param role_arn: Replication settings for the Amazon S3 buckets. This parameter uses the AWS Identity and Access Management (IAM) role you created that is managed by Security Lake, to ensure the replication setting is correct.
760
+ :param regions: Specifies one or more centralized rollup Regions. The AWS Region specified in the region parameter of the ``CreateDataLake`` or ``UpdateDataLake`` operations contributes data to the rollup Region or Regions specified in this parameter. Replication enables automatic, asynchronous copying of objects across Amazon S3 buckets. S3 buckets that are configured for object replication can be owned by the same AWS account or by different accounts. You can replicate objects to a single destination bucket or to multiple destination buckets. The destination buckets can be in different Regions or within the same Region as the source bucket.
761
+ :param role_arn: Replication settings for the Amazon S3 buckets. This parameter uses the AWS Identity and Access Management (IAM) role you created that is managed by Security Lake , to ensure the replication setting is correct.
739
762
 
740
763
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-replicationconfiguration.html
741
764
  :exampleMetadata: fixture=_generated
@@ -763,9 +786,11 @@ class CfnDataLake(
763
786
 
764
787
  @builtins.property
765
788
  def regions(self) -> typing.Optional[typing.List[builtins.str]]:
766
- '''Replication enables automatic, asynchronous copying of objects across Amazon S3 buckets.
789
+ '''Specifies one or more centralized rollup Regions.
790
+
791
+ The AWS Region specified in the region parameter of the ``CreateDataLake`` or ``UpdateDataLake`` operations contributes data to the rollup Region or Regions specified in this parameter.
767
792
 
768
- Amazon S3 buckets that are configured for object replication can be owned by the same AWS account or by different accounts. You can replicate objects to a single destination bucket or to multiple destination buckets. The destination buckets can be in different AWS Regions or within the same Region as the source bucket.
793
+ Replication enables automatic, asynchronous copying of objects across Amazon S3 buckets. S3 buckets that are configured for object replication can be owned by the same AWS account or by different accounts. You can replicate objects to a single destination bucket or to multiple destination buckets. The destination buckets can be in different Regions or within the same Region as the source bucket.
769
794
 
770
795
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-replicationconfiguration.html#cfn-securitylake-datalake-replicationconfiguration-regions
771
796
  '''
@@ -776,7 +801,7 @@ class CfnDataLake(
776
801
  def role_arn(self) -> typing.Optional[builtins.str]:
777
802
  '''Replication settings for the Amazon S3 buckets.
778
803
 
779
- This parameter uses the AWS Identity and Access Management (IAM) role you created that is managed by Security Lake, to ensure the replication setting is correct.
804
+ This parameter uses the AWS Identity and Access Management (IAM) role you created that is managed by Security Lake , to ensure the replication setting is correct.
780
805
 
781
806
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-replicationconfiguration.html#cfn-securitylake-datalake-replicationconfiguration-rolearn
782
807
  '''
@@ -806,9 +831,12 @@ class CfnDataLake(
806
831
  days: typing.Optional[jsii.Number] = None,
807
832
  storage_class: typing.Optional[builtins.str] = None,
808
833
  ) -> None:
809
- '''
810
- :param days: Number of days before data transitions to a different S3 Storage Class in the Amazon Security Lake object.
811
- :param storage_class: The range of storage classes that you can choose from based on the data access, resiliency, and cost requirements of your workloads.
834
+ '''Provides transition lifecycle details of the Amazon Security Lake object.
835
+
836
+ For more information about Amazon S3 Lifecycle configurations, see `Managing your storage lifecycle <https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html>`_ in the *Amazon Simple Storage Service User Guide* .
837
+
838
+ :param days: The number of days before data transitions to a different S3 Storage Class in the Amazon Security Lake object.
839
+ :param storage_class: The list of storage classes that you can choose from based on the data access, resiliency, and cost requirements of your workloads. The default storage class is S3 Standard.
812
840
 
813
841
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-transitions.html
814
842
  :exampleMetadata: fixture=_generated
@@ -836,7 +864,7 @@ class CfnDataLake(
836
864
 
837
865
  @builtins.property
838
866
  def days(self) -> typing.Optional[jsii.Number]:
839
- '''Number of days before data transitions to a different S3 Storage Class in the Amazon Security Lake object.
867
+ '''The number of days before data transitions to a different S3 Storage Class in the Amazon Security Lake object.
840
868
 
841
869
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-transitions.html#cfn-securitylake-datalake-transitions-days
842
870
  '''
@@ -845,7 +873,9 @@ class CfnDataLake(
845
873
 
846
874
  @builtins.property
847
875
  def storage_class(self) -> typing.Optional[builtins.str]:
848
- '''The range of storage classes that you can choose from based on the data access, resiliency, and cost requirements of your workloads.
876
+ '''The list of storage classes that you can choose from based on the data access, resiliency, and cost requirements of your workloads.
877
+
878
+ The default storage class is S3 Standard.
849
879
 
850
880
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-datalake-transitions.html#cfn-securitylake-datalake-transitions-storageclass
851
881
  '''
@@ -887,11 +917,11 @@ class CfnDataLakeProps:
887
917
  ) -> None:
888
918
  '''Properties for defining a ``CfnDataLake``.
889
919
 
890
- :param encryption_configuration: Provides encryption details of Amazon Security Lake object.
891
- :param lifecycle_configuration: Provides lifecycle details of Amazon Security Lake object.
892
- :param meta_store_manager_role_arn: The Amazon Resource Name (ARN) used to index AWS Glue table partitions that are generated by the ingestion and normalization of AWS log sources and custom sources.
920
+ :param encryption_configuration: Provides encryption details of the Amazon Security Lake object.
921
+ :param lifecycle_configuration: You can customize Security Lake to store data in your preferred AWS Regions for your preferred amount of time. Lifecycle management can help you comply with different compliance requirements. For more details, see `Lifecycle management <https://docs.aws.amazon.com//security-lake/latest/userguide/lifecycle-management.html>`_ in the Amazon Security Lake User Guide.
922
+ :param meta_store_manager_role_arn: The Amazon Resource Name (ARN) used to create and update the AWS Glue table. This table contains partitions generated by the ingestion and normalization of AWS log sources and custom sources.
893
923
  :param replication_configuration: Provides replication details of Amazon Security Lake object.
894
- :param tags:
924
+ :param tags: An array of objects, one for each tag to associate with the data lake configuration. For each tag, you must specify both a tag key and a tag value. A tag value cannot be null, but it can be an empty string.
895
925
 
896
926
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-datalake.html
897
927
  :exampleMetadata: fixture=_generated
@@ -949,7 +979,7 @@ class CfnDataLakeProps:
949
979
  def encryption_configuration(
950
980
  self,
951
981
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDataLake.EncryptionConfigurationProperty]]:
952
- '''Provides encryption details of Amazon Security Lake object.
982
+ '''Provides encryption details of the Amazon Security Lake object.
953
983
 
954
984
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-datalake.html#cfn-securitylake-datalake-encryptionconfiguration
955
985
  '''
@@ -960,7 +990,9 @@ class CfnDataLakeProps:
960
990
  def lifecycle_configuration(
961
991
  self,
962
992
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDataLake.LifecycleConfigurationProperty]]:
963
- '''Provides lifecycle details of Amazon Security Lake object.
993
+ '''You can customize Security Lake to store data in your preferred AWS Regions for your preferred amount of time.
994
+
995
+ Lifecycle management can help you comply with different compliance requirements. For more details, see `Lifecycle management <https://docs.aws.amazon.com//security-lake/latest/userguide/lifecycle-management.html>`_ in the Amazon Security Lake User Guide.
964
996
 
965
997
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-datalake.html#cfn-securitylake-datalake-lifecycleconfiguration
966
998
  '''
@@ -969,7 +1001,9 @@ class CfnDataLakeProps:
969
1001
 
970
1002
  @builtins.property
971
1003
  def meta_store_manager_role_arn(self) -> typing.Optional[builtins.str]:
972
- '''The Amazon Resource Name (ARN) used to index AWS Glue table partitions that are generated by the ingestion and normalization of AWS log sources and custom sources.
1004
+ '''The Amazon Resource Name (ARN) used to create and update the AWS Glue table.
1005
+
1006
+ This table contains partitions generated by the ingestion and normalization of AWS log sources and custom sources.
973
1007
 
974
1008
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-datalake.html#cfn-securitylake-datalake-metastoremanagerrolearn
975
1009
  '''
@@ -989,7 +1023,10 @@ class CfnDataLakeProps:
989
1023
 
990
1024
  @builtins.property
991
1025
  def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
992
- '''
1026
+ '''An array of objects, one for each tag to associate with the data lake configuration.
1027
+
1028
+ For each tag, you must specify both a tag key and a tag value. A tag value cannot be null, but it can be an empty string.
1029
+
993
1030
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-datalake.html#cfn-securitylake-datalake-tags
994
1031
  '''
995
1032
  result = self._values.get("tags")
@@ -1013,7 +1050,9 @@ class CfnSubscriber(
1013
1050
  metaclass=jsii.JSIIMeta,
1014
1051
  jsii_type="aws-cdk-lib.aws_securitylake.CfnSubscriber",
1015
1052
  ):
1016
- '''Resource Type definition for AWS::SecurityLake::Subscriber.
1053
+ '''Creates a subscriber for accounts that are already enabled in Amazon Security Lake.
1054
+
1055
+ You can create a subscriber with access to data in the current AWS Region.
1017
1056
 
1018
1057
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-subscriber.html
1019
1058
  :cloudformationResource: AWS::SecurityLake::Subscriber
@@ -1069,12 +1108,12 @@ class CfnSubscriber(
1069
1108
  '''
1070
1109
  :param scope: Scope in which this resource is defined.
1071
1110
  :param id: Construct identifier for this resource (unique in its scope).
1072
- :param access_types: The Amazon S3 or AWS Lake Formation access type.
1073
- :param data_lake_arn: The ARN for the data lake.
1074
- :param sources: The supported AWS services from which logs and events are collected.
1111
+ :param access_types: You can choose to notify subscribers of new objects with an Amazon Simple Queue Service (Amazon SQS) queue or through messaging to an HTTPS endpoint provided by the subscriber. Subscribers can consume data by directly querying AWS Lake Formation tables in your Amazon S3 bucket through services like Amazon Athena. This subscription type is defined as ``LAKEFORMATION`` .
1112
+ :param data_lake_arn: The Amazon Resource Name (ARN) used to create the data lake.
1113
+ :param sources: Amazon Security Lake supports log and event collection for natively supported AWS services . For more information, see the `Amazon Security Lake User Guide <https://docs.aws.amazon.com//security-lake/latest/userguide/source-management.html>`_ .
1075
1114
  :param subscriber_identity: The AWS identity used to access your data.
1076
- :param subscriber_name: The name of your Security Lake subscriber account.
1077
- :param subscriber_description: The description for your subscriber account in Security Lake.
1115
+ :param subscriber_name: The name of your Amazon Security Lake subscriber account.
1116
+ :param subscriber_description: The subscriber descriptions for a subscriber account. The description for a subscriber includes ``subscriberName`` , ``accountID`` , ``externalID`` , and ``subscriberId`` .
1078
1117
  :param tags: An array of objects, one for each tag to associate with the subscriber. For each tag, you must specify both a tag key and a tag value. A tag value cannot be null, but it can be an empty string.
1079
1118
  '''
1080
1119
  if __debug__:
@@ -1126,7 +1165,8 @@ class CfnSubscriber(
1126
1165
  @builtins.property
1127
1166
  @jsii.member(jsii_name="attrResourceShareArn")
1128
1167
  def attr_resource_share_arn(self) -> builtins.str:
1129
- '''
1168
+ '''The Amazon Resource Name (ARN) of the Amazon Security Lake subscriber.
1169
+
1130
1170
  :cloudformationAttribute: ResourceShareArn
1131
1171
  '''
1132
1172
  return typing.cast(builtins.str, jsii.get(self, "attrResourceShareArn"))
@@ -1134,7 +1174,8 @@ class CfnSubscriber(
1134
1174
  @builtins.property
1135
1175
  @jsii.member(jsii_name="attrResourceShareName")
1136
1176
  def attr_resource_share_name(self) -> builtins.str:
1137
- '''
1177
+ '''The ARN name of the Amazon Security Lake subscriber.
1178
+
1138
1179
  :cloudformationAttribute: ResourceShareName
1139
1180
  '''
1140
1181
  return typing.cast(builtins.str, jsii.get(self, "attrResourceShareName"))
@@ -1142,7 +1183,8 @@ class CfnSubscriber(
1142
1183
  @builtins.property
1143
1184
  @jsii.member(jsii_name="attrS3BucketArn")
1144
1185
  def attr_s3_bucket_arn(self) -> builtins.str:
1145
- '''
1186
+ '''The Amazon Resource Name (ARN) of the S3 bucket.
1187
+
1146
1188
  :cloudformationAttribute: S3BucketArn
1147
1189
  '''
1148
1190
  return typing.cast(builtins.str, jsii.get(self, "attrS3BucketArn"))
@@ -1150,7 +1192,8 @@ class CfnSubscriber(
1150
1192
  @builtins.property
1151
1193
  @jsii.member(jsii_name="attrSubscriberArn")
1152
1194
  def attr_subscriber_arn(self) -> builtins.str:
1153
- '''
1195
+ '''The Amazon Resource Name (ARN) of the Security Lake subscriber.
1196
+
1154
1197
  :cloudformationAttribute: SubscriberArn
1155
1198
  '''
1156
1199
  return typing.cast(builtins.str, jsii.get(self, "attrSubscriberArn"))
@@ -1158,7 +1201,8 @@ class CfnSubscriber(
1158
1201
  @builtins.property
1159
1202
  @jsii.member(jsii_name="attrSubscriberRoleArn")
1160
1203
  def attr_subscriber_role_arn(self) -> builtins.str:
1161
- '''
1204
+ '''The Amazon Resource Name (ARN) of the role used to create the Security Lake subscriber.
1205
+
1162
1206
  :cloudformationAttribute: SubscriberRoleArn
1163
1207
  '''
1164
1208
  return typing.cast(builtins.str, jsii.get(self, "attrSubscriberRoleArn"))
@@ -1177,7 +1221,7 @@ class CfnSubscriber(
1177
1221
  @builtins.property
1178
1222
  @jsii.member(jsii_name="accessTypes")
1179
1223
  def access_types(self) -> typing.List[builtins.str]:
1180
- '''The Amazon S3 or AWS Lake Formation access type.'''
1224
+ '''You can choose to notify subscribers of new objects with an Amazon Simple Queue Service (Amazon SQS) queue or through messaging to an HTTPS endpoint provided by the subscriber.'''
1181
1225
  return typing.cast(typing.List[builtins.str], jsii.get(self, "accessTypes"))
1182
1226
 
1183
1227
  @access_types.setter
@@ -1190,7 +1234,7 @@ class CfnSubscriber(
1190
1234
  @builtins.property
1191
1235
  @jsii.member(jsii_name="dataLakeArn")
1192
1236
  def data_lake_arn(self) -> builtins.str:
1193
- '''The ARN for the data lake.'''
1237
+ '''The Amazon Resource Name (ARN) used to create the data lake.'''
1194
1238
  return typing.cast(builtins.str, jsii.get(self, "dataLakeArn"))
1195
1239
 
1196
1240
  @data_lake_arn.setter
@@ -1205,7 +1249,7 @@ class CfnSubscriber(
1205
1249
  def sources(
1206
1250
  self,
1207
1251
  ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnSubscriber.SourceProperty"]]]:
1208
- '''The supported AWS services from which logs and events are collected.'''
1252
+ '''Amazon Security Lake supports log and event collection for natively supported AWS services .'''
1209
1253
  return typing.cast(typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnSubscriber.SourceProperty"]]], jsii.get(self, "sources"))
1210
1254
 
1211
1255
  @sources.setter
@@ -1239,7 +1283,7 @@ class CfnSubscriber(
1239
1283
  @builtins.property
1240
1284
  @jsii.member(jsii_name="subscriberName")
1241
1285
  def subscriber_name(self) -> builtins.str:
1242
- '''The name of your Security Lake subscriber account.'''
1286
+ '''The name of your Amazon Security Lake subscriber account.'''
1243
1287
  return typing.cast(builtins.str, jsii.get(self, "subscriberName"))
1244
1288
 
1245
1289
  @subscriber_name.setter
@@ -1252,7 +1296,7 @@ class CfnSubscriber(
1252
1296
  @builtins.property
1253
1297
  @jsii.member(jsii_name="subscriberDescription")
1254
1298
  def subscriber_description(self) -> typing.Optional[builtins.str]:
1255
- '''The description for your subscriber account in Security Lake.'''
1299
+ '''The subscriber descriptions for a subscriber account.'''
1256
1300
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "subscriberDescription"))
1257
1301
 
1258
1302
  @subscriber_description.setter
@@ -1287,10 +1331,12 @@ class CfnSubscriber(
1287
1331
  source_name: typing.Optional[builtins.str] = None,
1288
1332
  source_version: typing.Optional[builtins.str] = None,
1289
1333
  ) -> None:
1290
- '''Amazon Security Lake supports log and event collection for natively supported AWS services.
1334
+ '''Adds a natively supported AWS service as an Amazon Security Lake source.
1291
1335
 
1292
- :param source_name: The name for a AWS source. This must be a Regionally unique value.
1293
- :param source_version: The version for a AWS source. This must be a Regionally unique value.
1336
+ Enables source types for member accounts in required AWS Regions, based on the parameters you specify. You can choose any source type in any Region for either accounts that are part of a trusted organization or standalone accounts. Once you add an AWS service as a source, Security Lake starts collecting logs and events from it.
1337
+
1338
+ :param source_name: Source name of the natively supported AWS service that is supported as an Amazon Security Lake source. For the list of sources supported by Amazon Security Lake see `Collecting data from AWS services <https://docs.aws.amazon.com//security-lake/latest/userguide/internal-sources.html>`_ in the Amazon Security Lake User Guide.
1339
+ :param source_version: Source version of the natively supported AWS service that is supported as an Amazon Security Lake source. For more details about source versions supported by Amazon Security Lake see `OCSF source identification <https://docs.aws.amazon.com//security-lake/latest/userguide/open-cybersecurity-schema-framework.html#ocsf-source-identification>`_ in the Amazon Security Lake User Guide.
1294
1340
 
1295
1341
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-awslogsource.html
1296
1342
  :exampleMetadata: fixture=_generated
@@ -1318,9 +1364,9 @@ class CfnSubscriber(
1318
1364
 
1319
1365
  @builtins.property
1320
1366
  def source_name(self) -> typing.Optional[builtins.str]:
1321
- '''The name for a AWS source.
1367
+ '''Source name of the natively supported AWS service that is supported as an Amazon Security Lake source.
1322
1368
 
1323
- This must be a Regionally unique value.
1369
+ For the list of sources supported by Amazon Security Lake see `Collecting data from AWS services <https://docs.aws.amazon.com//security-lake/latest/userguide/internal-sources.html>`_ in the Amazon Security Lake User Guide.
1324
1370
 
1325
1371
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-awslogsource.html#cfn-securitylake-subscriber-awslogsource-sourcename
1326
1372
  '''
@@ -1329,9 +1375,9 @@ class CfnSubscriber(
1329
1375
 
1330
1376
  @builtins.property
1331
1377
  def source_version(self) -> typing.Optional[builtins.str]:
1332
- '''The version for a AWS source.
1378
+ '''Source version of the natively supported AWS service that is supported as an Amazon Security Lake source.
1333
1379
 
1334
- This must be a Regionally unique value.
1380
+ For more details about source versions supported by Amazon Security Lake see `OCSF source identification <https://docs.aws.amazon.com//security-lake/latest/userguide/open-cybersecurity-schema-framework.html#ocsf-source-identification>`_ in the Amazon Security Lake User Guide.
1335
1381
 
1336
1382
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-awslogsource.html#cfn-securitylake-subscriber-awslogsource-sourceversion
1337
1383
  '''
@@ -1361,9 +1407,12 @@ class CfnSubscriber(
1361
1407
  source_name: typing.Optional[builtins.str] = None,
1362
1408
  source_version: typing.Optional[builtins.str] = None,
1363
1409
  ) -> None:
1364
- '''
1365
- :param source_name: The name for a third-party custom source. This must be a Regionally unique value.
1366
- :param source_version: The version for a third-party custom source. This must be a Regionally unique value.
1410
+ '''Third-party custom log source that meets the requirements to be added to Amazon Security Lake .
1411
+
1412
+ For more details, see `Custom log source <https://docs.aws.amazon.com//security-lake/latest/userguide/custom-sources.html#iam-roles-custom-sources>`_ in the *Amazon Security Lake User Guide* .
1413
+
1414
+ :param source_name: The name of the custom log source.
1415
+ :param source_version: The source version of the custom log source.
1367
1416
 
1368
1417
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-customlogsource.html
1369
1418
  :exampleMetadata: fixture=_generated
@@ -1391,9 +1440,7 @@ class CfnSubscriber(
1391
1440
 
1392
1441
  @builtins.property
1393
1442
  def source_name(self) -> typing.Optional[builtins.str]:
1394
- '''The name for a third-party custom source.
1395
-
1396
- This must be a Regionally unique value.
1443
+ '''The name of the custom log source.
1397
1444
 
1398
1445
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-customlogsource.html#cfn-securitylake-subscriber-customlogsource-sourcename
1399
1446
  '''
@@ -1402,9 +1449,7 @@ class CfnSubscriber(
1402
1449
 
1403
1450
  @builtins.property
1404
1451
  def source_version(self) -> typing.Optional[builtins.str]:
1405
- '''The version for a third-party custom source.
1406
-
1407
- This must be a Regionally unique value.
1452
+ '''The source version of the custom log source.
1408
1453
 
1409
1454
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-customlogsource.html#cfn-securitylake-subscriber-customlogsource-sourceversion
1410
1455
  '''
@@ -1437,9 +1482,12 @@ class CfnSubscriber(
1437
1482
  aws_log_source: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnSubscriber.AwsLogSourceProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
1438
1483
  custom_log_source: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnSubscriber.CustomLogSourceProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
1439
1484
  ) -> None:
1440
- '''
1441
- :param aws_log_source: Amazon Security Lake supports log and event collection for natively supported AWS services.
1442
- :param custom_log_source:
1485
+ '''Sources are logs and events generated from a single system that match a specific event class in the Open Cybersecurity Schema Framework (OCSF) schema.
1486
+
1487
+ Amazon Security Lake can collect logs and events from a variety of sources, including natively supported AWS services and third-party custom sources.
1488
+
1489
+ :param aws_log_source: The natively supported AWS service which is used a Amazon Security Lake source to collect logs and events from.
1490
+ :param custom_log_source: The custom log source AWS which is used a Amazon Security Lake source to collect logs and events from.
1443
1491
 
1444
1492
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-source.html
1445
1493
  :exampleMetadata: fixture=_generated
@@ -1475,7 +1523,7 @@ class CfnSubscriber(
1475
1523
  def aws_log_source(
1476
1524
  self,
1477
1525
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnSubscriber.AwsLogSourceProperty"]]:
1478
- '''Amazon Security Lake supports log and event collection for natively supported AWS services.
1526
+ '''The natively supported AWS service which is used a Amazon Security Lake source to collect logs and events from.
1479
1527
 
1480
1528
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-source.html#cfn-securitylake-subscriber-source-awslogsource
1481
1529
  '''
@@ -1486,7 +1534,8 @@ class CfnSubscriber(
1486
1534
  def custom_log_source(
1487
1535
  self,
1488
1536
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnSubscriber.CustomLogSourceProperty"]]:
1489
- '''
1537
+ '''The custom log source AWS which is used a Amazon Security Lake source to collect logs and events from.
1538
+
1490
1539
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-source.html#cfn-securitylake-subscriber-source-customlogsource
1491
1540
  '''
1492
1541
  result = self._values.get("custom_log_source")
@@ -1515,10 +1564,10 @@ class CfnSubscriber(
1515
1564
  external_id: builtins.str,
1516
1565
  principal: builtins.str,
1517
1566
  ) -> None:
1518
- '''The AWS identity used to access your data.
1567
+ '''Specify the AWS account ID and external ID that the subscriber will use to access source data.
1519
1568
 
1520
- :param external_id: The external ID used to establish trust relationship with the AWS identity.
1521
- :param principal: The AWS identity principal.
1569
+ :param external_id: The external ID is a unique identifier that the subscriber provides to you.
1570
+ :param principal: Principals can include accounts, users, roles, federated users, or AWS services.
1522
1571
 
1523
1572
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-subscriberidentity.html
1524
1573
  :exampleMetadata: fixture=_generated
@@ -1545,7 +1594,7 @@ class CfnSubscriber(
1545
1594
 
1546
1595
  @builtins.property
1547
1596
  def external_id(self) -> builtins.str:
1548
- '''The external ID used to establish trust relationship with the AWS identity.
1597
+ '''The external ID is a unique identifier that the subscriber provides to you.
1549
1598
 
1550
1599
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-subscriberidentity.html#cfn-securitylake-subscriber-subscriberidentity-externalid
1551
1600
  '''
@@ -1555,7 +1604,7 @@ class CfnSubscriber(
1555
1604
 
1556
1605
  @builtins.property
1557
1606
  def principal(self) -> builtins.str:
1558
- '''The AWS identity principal.
1607
+ '''Principals can include accounts, users, roles, federated users, or AWS services.
1559
1608
 
1560
1609
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-securitylake-subscriber-subscriberidentity.html#cfn-securitylake-subscriber-subscriberidentity-principal
1561
1610
  '''
@@ -1602,12 +1651,12 @@ class CfnSubscriberProps:
1602
1651
  ) -> None:
1603
1652
  '''Properties for defining a ``CfnSubscriber``.
1604
1653
 
1605
- :param access_types: The Amazon S3 or AWS Lake Formation access type.
1606
- :param data_lake_arn: The ARN for the data lake.
1607
- :param sources: The supported AWS services from which logs and events are collected.
1654
+ :param access_types: You can choose to notify subscribers of new objects with an Amazon Simple Queue Service (Amazon SQS) queue or through messaging to an HTTPS endpoint provided by the subscriber. Subscribers can consume data by directly querying AWS Lake Formation tables in your Amazon S3 bucket through services like Amazon Athena. This subscription type is defined as ``LAKEFORMATION`` .
1655
+ :param data_lake_arn: The Amazon Resource Name (ARN) used to create the data lake.
1656
+ :param sources: Amazon Security Lake supports log and event collection for natively supported AWS services . For more information, see the `Amazon Security Lake User Guide <https://docs.aws.amazon.com//security-lake/latest/userguide/source-management.html>`_ .
1608
1657
  :param subscriber_identity: The AWS identity used to access your data.
1609
- :param subscriber_name: The name of your Security Lake subscriber account.
1610
- :param subscriber_description: The description for your subscriber account in Security Lake.
1658
+ :param subscriber_name: The name of your Amazon Security Lake subscriber account.
1659
+ :param subscriber_description: The subscriber descriptions for a subscriber account. The description for a subscriber includes ``subscriberName`` , ``accountID`` , ``externalID`` , and ``subscriberId`` .
1611
1660
  :param tags: An array of objects, one for each tag to associate with the subscriber. For each tag, you must specify both a tag key and a tag value. A tag value cannot be null, but it can be an empty string.
1612
1661
 
1613
1662
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-subscriber.html
@@ -1669,7 +1718,9 @@ class CfnSubscriberProps:
1669
1718
 
1670
1719
  @builtins.property
1671
1720
  def access_types(self) -> typing.List[builtins.str]:
1672
- '''The Amazon S3 or AWS Lake Formation access type.
1721
+ '''You can choose to notify subscribers of new objects with an Amazon Simple Queue Service (Amazon SQS) queue or through messaging to an HTTPS endpoint provided by the subscriber.
1722
+
1723
+ Subscribers can consume data by directly querying AWS Lake Formation tables in your Amazon S3 bucket through services like Amazon Athena. This subscription type is defined as ``LAKEFORMATION`` .
1673
1724
 
1674
1725
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-subscriber.html#cfn-securitylake-subscriber-accesstypes
1675
1726
  '''
@@ -1679,7 +1730,7 @@ class CfnSubscriberProps:
1679
1730
 
1680
1731
  @builtins.property
1681
1732
  def data_lake_arn(self) -> builtins.str:
1682
- '''The ARN for the data lake.
1733
+ '''The Amazon Resource Name (ARN) used to create the data lake.
1683
1734
 
1684
1735
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-subscriber.html#cfn-securitylake-subscriber-datalakearn
1685
1736
  '''
@@ -1691,7 +1742,9 @@ class CfnSubscriberProps:
1691
1742
  def sources(
1692
1743
  self,
1693
1744
  ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnSubscriber.SourceProperty]]]:
1694
- '''The supported AWS services from which logs and events are collected.
1745
+ '''Amazon Security Lake supports log and event collection for natively supported AWS services .
1746
+
1747
+ For more information, see the `Amazon Security Lake User Guide <https://docs.aws.amazon.com//security-lake/latest/userguide/source-management.html>`_ .
1695
1748
 
1696
1749
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-subscriber.html#cfn-securitylake-subscriber-sources
1697
1750
  '''
@@ -1713,7 +1766,7 @@ class CfnSubscriberProps:
1713
1766
 
1714
1767
  @builtins.property
1715
1768
  def subscriber_name(self) -> builtins.str:
1716
- '''The name of your Security Lake subscriber account.
1769
+ '''The name of your Amazon Security Lake subscriber account.
1717
1770
 
1718
1771
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-subscriber.html#cfn-securitylake-subscriber-subscribername
1719
1772
  '''
@@ -1723,7 +1776,9 @@ class CfnSubscriberProps:
1723
1776
 
1724
1777
  @builtins.property
1725
1778
  def subscriber_description(self) -> typing.Optional[builtins.str]:
1726
- '''The description for your subscriber account in Security Lake.
1779
+ '''The subscriber descriptions for a subscriber account.
1780
+
1781
+ The description for a subscriber includes ``subscriberName`` , ``accountID`` , ``externalID`` , and ``subscriberId`` .
1727
1782
 
1728
1783
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securitylake-subscriber.html#cfn-securitylake-subscriber-subscriberdescription
1729
1784
  '''