aws-cdk-lib 2.138.0__py3-none-any.whl → 2.139.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.
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.138.0.jsii.tgz → aws-cdk-lib@2.139.0.jsii.tgz} +0 -0
- aws_cdk/aws_apigateway/__init__.py +29 -16
- aws_cdk/aws_appconfig/__init__.py +289 -44
- aws_cdk/aws_appintegrations/__init__.py +55 -6
- aws_cdk/aws_autoscaling/__init__.py +62 -60
- aws_cdk/aws_backup/__init__.py +34 -42
- aws_cdk/aws_batch/__init__.py +9 -3
- aws_cdk/aws_bedrock/__init__.py +4144 -0
- aws_cdk/aws_cloudwatch/__init__.py +120 -0
- aws_cdk/aws_datazone/__init__.py +22 -0
- aws_cdk/aws_dms/__init__.py +2 -4
- aws_cdk/aws_ec2/__init__.py +123 -84
- aws_cdk/aws_ecr/__init__.py +630 -0
- aws_cdk/aws_ecs/__init__.py +121 -19
- aws_cdk/aws_efs/__init__.py +592 -0
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +23 -8
- aws_cdk/aws_events_targets/__init__.py +17 -4
- aws_cdk/aws_kms/__init__.py +44 -0
- aws_cdk/aws_lambda/__init__.py +9 -0
- aws_cdk/aws_oam/__init__.py +204 -0
- aws_cdk/aws_rds/__init__.py +15 -11
- aws_cdk/aws_redshiftserverless/__init__.py +157 -0
- aws_cdk/aws_securitylake/__init__.py +160 -105
- aws_cdk/aws_ses_actions/__init__.py +155 -0
- aws_cdk/aws_ssm/__init__.py +5 -2
- aws_cdk/aws_timestream/__init__.py +1045 -0
- aws_cdk/aws_transfer/__init__.py +15 -6
- aws_cdk/aws_wisdom/__init__.py +2 -2
- aws_cdk/custom_resources/__init__.py +440 -0
- aws_cdk/cx_api/__init__.py +17 -0
- {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/RECORD +37 -37
- {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.138.0.dist-info → aws_cdk_lib-2.139.0.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
|
-
'''
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
'''
|
|
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:
|
|
386
|
-
:param meta_store_manager_role_arn: The Amazon Resource Name (ARN) used to
|
|
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)
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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
|
-
'''
|
|
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
|
-
|
|
659
|
-
|
|
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
|
|
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.
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
|
|
811
|
-
|
|
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
|
-
'''
|
|
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
|
|
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:
|
|
892
|
-
:param meta_store_manager_role_arn: The Amazon Resource Name (ARN) used to
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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:
|
|
1073
|
-
:param data_lake_arn: The ARN
|
|
1074
|
-
:param sources:
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
1334
|
+
'''Adds a natively supported AWS service as an Amazon Security Lake source.
|
|
1291
1335
|
|
|
1292
|
-
|
|
1293
|
-
|
|
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
|
-
'''
|
|
1367
|
+
'''Source name of the natively supported AWS service that is supported as an Amazon Security Lake source.
|
|
1322
1368
|
|
|
1323
|
-
|
|
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
|
-
'''
|
|
1378
|
+
'''Source version of the natively supported AWS service that is supported as an Amazon Security Lake source.
|
|
1333
1379
|
|
|
1334
|
-
|
|
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
|
-
|
|
1366
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
1442
|
-
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
1521
|
-
:param 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
|
|
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
|
-
'''
|
|
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:
|
|
1606
|
-
:param data_lake_arn: The ARN
|
|
1607
|
-
:param sources:
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
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
|
-
'''
|
|
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
|
|
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
|
'''
|