aws-cdk-lib 2.125.0__py3-none-any.whl → 2.127.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/__init__.py +0 -2
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.125.0.jsii.tgz → aws-cdk-lib@2.127.0.jsii.tgz} +0 -0
- aws_cdk/aws_acmpca/__init__.py +18 -6
- aws_cdk/aws_amazonmq/__init__.py +3 -2
- aws_cdk/aws_amplifyuibuilder/__init__.py +1212 -666
- aws_cdk/aws_apigateway/__init__.py +7 -3
- aws_cdk/aws_appconfig/__init__.py +108 -19
- aws_cdk/aws_appsync/__init__.py +43 -0
- aws_cdk/aws_autoscaling/__init__.py +37 -14
- aws_cdk/aws_cassandra/__init__.py +810 -4
- aws_cdk/aws_cloudfront/__init__.py +35 -37
- aws_cdk/aws_cloudfront/experimental/__init__.py +21 -0
- aws_cdk/aws_codebuild/__init__.py +43 -3
- aws_cdk/aws_codecommit/__init__.py +1 -0
- aws_cdk/aws_codepipeline/__init__.py +7 -3
- aws_cdk/aws_codepipeline_actions/__init__.py +11 -1
- aws_cdk/aws_codestarnotifications/__init__.py +24 -15
- aws_cdk/aws_cognito/__init__.py +180 -116
- aws_cdk/aws_datasync/__init__.py +8 -4
- aws_cdk/aws_dynamodb/__init__.py +80 -11
- aws_cdk/aws_ec2/__init__.py +207 -45
- aws_cdk/aws_ecs/__init__.py +171 -78
- aws_cdk/aws_ecs_patterns/__init__.py +24 -0
- aws_cdk/aws_efs/__init__.py +64 -8
- aws_cdk/aws_eks/__init__.py +52 -41
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +12 -9
- aws_cdk/aws_fis/__init__.py +32 -12
- aws_cdk/aws_fsx/__init__.py +61 -43
- aws_cdk/aws_glue/__init__.py +449 -0
- aws_cdk/aws_guardduty/__init__.py +0 -8
- aws_cdk/aws_iam/__init__.py +3 -3
- aws_cdk/aws_inspectorv2/__init__.py +989 -0
- aws_cdk/aws_internetmonitor/__init__.py +10 -12
- aws_cdk/aws_iot/__init__.py +112 -0
- aws_cdk/aws_iotwireless/__init__.py +32 -19
- aws_cdk/aws_lambda/__init__.py +129 -32
- aws_cdk/aws_lambda_event_sources/__init__.py +95 -4
- aws_cdk/aws_lambda_nodejs/__init__.py +21 -0
- aws_cdk/aws_location/__init__.py +8 -2
- aws_cdk/aws_logs/__init__.py +7 -3
- aws_cdk/aws_networkmanager/__init__.py +1 -1
- aws_cdk/aws_opensearchserverless/__init__.py +4 -4
- aws_cdk/aws_osis/__init__.py +13 -13
- aws_cdk/aws_personalize/__init__.py +1 -1
- aws_cdk/aws_pinpoint/__init__.py +5 -5
- aws_cdk/aws_pipes/__init__.py +7 -10
- aws_cdk/aws_rds/__init__.py +449 -8
- aws_cdk/aws_redshiftserverless/__init__.py +282 -0
- aws_cdk/aws_rolesanywhere/__init__.py +53 -41
- aws_cdk/aws_route53/__init__.py +282 -0
- aws_cdk/aws_s3/__init__.py +11 -6
- aws_cdk/aws_sagemaker/__init__.py +1398 -39
- aws_cdk/aws_sns/__init__.py +56 -13
- aws_cdk/aws_sqs/__init__.py +13 -10
- aws_cdk/aws_stepfunctions/__init__.py +3612 -1395
- aws_cdk/aws_stepfunctions_tasks/__init__.py +267 -181
- aws_cdk/aws_transfer/__init__.py +1 -1
- aws_cdk/aws_verifiedpermissions/__init__.py +55 -55
- aws_cdk/aws_workspacesweb/__init__.py +6 -3
- aws_cdk/cx_api/__init__.py +17 -0
- aws_cdk/triggers/__init__.py +21 -0
- {aws_cdk_lib-2.125.0.dist-info → aws_cdk_lib-2.127.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.125.0.dist-info → aws_cdk_lib-2.127.0.dist-info}/RECORD +68 -69
- aws_cdk/aws_ssmguiconnect/__init__.py +0 -540
- {aws_cdk_lib-2.125.0.dist-info → aws_cdk_lib-2.127.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.125.0.dist-info → aws_cdk_lib-2.127.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.125.0.dist-info → aws_cdk_lib-2.127.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.125.0.dist-info → aws_cdk_lib-2.127.0.dist-info}/top_level.txt +0 -0
|
@@ -62,6 +62,8 @@ You can omit `cluster` and `vpc` to let CDK create a new VPC with two AZs and cr
|
|
|
62
62
|
|
|
63
63
|
You can customize the health check for your target group; otherwise it defaults to `HTTP` over port `80` hitting path `/`.
|
|
64
64
|
|
|
65
|
+
You can customize the health check configuration of the container via the [`healthCheck`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ecs.HealthCheck.html) property; otherwise it defaults to the health check configuration from the container.
|
|
66
|
+
|
|
65
67
|
Fargate services will use the `LATEST` platform version by default, but you can override by providing a value for the `platformVersion` property in the constructor.
|
|
66
68
|
|
|
67
69
|
Fargate services use the default VPC Security Group unless one or more are provided using the `securityGroups` property in the constructor.
|
|
@@ -8067,6 +8069,7 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8067
8069
|
id: builtins.str,
|
|
8068
8070
|
*,
|
|
8069
8071
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
8072
|
+
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8070
8073
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
8071
8074
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8072
8075
|
capacity_provider_strategies: typing.Optional[typing.Sequence[typing.Union[_CapacityProviderStrategy_8d7b6657, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
@@ -8110,6 +8113,7 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8110
8113
|
:param scope: -
|
|
8111
8114
|
:param id: -
|
|
8112
8115
|
:param assign_public_ip: Determines whether the service will be assigned a public IP address. Default: false
|
|
8116
|
+
:param health_check: The health check command and associated configuration parameters for the container. Default: - Health check configuration from container.
|
|
8113
8117
|
:param security_groups: The security groups to associate with the service. If you do not specify a security group, a new security group is created. Default: - A new security group is created.
|
|
8114
8118
|
:param task_subnets: The subnets to associate with the service. Default: - Public subnets if ``assignPublicIp`` is set, otherwise the first available one of Private, Isolated, Public, in that order.
|
|
8115
8119
|
:param capacity_provider_strategies: A list of Capacity Provider strategies used to place a service. Default: - undefined
|
|
@@ -8154,6 +8158,7 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8154
8158
|
check_type(argname="argument id", value=id, expected_type=type_hints["id"])
|
|
8155
8159
|
props = ApplicationLoadBalancedFargateServiceProps(
|
|
8156
8160
|
assign_public_ip=assign_public_ip,
|
|
8161
|
+
health_check=health_check,
|
|
8157
8162
|
security_groups=security_groups,
|
|
8158
8163
|
task_subnets=task_subnets,
|
|
8159
8164
|
capacity_provider_strategies=capacity_provider_strategies,
|
|
@@ -8256,6 +8261,7 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8256
8261
|
"runtime_platform": "runtimePlatform",
|
|
8257
8262
|
"task_definition": "taskDefinition",
|
|
8258
8263
|
"assign_public_ip": "assignPublicIp",
|
|
8264
|
+
"health_check": "healthCheck",
|
|
8259
8265
|
"security_groups": "securityGroups",
|
|
8260
8266
|
"task_subnets": "taskSubnets",
|
|
8261
8267
|
},
|
|
@@ -8303,6 +8309,7 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8303
8309
|
runtime_platform: typing.Optional[typing.Union[_RuntimePlatform_5ed98a9c, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8304
8310
|
task_definition: typing.Optional[_FargateTaskDefinition_83754b60] = None,
|
|
8305
8311
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
8312
|
+
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8306
8313
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
8307
8314
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8308
8315
|
) -> None:
|
|
@@ -8344,6 +8351,7 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8344
8351
|
:param runtime_platform: The runtime platform of the task definition. Default: - If the property is undefined, ``operatingSystemFamily`` is LINUX and ``cpuArchitecture`` is X86_64
|
|
8345
8352
|
:param task_definition: The task definition to use for tasks in the service. TaskDefinition or TaskImageOptions must be specified, but not both. [disable-awslint:ref-via-interface] Default: - none
|
|
8346
8353
|
:param assign_public_ip: Determines whether the service will be assigned a public IP address. Default: false
|
|
8354
|
+
:param health_check: The health check command and associated configuration parameters for the container. Default: - Health check configuration from container.
|
|
8347
8355
|
:param security_groups: The security groups to associate with the service. If you do not specify a security group, a new security group is created. Default: - A new security group is created.
|
|
8348
8356
|
:param task_subnets: The subnets to associate with the service. Default: - Public subnets if ``assignPublicIp`` is set, otherwise the first available one of Private, Isolated, Public, in that order.
|
|
8349
8357
|
|
|
@@ -8377,6 +8385,8 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8377
8385
|
task_image_options = ApplicationLoadBalancedTaskImageOptions(**task_image_options)
|
|
8378
8386
|
if isinstance(runtime_platform, dict):
|
|
8379
8387
|
runtime_platform = _RuntimePlatform_5ed98a9c(**runtime_platform)
|
|
8388
|
+
if isinstance(health_check, dict):
|
|
8389
|
+
health_check = _HealthCheck_6459d04f(**health_check)
|
|
8380
8390
|
if isinstance(task_subnets, dict):
|
|
8381
8391
|
task_subnets = _SubnetSelection_e57d76df(**task_subnets)
|
|
8382
8392
|
if __debug__:
|
|
@@ -8417,6 +8427,7 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8417
8427
|
check_type(argname="argument runtime_platform", value=runtime_platform, expected_type=type_hints["runtime_platform"])
|
|
8418
8428
|
check_type(argname="argument task_definition", value=task_definition, expected_type=type_hints["task_definition"])
|
|
8419
8429
|
check_type(argname="argument assign_public_ip", value=assign_public_ip, expected_type=type_hints["assign_public_ip"])
|
|
8430
|
+
check_type(argname="argument health_check", value=health_check, expected_type=type_hints["health_check"])
|
|
8420
8431
|
check_type(argname="argument security_groups", value=security_groups, expected_type=type_hints["security_groups"])
|
|
8421
8432
|
check_type(argname="argument task_subnets", value=task_subnets, expected_type=type_hints["task_subnets"])
|
|
8422
8433
|
self._values: typing.Dict[builtins.str, typing.Any] = {}
|
|
@@ -8492,6 +8503,8 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8492
8503
|
self._values["task_definition"] = task_definition
|
|
8493
8504
|
if assign_public_ip is not None:
|
|
8494
8505
|
self._values["assign_public_ip"] = assign_public_ip
|
|
8506
|
+
if health_check is not None:
|
|
8507
|
+
self._values["health_check"] = health_check
|
|
8495
8508
|
if security_groups is not None:
|
|
8496
8509
|
self._values["security_groups"] = security_groups
|
|
8497
8510
|
if task_subnets is not None:
|
|
@@ -8920,6 +8933,15 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8920
8933
|
result = self._values.get("assign_public_ip")
|
|
8921
8934
|
return typing.cast(typing.Optional[builtins.bool], result)
|
|
8922
8935
|
|
|
8936
|
+
@builtins.property
|
|
8937
|
+
def health_check(self) -> typing.Optional[_HealthCheck_6459d04f]:
|
|
8938
|
+
'''The health check command and associated configuration parameters for the container.
|
|
8939
|
+
|
|
8940
|
+
:default: - Health check configuration from container.
|
|
8941
|
+
'''
|
|
8942
|
+
result = self._values.get("health_check")
|
|
8943
|
+
return typing.cast(typing.Optional[_HealthCheck_6459d04f], result)
|
|
8944
|
+
|
|
8923
8945
|
@builtins.property
|
|
8924
8946
|
def security_groups(self) -> typing.Optional[typing.List[_ISecurityGroup_acf8a799]]:
|
|
8925
8947
|
'''The security groups to associate with the service.
|
|
@@ -16377,6 +16399,7 @@ def _typecheckingstub__52e4707f036e6b5ab8a12a1dd88ad78656d9ef102eb7d04caef957d69
|
|
|
16377
16399
|
id: builtins.str,
|
|
16378
16400
|
*,
|
|
16379
16401
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
16402
|
+
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
16380
16403
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
16381
16404
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
16382
16405
|
capacity_provider_strategies: typing.Optional[typing.Sequence[typing.Union[_CapacityProviderStrategy_8d7b6657, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
@@ -16456,6 +16479,7 @@ def _typecheckingstub__cdcb8bd483faaddad588ad37d4527fa1a0028fc2307a21fc3690044a0
|
|
|
16456
16479
|
runtime_platform: typing.Optional[typing.Union[_RuntimePlatform_5ed98a9c, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
16457
16480
|
task_definition: typing.Optional[_FargateTaskDefinition_83754b60] = None,
|
|
16458
16481
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
16482
|
+
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
16459
16483
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
16460
16484
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
16461
16485
|
) -> None:
|
aws_cdk/aws_efs/__init__.py
CHANGED
|
@@ -27,7 +27,8 @@ file_system = efs.FileSystem(self, "MyEfsFileSystem",
|
|
|
27
27
|
lifecycle_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to infrequent access (IA) storage by default
|
|
28
28
|
performance_mode=efs.PerformanceMode.GENERAL_PURPOSE, # default
|
|
29
29
|
out_of_infrequent_access_policy=efs.OutOfInfrequentAccessPolicy.AFTER_1_ACCESS, # files are not transitioned back from (infrequent access) IA to primary storage by default
|
|
30
|
-
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS
|
|
30
|
+
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to Archive by default
|
|
31
|
+
replication_overwrite_protection=efs.ReplicationOverwriteProtection.ENABLED
|
|
31
32
|
)
|
|
32
33
|
```
|
|
33
34
|
|
|
@@ -1554,7 +1555,7 @@ class CfnFileSystem(
|
|
|
1554
1555
|
:param file_system_tags: Use to create one or more tags associated with the file system. Each tag is a user-defined key-value pair. Name your file system on creation by including a ``"Key":"Name","Value":"{value}"`` key-value pair. Each key must be unique. For more information, see `Tagging AWS resources <https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html>`_ in the *AWS General Reference Guide* .
|
|
1555
1556
|
:param kms_key_id: The ID of the AWS KMS key to be used to protect the encrypted file system. This parameter is only required if you want to use a nondefault KMS key . If this parameter is not specified, the default KMS key for Amazon EFS is used. This ID can be in one of the following formats: - Key ID - A unique identifier of the key, for example ``1234abcd-12ab-34cd-56ef-1234567890ab`` . - ARN - An Amazon Resource Name (ARN) for the key, for example ``arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`` . - Key alias - A previously created display name for a key, for example ``alias/projectKey1`` . - Key alias ARN - An ARN for a key alias, for example ``arn:aws:kms:us-west-2:444455556666:alias/projectKey1`` . If ``KmsKeyId`` is specified, the ``Encrypted`` parameter must be set to true.
|
|
1556
1557
|
:param lifecycle_policies: An array of ``LifecyclePolicy`` objects that define the file system's ``LifecycleConfiguration`` object. A ``LifecycleConfiguration`` object informs Lifecycle management of the following: - When to move files in the file system from primary storage to IA storage. - When to move files in the file system from primary storage or IA storage to Archive storage. - When to move files that are in IA or Archive storage to primary storage. .. epigraph:: Amazon EFS requires that each ``LifecyclePolicy`` object have only a single transition. This means that in a request body, ``LifecyclePolicies`` needs to be structured as an array of ``LifecyclePolicy`` objects, one object for each transition, ``TransitionToIA`` , ``TransitionToArchive`` ``TransitionToPrimaryStorageClass`` . See the example requests in the following section for more information.
|
|
1557
|
-
:param performance_mode: The
|
|
1558
|
+
:param performance_mode: The performance mode of the file system. We recommend ``generalPurpose`` performance mode for all file systems. File systems using the ``maxIO`` performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. The performance mode can't be changed after the file system has been created. The ``maxIO`` mode is not supported on One Zone file systems. .. epigraph:: Due to the higher per-operation latencies with Max I/O, we recommend using General Purpose performance mode for all file systems. Default is ``generalPurpose`` .
|
|
1558
1559
|
:param provisioned_throughput_in_mibps: The throughput, measured in mebibytes per second (MiBps), that you want to provision for a file system that you're creating. Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact AWS Support . For more information, see `Amazon EFS quotas that you can increase <https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits>`_ in the *Amazon EFS User Guide* .
|
|
1559
1560
|
:param replication_configuration: Describes the replication configuration for a specific file system.
|
|
1560
1561
|
:param throughput_mode: Specifies the throughput mode for the file system. The mode can be ``bursting`` , ``provisioned`` , or ``elastic`` . If you set ``ThroughputMode`` to ``provisioned`` , you must also set a value for ``ProvisionedThroughputInMibps`` . After you create the file system, you can decrease your file system's Provisioned throughput or change between the throughput modes, with certain time restrictions. For more information, see `Specifying throughput with provisioned mode <https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput>`_ in the *Amazon EFS User Guide* . Default is ``bursting`` .
|
|
@@ -1794,7 +1795,7 @@ class CfnFileSystem(
|
|
|
1794
1795
|
@builtins.property
|
|
1795
1796
|
@jsii.member(jsii_name="performanceMode")
|
|
1796
1797
|
def performance_mode(self) -> typing.Optional[builtins.str]:
|
|
1797
|
-
'''The
|
|
1798
|
+
'''The performance mode of the file system.'''
|
|
1798
1799
|
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "performanceMode"))
|
|
1799
1800
|
|
|
1800
1801
|
@performance_mode.setter
|
|
@@ -2367,7 +2368,7 @@ class CfnFileSystemProps:
|
|
|
2367
2368
|
:param file_system_tags: Use to create one or more tags associated with the file system. Each tag is a user-defined key-value pair. Name your file system on creation by including a ``"Key":"Name","Value":"{value}"`` key-value pair. Each key must be unique. For more information, see `Tagging AWS resources <https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html>`_ in the *AWS General Reference Guide* .
|
|
2368
2369
|
:param kms_key_id: The ID of the AWS KMS key to be used to protect the encrypted file system. This parameter is only required if you want to use a nondefault KMS key . If this parameter is not specified, the default KMS key for Amazon EFS is used. This ID can be in one of the following formats: - Key ID - A unique identifier of the key, for example ``1234abcd-12ab-34cd-56ef-1234567890ab`` . - ARN - An Amazon Resource Name (ARN) for the key, for example ``arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`` . - Key alias - A previously created display name for a key, for example ``alias/projectKey1`` . - Key alias ARN - An ARN for a key alias, for example ``arn:aws:kms:us-west-2:444455556666:alias/projectKey1`` . If ``KmsKeyId`` is specified, the ``Encrypted`` parameter must be set to true.
|
|
2369
2370
|
:param lifecycle_policies: An array of ``LifecyclePolicy`` objects that define the file system's ``LifecycleConfiguration`` object. A ``LifecycleConfiguration`` object informs Lifecycle management of the following: - When to move files in the file system from primary storage to IA storage. - When to move files in the file system from primary storage or IA storage to Archive storage. - When to move files that are in IA or Archive storage to primary storage. .. epigraph:: Amazon EFS requires that each ``LifecyclePolicy`` object have only a single transition. This means that in a request body, ``LifecyclePolicies`` needs to be structured as an array of ``LifecyclePolicy`` objects, one object for each transition, ``TransitionToIA`` , ``TransitionToArchive`` ``TransitionToPrimaryStorageClass`` . See the example requests in the following section for more information.
|
|
2370
|
-
:param performance_mode: The
|
|
2371
|
+
:param performance_mode: The performance mode of the file system. We recommend ``generalPurpose`` performance mode for all file systems. File systems using the ``maxIO`` performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. The performance mode can't be changed after the file system has been created. The ``maxIO`` mode is not supported on One Zone file systems. .. epigraph:: Due to the higher per-operation latencies with Max I/O, we recommend using General Purpose performance mode for all file systems. Default is ``generalPurpose`` .
|
|
2371
2372
|
:param provisioned_throughput_in_mibps: The throughput, measured in mebibytes per second (MiBps), that you want to provision for a file system that you're creating. Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact AWS Support . For more information, see `Amazon EFS quotas that you can increase <https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits>`_ in the *Amazon EFS User Guide* .
|
|
2372
2373
|
:param replication_configuration: Describes the replication configuration for a specific file system.
|
|
2373
2374
|
:param throughput_mode: Specifies the throughput mode for the file system. The mode can be ``bursting`` , ``provisioned`` , or ``elastic`` . If you set ``ThroughputMode`` to ``provisioned`` , you must also set a value for ``ProvisionedThroughputInMibps`` . After you create the file system, you can decrease your file system's Provisioned throughput or change between the throughput modes, with certain time restrictions. For more information, see `Specifying throughput with provisioned mode <https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput>`_ in the *Amazon EFS User Guide* . Default is ``bursting`` .
|
|
@@ -2587,7 +2588,7 @@ class CfnFileSystemProps:
|
|
|
2587
2588
|
|
|
2588
2589
|
@builtins.property
|
|
2589
2590
|
def performance_mode(self) -> typing.Optional[builtins.str]:
|
|
2590
|
-
'''The
|
|
2591
|
+
'''The performance mode of the file system.
|
|
2591
2592
|
|
|
2592
2593
|
We recommend ``generalPurpose`` performance mode for all file systems. File systems using the ``maxIO`` performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. The performance mode can't be changed after the file system has been created. The ``maxIO`` mode is not supported on One Zone file systems.
|
|
2593
2594
|
.. epigraph::
|
|
@@ -3036,6 +3037,7 @@ class FileSystemAttributes:
|
|
|
3036
3037
|
"performance_mode": "performanceMode",
|
|
3037
3038
|
"provisioned_throughput_per_second": "provisionedThroughputPerSecond",
|
|
3038
3039
|
"removal_policy": "removalPolicy",
|
|
3040
|
+
"replication_overwrite_protection": "replicationOverwriteProtection",
|
|
3039
3041
|
"security_group": "securityGroup",
|
|
3040
3042
|
"throughput_mode": "throughputMode",
|
|
3041
3043
|
"transition_to_archive_policy": "transitionToArchivePolicy",
|
|
@@ -3059,6 +3061,7 @@ class FileSystemProps:
|
|
|
3059
3061
|
performance_mode: typing.Optional["PerformanceMode"] = None,
|
|
3060
3062
|
provisioned_throughput_per_second: typing.Optional[_Size_7b441c34] = None,
|
|
3061
3063
|
removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
|
|
3064
|
+
replication_overwrite_protection: typing.Optional["ReplicationOverwriteProtection"] = None,
|
|
3062
3065
|
security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
|
|
3063
3066
|
throughput_mode: typing.Optional["ThroughputMode"] = None,
|
|
3064
3067
|
transition_to_archive_policy: typing.Optional["LifecyclePolicy"] = None,
|
|
@@ -3079,6 +3082,7 @@ class FileSystemProps:
|
|
|
3079
3082
|
:param performance_mode: The performance mode that the file system will operate under. An Amazon EFS file system's performance mode can't be changed after the file system has been created. Updating this property will replace the file system. Default: PerformanceMode.GENERAL_PURPOSE
|
|
3080
3083
|
:param provisioned_throughput_per_second: Provisioned throughput for the file system. This is a required property if the throughput mode is set to PROVISIONED. Must be at least 1MiB/s. Default: - none, errors out
|
|
3081
3084
|
:param removal_policy: The removal policy to apply to the file system. Default: RemovalPolicy.RETAIN
|
|
3085
|
+
:param replication_overwrite_protection: Whether to enable the filesystem's replication overwrite protection or not. Set false if you want to create a read-only filesystem for use as a replication destination. Default: ReplicationOverwriteProtection.ENABLED
|
|
3082
3086
|
:param security_group: Security Group to assign to this file system. Default: - creates new security group which allows all outbound traffic
|
|
3083
3087
|
:param throughput_mode: Enum to mention the throughput mode of the file system. Default: ThroughputMode.BURSTING
|
|
3084
3088
|
:param transition_to_archive_policy: The number of days after files were last accessed in primary storage (the Standard storage class) at which to move them to Archive storage. Metadata operations such as listing the contents of a directory don't count as file access events. Default: - None. EFS will not transition files to Archive storage class.
|
|
@@ -3118,6 +3122,7 @@ class FileSystemProps:
|
|
|
3118
3122
|
check_type(argname="argument performance_mode", value=performance_mode, expected_type=type_hints["performance_mode"])
|
|
3119
3123
|
check_type(argname="argument provisioned_throughput_per_second", value=provisioned_throughput_per_second, expected_type=type_hints["provisioned_throughput_per_second"])
|
|
3120
3124
|
check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
|
|
3125
|
+
check_type(argname="argument replication_overwrite_protection", value=replication_overwrite_protection, expected_type=type_hints["replication_overwrite_protection"])
|
|
3121
3126
|
check_type(argname="argument security_group", value=security_group, expected_type=type_hints["security_group"])
|
|
3122
3127
|
check_type(argname="argument throughput_mode", value=throughput_mode, expected_type=type_hints["throughput_mode"])
|
|
3123
3128
|
check_type(argname="argument transition_to_archive_policy", value=transition_to_archive_policy, expected_type=type_hints["transition_to_archive_policy"])
|
|
@@ -3149,6 +3154,8 @@ class FileSystemProps:
|
|
|
3149
3154
|
self._values["provisioned_throughput_per_second"] = provisioned_throughput_per_second
|
|
3150
3155
|
if removal_policy is not None:
|
|
3151
3156
|
self._values["removal_policy"] = removal_policy
|
|
3157
|
+
if replication_overwrite_protection is not None:
|
|
3158
|
+
self._values["replication_overwrite_protection"] = replication_overwrite_protection
|
|
3152
3159
|
if security_group is not None:
|
|
3153
3160
|
self._values["security_group"] = security_group
|
|
3154
3161
|
if throughput_mode is not None:
|
|
@@ -3294,6 +3301,21 @@ class FileSystemProps:
|
|
|
3294
3301
|
result = self._values.get("removal_policy")
|
|
3295
3302
|
return typing.cast(typing.Optional[_RemovalPolicy_9f93c814], result)
|
|
3296
3303
|
|
|
3304
|
+
@builtins.property
|
|
3305
|
+
def replication_overwrite_protection(
|
|
3306
|
+
self,
|
|
3307
|
+
) -> typing.Optional["ReplicationOverwriteProtection"]:
|
|
3308
|
+
'''Whether to enable the filesystem's replication overwrite protection or not.
|
|
3309
|
+
|
|
3310
|
+
Set false if you want to create a read-only filesystem for use as a replication destination.
|
|
3311
|
+
|
|
3312
|
+
:default: ReplicationOverwriteProtection.ENABLED
|
|
3313
|
+
|
|
3314
|
+
:see: https://docs.aws.amazon.com/efs/latest/ug/replication-use-cases.html#replicate-existing-destination
|
|
3315
|
+
'''
|
|
3316
|
+
result = self._values.get("replication_overwrite_protection")
|
|
3317
|
+
return typing.cast(typing.Optional["ReplicationOverwriteProtection"], result)
|
|
3318
|
+
|
|
3297
3319
|
@builtins.property
|
|
3298
3320
|
def security_group(self) -> typing.Optional[_ISecurityGroup_acf8a799]:
|
|
3299
3321
|
'''Security Group to assign to this file system.
|
|
@@ -3578,7 +3600,8 @@ class LifecyclePolicy(enum.Enum):
|
|
|
3578
3600
|
lifecycle_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to infrequent access (IA) storage by default
|
|
3579
3601
|
performance_mode=efs.PerformanceMode.GENERAL_PURPOSE, # default
|
|
3580
3602
|
out_of_infrequent_access_policy=efs.OutOfInfrequentAccessPolicy.AFTER_1_ACCESS, # files are not transitioned back from (infrequent access) IA to primary storage by default
|
|
3581
|
-
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS
|
|
3603
|
+
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to Archive by default
|
|
3604
|
+
replication_overwrite_protection=efs.ReplicationOverwriteProtection.ENABLED
|
|
3582
3605
|
)
|
|
3583
3606
|
'''
|
|
3584
3607
|
|
|
@@ -3616,7 +3639,8 @@ class OutOfInfrequentAccessPolicy(enum.Enum):
|
|
|
3616
3639
|
lifecycle_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to infrequent access (IA) storage by default
|
|
3617
3640
|
performance_mode=efs.PerformanceMode.GENERAL_PURPOSE, # default
|
|
3618
3641
|
out_of_infrequent_access_policy=efs.OutOfInfrequentAccessPolicy.AFTER_1_ACCESS, # files are not transitioned back from (infrequent access) IA to primary storage by default
|
|
3619
|
-
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS
|
|
3642
|
+
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to Archive by default
|
|
3643
|
+
replication_overwrite_protection=efs.ReplicationOverwriteProtection.ENABLED
|
|
3620
3644
|
)
|
|
3621
3645
|
'''
|
|
3622
3646
|
|
|
@@ -3638,7 +3662,8 @@ class PerformanceMode(enum.Enum):
|
|
|
3638
3662
|
lifecycle_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to infrequent access (IA) storage by default
|
|
3639
3663
|
performance_mode=efs.PerformanceMode.GENERAL_PURPOSE, # default
|
|
3640
3664
|
out_of_infrequent_access_policy=efs.OutOfInfrequentAccessPolicy.AFTER_1_ACCESS, # files are not transitioned back from (infrequent access) IA to primary storage by default
|
|
3641
|
-
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS
|
|
3665
|
+
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to Archive by default
|
|
3666
|
+
replication_overwrite_protection=efs.ReplicationOverwriteProtection.ENABLED
|
|
3642
3667
|
)
|
|
3643
3668
|
'''
|
|
3644
3669
|
|
|
@@ -3763,6 +3788,31 @@ class PosixUser:
|
|
|
3763
3788
|
)
|
|
3764
3789
|
|
|
3765
3790
|
|
|
3791
|
+
@jsii.enum(jsii_type="aws-cdk-lib.aws_efs.ReplicationOverwriteProtection")
|
|
3792
|
+
class ReplicationOverwriteProtection(enum.Enum):
|
|
3793
|
+
'''The status of the file system's replication overwrite protection.
|
|
3794
|
+
|
|
3795
|
+
:see: https://docs.aws.amazon.com/ja_jp/AWSCloudFormation/latest/UserGuide/aws-properties-efs-filesystem-filesystemprotection.html
|
|
3796
|
+
:exampleMetadata: infused
|
|
3797
|
+
|
|
3798
|
+
Example::
|
|
3799
|
+
|
|
3800
|
+
file_system = efs.FileSystem(self, "MyEfsFileSystem",
|
|
3801
|
+
vpc=ec2.Vpc(self, "VPC"),
|
|
3802
|
+
lifecycle_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to infrequent access (IA) storage by default
|
|
3803
|
+
performance_mode=efs.PerformanceMode.GENERAL_PURPOSE, # default
|
|
3804
|
+
out_of_infrequent_access_policy=efs.OutOfInfrequentAccessPolicy.AFTER_1_ACCESS, # files are not transitioned back from (infrequent access) IA to primary storage by default
|
|
3805
|
+
transition_to_archive_policy=efs.LifecyclePolicy.AFTER_14_DAYS, # files are not transitioned to Archive by default
|
|
3806
|
+
replication_overwrite_protection=efs.ReplicationOverwriteProtection.ENABLED
|
|
3807
|
+
)
|
|
3808
|
+
'''
|
|
3809
|
+
|
|
3810
|
+
ENABLED = "ENABLED"
|
|
3811
|
+
'''Enable the filesystem's replication overwrite protection.'''
|
|
3812
|
+
DISABLED = "DISABLED"
|
|
3813
|
+
'''Disable the filesystem's replication overwrite protection.'''
|
|
3814
|
+
|
|
3815
|
+
|
|
3766
3816
|
@jsii.enum(jsii_type="aws-cdk-lib.aws_efs.ThroughputMode")
|
|
3767
3817
|
class ThroughputMode(enum.Enum):
|
|
3768
3818
|
'''EFS Throughput mode.
|
|
@@ -3957,6 +4007,7 @@ class FileSystem(
|
|
|
3957
4007
|
performance_mode: typing.Optional[PerformanceMode] = None,
|
|
3958
4008
|
provisioned_throughput_per_second: typing.Optional[_Size_7b441c34] = None,
|
|
3959
4009
|
removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
|
|
4010
|
+
replication_overwrite_protection: typing.Optional[ReplicationOverwriteProtection] = None,
|
|
3960
4011
|
security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
|
|
3961
4012
|
throughput_mode: typing.Optional[ThroughputMode] = None,
|
|
3962
4013
|
transition_to_archive_policy: typing.Optional[LifecyclePolicy] = None,
|
|
@@ -3979,6 +4030,7 @@ class FileSystem(
|
|
|
3979
4030
|
:param performance_mode: The performance mode that the file system will operate under. An Amazon EFS file system's performance mode can't be changed after the file system has been created. Updating this property will replace the file system. Default: PerformanceMode.GENERAL_PURPOSE
|
|
3980
4031
|
:param provisioned_throughput_per_second: Provisioned throughput for the file system. This is a required property if the throughput mode is set to PROVISIONED. Must be at least 1MiB/s. Default: - none, errors out
|
|
3981
4032
|
:param removal_policy: The removal policy to apply to the file system. Default: RemovalPolicy.RETAIN
|
|
4033
|
+
:param replication_overwrite_protection: Whether to enable the filesystem's replication overwrite protection or not. Set false if you want to create a read-only filesystem for use as a replication destination. Default: ReplicationOverwriteProtection.ENABLED
|
|
3982
4034
|
:param security_group: Security Group to assign to this file system. Default: - creates new security group which allows all outbound traffic
|
|
3983
4035
|
:param throughput_mode: Enum to mention the throughput mode of the file system. Default: ThroughputMode.BURSTING
|
|
3984
4036
|
:param transition_to_archive_policy: The number of days after files were last accessed in primary storage (the Standard storage class) at which to move them to Archive storage. Metadata operations such as listing the contents of a directory don't count as file access events. Default: - None. EFS will not transition files to Archive storage class.
|
|
@@ -4002,6 +4054,7 @@ class FileSystem(
|
|
|
4002
4054
|
performance_mode=performance_mode,
|
|
4003
4055
|
provisioned_throughput_per_second=provisioned_throughput_per_second,
|
|
4004
4056
|
removal_policy=removal_policy,
|
|
4057
|
+
replication_overwrite_protection=replication_overwrite_protection,
|
|
4005
4058
|
security_group=security_group,
|
|
4006
4059
|
throughput_mode=throughput_mode,
|
|
4007
4060
|
transition_to_archive_policy=transition_to_archive_policy,
|
|
@@ -4192,6 +4245,7 @@ __all__ = [
|
|
|
4192
4245
|
"OutOfInfrequentAccessPolicy",
|
|
4193
4246
|
"PerformanceMode",
|
|
4194
4247
|
"PosixUser",
|
|
4248
|
+
"ReplicationOverwriteProtection",
|
|
4195
4249
|
"ThroughputMode",
|
|
4196
4250
|
]
|
|
4197
4251
|
|
|
@@ -4594,6 +4648,7 @@ def _typecheckingstub__a11d59607a7c01a190b2b0587733658cfcb8eddfb252f3c48abdc988b
|
|
|
4594
4648
|
performance_mode: typing.Optional[PerformanceMode] = None,
|
|
4595
4649
|
provisioned_throughput_per_second: typing.Optional[_Size_7b441c34] = None,
|
|
4596
4650
|
removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
|
|
4651
|
+
replication_overwrite_protection: typing.Optional[ReplicationOverwriteProtection] = None,
|
|
4597
4652
|
security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
|
|
4598
4653
|
throughput_mode: typing.Optional[ThroughputMode] = None,
|
|
4599
4654
|
transition_to_archive_policy: typing.Optional[LifecyclePolicy] = None,
|
|
@@ -4684,6 +4739,7 @@ def _typecheckingstub__fe7547e76a3f3502ef6c67d1cc851b25d13fe1b4b980d3bccee8eae2f
|
|
|
4684
4739
|
performance_mode: typing.Optional[PerformanceMode] = None,
|
|
4685
4740
|
provisioned_throughput_per_second: typing.Optional[_Size_7b441c34] = None,
|
|
4686
4741
|
removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
|
|
4742
|
+
replication_overwrite_protection: typing.Optional[ReplicationOverwriteProtection] = None,
|
|
4687
4743
|
security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
|
|
4688
4744
|
throughput_mode: typing.Optional[ThroughputMode] = None,
|
|
4689
4745
|
transition_to_archive_policy: typing.Optional[LifecyclePolicy] = None,
|