aws-cdk-lib 2.189.1__py3-none-any.whl → 2.191.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.189.1.jsii.tgz → aws-cdk-lib@2.191.0.jsii.tgz} +0 -0
- aws_cdk/aws_acmpca/__init__.py +6 -6
- aws_cdk/aws_apigateway/__init__.py +18 -1
- aws_cdk/aws_apigatewayv2/__init__.py +374 -6
- aws_cdk/aws_applicationautoscaling/__init__.py +16 -10
- aws_cdk/aws_applicationsignals/__init__.py +204 -31
- aws_cdk/aws_aps/__init__.py +383 -2
- aws_cdk/aws_backup/__init__.py +0 -41
- aws_cdk/aws_batch/__init__.py +242 -5
- aws_cdk/aws_bedrock/__init__.py +963 -41
- aws_cdk/aws_cleanrooms/__init__.py +1392 -78
- aws_cdk/aws_cloudfront/__init__.py +1 -0
- aws_cdk/aws_cloudtrail/__init__.py +24 -26
- aws_cdk/aws_codebuild/__init__.py +107 -7
- aws_cdk/aws_datazone/__init__.py +23 -1
- aws_cdk/aws_dms/__init__.py +43 -0
- aws_cdk/aws_ec2/__init__.py +364 -30
- aws_cdk/aws_ecs/__init__.py +36 -5
- aws_cdk/aws_eks/__init__.py +2 -100
- aws_cdk/aws_elasticache/__init__.py +6 -11
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +341 -0
- aws_cdk/aws_events/__init__.py +106 -13
- aws_cdk/aws_fsx/__init__.py +9 -21
- aws_cdk/aws_iam/__init__.py +1 -1
- aws_cdk/aws_iot/__init__.py +6 -6
- aws_cdk/aws_kafkaconnect/__init__.py +2 -2
- aws_cdk/aws_kinesis/__init__.py +44 -0
- aws_cdk/aws_launchwizard/__init__.py +49 -49
- aws_cdk/aws_lex/__init__.py +615 -39
- aws_cdk/aws_location/__init__.py +4 -4
- aws_cdk/aws_macie/__init__.py +14 -3
- aws_cdk/aws_memorydb/__init__.py +87 -0
- aws_cdk/aws_msk/__init__.py +226 -127
- aws_cdk/aws_neptune/__init__.py +0 -24
- aws_cdk/aws_opensearchservice/__init__.py +64 -56
- aws_cdk/aws_paymentcryptography/__init__.py +41 -0
- aws_cdk/aws_qbusiness/__init__.py +175 -3
- aws_cdk/aws_quicksight/__init__.py +393 -0
- aws_cdk/aws_rds/__init__.py +149 -120
- aws_cdk/aws_redshiftserverless/__init__.py +4 -14
- aws_cdk/aws_route53resolver/__init__.py +60 -9
- aws_cdk/aws_s3/__init__.py +34 -1
- aws_cdk/aws_s3_deployment/__init__.py +202 -5
- aws_cdk/aws_s3tables/__init__.py +142 -1
- aws_cdk/aws_sagemaker/__init__.py +40 -40
- aws_cdk/aws_ses/__init__.py +643 -18
- aws_cdk/aws_ssmquicksetup/__init__.py +3 -3
- aws_cdk/aws_stepfunctions/__init__.py +720 -45
- aws_cdk/aws_transfer/__init__.py +55 -2
- aws_cdk/pipelines/__init__.py +1 -2
- {aws_cdk_lib-2.189.1.dist-info → aws_cdk_lib-2.191.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.189.1.dist-info → aws_cdk_lib-2.191.0.dist-info}/RECORD +57 -57
- {aws_cdk_lib-2.189.1.dist-info → aws_cdk_lib-2.191.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.189.1.dist-info → aws_cdk_lib-2.191.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.189.1.dist-info → aws_cdk_lib-2.191.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.189.1.dist-info → aws_cdk_lib-2.191.0.dist-info}/top_level.txt +0 -0
aws_cdk/aws_rds/__init__.py
CHANGED
|
@@ -1789,6 +1789,26 @@ rds.DatabaseCluster(self, "Cluster",
|
|
|
1789
1789
|
)
|
|
1790
1790
|
```
|
|
1791
1791
|
|
|
1792
|
+
## Importing existing DatabaseInstance
|
|
1793
|
+
|
|
1794
|
+
### Lookup DatabaseInstance by instanceIdentifier
|
|
1795
|
+
|
|
1796
|
+
You can lookup an existing DatabaseInstance by its instanceIdentifier using `DatabaseInstance.fromLookup()`. This method returns an `IDatabaseInstance`.
|
|
1797
|
+
|
|
1798
|
+
Here's how `DatabaseInstance.fromLookup()` can be used:
|
|
1799
|
+
|
|
1800
|
+
```python
|
|
1801
|
+
# my_user_role: iam.Role
|
|
1802
|
+
|
|
1803
|
+
|
|
1804
|
+
db_from_lookup = rds.DatabaseInstance.from_lookup(self, "dbFromLookup",
|
|
1805
|
+
instance_identifier="instanceId"
|
|
1806
|
+
)
|
|
1807
|
+
|
|
1808
|
+
# Grant a connection
|
|
1809
|
+
db_from_lookup.grant_connect(my_user_role, "my-user-id")
|
|
1810
|
+
```
|
|
1811
|
+
|
|
1792
1812
|
## Limitless Database Cluster
|
|
1793
1813
|
|
|
1794
1814
|
Amazon Aurora [PostgreSQL Limitless Database](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/limitless.html) provides automated horizontal scaling to process millions of write transactions per second and manages petabytes of data while maintaining the simplicity of operating inside a single database.
|
|
@@ -2901,6 +2921,12 @@ class AuroraMysqlEngineVersion(
|
|
|
2901
2921
|
'''Version "5.7.mysql_aurora.2.12.3".'''
|
|
2902
2922
|
return typing.cast("AuroraMysqlEngineVersion", jsii.sget(cls, "VER_2_12_3"))
|
|
2903
2923
|
|
|
2924
|
+
@jsii.python.classproperty
|
|
2925
|
+
@jsii.member(jsii_name="VER_2_12_4")
|
|
2926
|
+
def VER_2_12_4(cls) -> "AuroraMysqlEngineVersion":
|
|
2927
|
+
'''Version "5.7.mysql_aurora.2.12.4".'''
|
|
2928
|
+
return typing.cast("AuroraMysqlEngineVersion", jsii.sget(cls, "VER_2_12_4"))
|
|
2929
|
+
|
|
2904
2930
|
@jsii.python.classproperty
|
|
2905
2931
|
@jsii.member(jsii_name="VER_3_01_0")
|
|
2906
2932
|
def VER_3_01_0(cls) -> "AuroraMysqlEngineVersion":
|
|
@@ -3099,6 +3125,12 @@ class AuroraMysqlEngineVersion(
|
|
|
3099
3125
|
'''Version "8.0.mysql_aurora.3.08.1".'''
|
|
3100
3126
|
return typing.cast("AuroraMysqlEngineVersion", jsii.sget(cls, "VER_3_08_1"))
|
|
3101
3127
|
|
|
3128
|
+
@jsii.python.classproperty
|
|
3129
|
+
@jsii.member(jsii_name="VER_3_08_2")
|
|
3130
|
+
def VER_3_08_2(cls) -> "AuroraMysqlEngineVersion":
|
|
3131
|
+
'''Version "8.0.mysql_aurora.3.08.2".'''
|
|
3132
|
+
return typing.cast("AuroraMysqlEngineVersion", jsii.sget(cls, "VER_3_08_2"))
|
|
3133
|
+
|
|
3102
3134
|
@jsii.python.classproperty
|
|
3103
3135
|
@jsii.member(jsii_name="VER_5_7_12")
|
|
3104
3136
|
def VER_5_7_12(cls) -> "AuroraMysqlEngineVersion":
|
|
@@ -3822,6 +3854,12 @@ class AuroraPostgresEngineVersion(
|
|
|
3822
3854
|
'''Version "13.18".'''
|
|
3823
3855
|
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_13_18"))
|
|
3824
3856
|
|
|
3857
|
+
@jsii.python.classproperty
|
|
3858
|
+
@jsii.member(jsii_name="VER_13_20")
|
|
3859
|
+
def VER_13_20(cls) -> "AuroraPostgresEngineVersion":
|
|
3860
|
+
'''Version "13.20".'''
|
|
3861
|
+
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_13_20"))
|
|
3862
|
+
|
|
3825
3863
|
@jsii.python.classproperty
|
|
3826
3864
|
@jsii.member(jsii_name="VER_13_3")
|
|
3827
3865
|
def VER_13_3(cls) -> "AuroraPostgresEngineVersion":
|
|
@@ -3920,6 +3958,12 @@ class AuroraPostgresEngineVersion(
|
|
|
3920
3958
|
'''Version "14.15".'''
|
|
3921
3959
|
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_14_15"))
|
|
3922
3960
|
|
|
3961
|
+
@jsii.python.classproperty
|
|
3962
|
+
@jsii.member(jsii_name="VER_14_17")
|
|
3963
|
+
def VER_14_17(cls) -> "AuroraPostgresEngineVersion":
|
|
3964
|
+
'''Version "14.17".'''
|
|
3965
|
+
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_14_17"))
|
|
3966
|
+
|
|
3923
3967
|
@jsii.python.classproperty
|
|
3924
3968
|
@jsii.member(jsii_name="VER_14_3")
|
|
3925
3969
|
def VER_14_3(cls) -> "AuroraPostgresEngineVersion":
|
|
@@ -3968,6 +4012,12 @@ class AuroraPostgresEngineVersion(
|
|
|
3968
4012
|
'''Version "15.10".'''
|
|
3969
4013
|
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_15_10"))
|
|
3970
4014
|
|
|
4015
|
+
@jsii.python.classproperty
|
|
4016
|
+
@jsii.member(jsii_name="VER_15_12")
|
|
4017
|
+
def VER_15_12(cls) -> "AuroraPostgresEngineVersion":
|
|
4018
|
+
'''Version "15.12".'''
|
|
4019
|
+
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_15_12"))
|
|
4020
|
+
|
|
3971
4021
|
@jsii.python.classproperty
|
|
3972
4022
|
@jsii.member(jsii_name="VER_15_2")
|
|
3973
4023
|
def VER_15_2(cls) -> "AuroraPostgresEngineVersion":
|
|
@@ -4075,6 +4125,12 @@ class AuroraPostgresEngineVersion(
|
|
|
4075
4125
|
'''Version "16.6 limitless".'''
|
|
4076
4126
|
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_16_6_LIMITLESS"))
|
|
4077
4127
|
|
|
4128
|
+
@jsii.python.classproperty
|
|
4129
|
+
@jsii.member(jsii_name="VER_16_8")
|
|
4130
|
+
def VER_16_8(cls) -> "AuroraPostgresEngineVersion":
|
|
4131
|
+
'''Version "16.8".'''
|
|
4132
|
+
return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_16_8"))
|
|
4133
|
+
|
|
4078
4134
|
@jsii.python.classproperty
|
|
4079
4135
|
@jsii.member(jsii_name="VER_17_1")
|
|
4080
4136
|
def VER_17_1(cls) -> "AuroraPostgresEngineVersion":
|
|
@@ -8818,10 +8874,6 @@ class CfnDBInstance(
|
|
|
8818
8874
|
availability_zone="availabilityZone",
|
|
8819
8875
|
backup_retention_period=123,
|
|
8820
8876
|
ca_certificate_identifier="caCertificateIdentifier",
|
|
8821
|
-
certificate_details=rds.CfnDBInstance.CertificateDetailsProperty(
|
|
8822
|
-
ca_identifier="caIdentifier",
|
|
8823
|
-
valid_till="validTill"
|
|
8824
|
-
),
|
|
8825
8877
|
certificate_rotation_restart=False,
|
|
8826
8878
|
character_set_name="characterSetName",
|
|
8827
8879
|
copy_tags_to_snapshot=False,
|
|
@@ -8848,11 +8900,6 @@ class CfnDBInstance(
|
|
|
8848
8900
|
enable_cloudwatch_logs_exports=["enableCloudwatchLogsExports"],
|
|
8849
8901
|
enable_iam_database_authentication=False,
|
|
8850
8902
|
enable_performance_insights=False,
|
|
8851
|
-
endpoint=rds.CfnDBInstance.EndpointProperty(
|
|
8852
|
-
address="address",
|
|
8853
|
-
hosted_zone_id="hostedZoneId",
|
|
8854
|
-
port="port"
|
|
8855
|
-
),
|
|
8856
8903
|
engine="engine",
|
|
8857
8904
|
engine_lifecycle_support="engineLifecycleSupport",
|
|
8858
8905
|
engine_version="engineVersion",
|
|
@@ -8923,7 +8970,6 @@ class CfnDBInstance(
|
|
|
8923
8970
|
availability_zone: typing.Optional[builtins.str] = None,
|
|
8924
8971
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
8925
8972
|
ca_certificate_identifier: typing.Optional[builtins.str] = None,
|
|
8926
|
-
certificate_details: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDBInstance.CertificateDetailsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
8927
8973
|
certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
8928
8974
|
character_set_name: typing.Optional[builtins.str] = None,
|
|
8929
8975
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
@@ -8950,7 +8996,6 @@ class CfnDBInstance(
|
|
|
8950
8996
|
enable_cloudwatch_logs_exports: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
8951
8997
|
enable_iam_database_authentication: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
8952
8998
|
enable_performance_insights: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
8953
|
-
endpoint: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDBInstance.EndpointProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
8954
8999
|
engine: typing.Optional[builtins.str] = None,
|
|
8955
9000
|
engine_lifecycle_support: typing.Optional[builtins.str] = None,
|
|
8956
9001
|
engine_version: typing.Optional[builtins.str] = None,
|
|
@@ -9008,7 +9053,6 @@ class CfnDBInstance(
|
|
|
9008
9053
|
:param availability_zone: The Availability Zone (AZ) where the database will be created. For information on AWS Regions and Availability Zones, see `Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ . For Amazon Aurora, each Aurora DB cluster hosts copies of its storage in three separate Availability Zones. Specify one of these Availability Zones. Aurora automatically chooses an appropriate Availability Zone if you don't specify one. Default: A random, system-chosen Availability Zone in the endpoint's AWS Region . Constraints: - The ``AvailabilityZone`` parameter can't be specified if the DB instance is a Multi-AZ deployment. - The specified Availability Zone must be in the same AWS Region as the current endpoint. Example: ``us-east-1d``
|
|
9009
9054
|
:param backup_retention_period: The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups. *Amazon Aurora* Not applicable. The retention period for automated backups is managed by the DB cluster. Default: 1 Constraints: - Must be a value from 0 to 35 - Can't be set to 0 if the DB instance is a source to read replicas
|
|
9010
9055
|
:param ca_certificate_identifier: The identifier of the CA certificate for this DB instance. For more information, see `Using SSL/TLS to encrypt a connection to a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon RDS User Guide* and `Using SSL/TLS to encrypt a connection to a DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon Aurora User Guide* .
|
|
9011
|
-
:param certificate_details: The details of the DB instance’s server certificate. For more information, see `Using SSL/TLS to encrypt a connection to a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon RDS User Guide* and `Using SSL/TLS to encrypt a connection to a DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon Aurora User Guide*.
|
|
9012
9056
|
:param certificate_rotation_restart: Specifies whether the DB instance is restarted when you rotate your SSL/TLS certificate. By default, the DB instance is restarted when you rotate your SSL/TLS certificate. The certificate is not updated until the DB instance is restarted. .. epigraph:: Set this parameter only if you are *not* using SSL/TLS to connect to the DB instance. If you are using SSL/TLS to connect to the DB instance, follow the appropriate instructions for your DB engine to rotate your SSL/TLS certificate: - For more information about rotating your SSL/TLS certificate for RDS DB engines, see `Rotating Your SSL/TLS Certificate. <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon RDS User Guide.* - For more information about rotating your SSL/TLS certificate for Aurora DB engines, see `Rotating Your SSL/TLS Certificate <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon Aurora User Guide* . This setting doesn't apply to RDS Custom DB instances.
|
|
9013
9057
|
:param character_set_name: For supported engines, indicates that the DB instance should be associated with the specified character set. *Amazon Aurora* Not applicable. The character set is managed by the DB cluster. For more information, see `AWS::RDS::DBCluster <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html>`_ .
|
|
9014
9058
|
:param copy_tags_to_snapshot: Specifies whether to copy tags from the DB instance to snapshots of the DB instance. By default, tags are not copied. This setting doesn't apply to Amazon Aurora DB instances. Copying tags to snapshots is managed by the DB cluster. Setting this value for an Aurora DB instance has no effect on the DB cluster setting.
|
|
@@ -9035,7 +9079,6 @@ class CfnDBInstance(
|
|
|
9035
9079
|
:param enable_cloudwatch_logs_exports: The list of log types that need to be enabled for exporting to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see `Publishing Database Logs to Amazon CloudWatch Logs <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch>`_ in the *Amazon Relational Database Service User Guide* . *Amazon Aurora* Not applicable. CloudWatch Logs exports are managed by the DB cluster. *Db2* Valid values: ``diag.log`` , ``notify.log`` *MariaDB* Valid values: ``audit`` , ``error`` , ``general`` , ``slowquery`` *Microsoft SQL Server* Valid values: ``agent`` , ``error`` *MySQL* Valid values: ``audit`` , ``error`` , ``general`` , ``slowquery`` *Oracle* Valid values: ``alert`` , ``audit`` , ``listener`` , ``trace`` , ``oemagent`` *PostgreSQL* Valid values: ``postgresql`` , ``upgrade``
|
|
9036
9080
|
:param enable_iam_database_authentication: A value that indicates whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. By default, mapping is disabled. This property is supported for RDS for MariaDB, RDS for MySQL, and RDS for PostgreSQL. For more information, see `IAM Database Authentication for MariaDB, MySQL, and PostgreSQL <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html>`_ in the *Amazon RDS User Guide.* *Amazon Aurora* Not applicable. Mapping AWS IAM accounts to database accounts is managed by the DB cluster.
|
|
9037
9081
|
:param enable_performance_insights: Specifies whether to enable Performance Insights for the DB instance. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to RDS Custom DB instances.
|
|
9038
|
-
:param endpoint: This data type represents the information you need to connect to an Amazon RDS DB instance. This data type is used as a response element in the following actions: - ``CreateDBInstance`` - ``DescribeDBInstances`` - ``DeleteDBInstance`` For the data structure that represents Amazon Aurora DB cluster endpoints, see ``DBClusterEndpoint``.
|
|
9039
9082
|
:param engine: The name of the database engine to use for this DB instance. Not every database engine is available in every AWS Region. This property is required when creating a DB instance. .. epigraph:: You can convert an Oracle database from the non-CDB architecture to the container database (CDB) architecture by updating the ``Engine`` value in your templates from ``oracle-ee`` to ``oracle-ee-cdb`` or from ``oracle-se2`` to ``oracle-se2-cdb`` . Converting to the CDB architecture requires an interruption. Valid Values: - ``aurora-mysql`` (for Aurora MySQL DB instances) - ``aurora-postgresql`` (for Aurora PostgreSQL DB instances) - ``custom-oracle-ee`` (for RDS Custom for Oracle DB instances) - ``custom-oracle-ee-cdb`` (for RDS Custom for Oracle DB instances) - ``custom-sqlserver-ee`` (for RDS Custom for SQL Server DB instances) - ``custom-sqlserver-se`` (for RDS Custom for SQL Server DB instances) - ``custom-sqlserver-web`` (for RDS Custom for SQL Server DB instances) - ``db2-ae`` - ``db2-se`` - ``mariadb`` - ``mysql`` - ``oracle-ee`` - ``oracle-ee-cdb`` - ``oracle-se2`` - ``oracle-se2-cdb`` - ``postgres`` - ``sqlserver-ee`` - ``sqlserver-se`` - ``sqlserver-ex`` - ``sqlserver-web``
|
|
9040
9083
|
:param engine_lifecycle_support: The life cycle type for this DB instance. .. epigraph:: By default, this value is set to ``open-source-rds-extended-support`` , which enrolls your DB instance into Amazon RDS Extended Support. At the end of standard support, you can avoid charges for Extended Support by setting the value to ``open-source-rds-extended-support-disabled`` . In this case, creating the DB instance will fail if the DB major version is past its end of standard support date. This setting applies only to RDS for MySQL and RDS for PostgreSQL. For Amazon Aurora DB instances, the life cycle type is managed by the DB cluster. You can use this setting to enroll your DB instance into Amazon RDS Extended Support. With RDS Extended Support, you can run the selected major engine version on your DB instance past the end of standard support for that engine version. For more information, see `Using Amazon RDS Extended Support <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html>`_ in the *Amazon RDS User Guide* . Valid Values: ``open-source-rds-extended-support | open-source-rds-extended-support-disabled`` Default: ``open-source-rds-extended-support``
|
|
9041
9084
|
:param engine_version: The version number of the database engine to use. For a list of valid engine versions, use the ``DescribeDBEngineVersions`` action. The following are the database engines and links to information about the major and minor versions that are available with Amazon RDS. Not every database engine is available for every AWS Region. *Amazon Aurora* Not applicable. The version number of the database engine to be used by the DB instance is managed by the DB cluster. *Db2* See `Amazon RDS for Db2 <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Db2.html#Db2.Concepts.VersionMgmt>`_ in the *Amazon RDS User Guide.* *MariaDB* See `MariaDB on Amazon RDS Versions <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt>`_ in the *Amazon RDS User Guide.* *Microsoft SQL Server* See `Microsoft SQL Server Versions on Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport>`_ in the *Amazon RDS User Guide.* *MySQL* See `MySQL on Amazon RDS Versions <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt>`_ in the *Amazon RDS User Guide.* *Oracle* See `Oracle Database Engine Release Notes <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html>`_ in the *Amazon RDS User Guide.* *PostgreSQL* See `Supported PostgreSQL Database Versions <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.DBVersions>`_ in the *Amazon RDS User Guide.*
|
|
@@ -9095,7 +9138,6 @@ class CfnDBInstance(
|
|
|
9095
9138
|
availability_zone=availability_zone,
|
|
9096
9139
|
backup_retention_period=backup_retention_period,
|
|
9097
9140
|
ca_certificate_identifier=ca_certificate_identifier,
|
|
9098
|
-
certificate_details=certificate_details,
|
|
9099
9141
|
certificate_rotation_restart=certificate_rotation_restart,
|
|
9100
9142
|
character_set_name=character_set_name,
|
|
9101
9143
|
copy_tags_to_snapshot=copy_tags_to_snapshot,
|
|
@@ -9122,7 +9164,6 @@ class CfnDBInstance(
|
|
|
9122
9164
|
enable_cloudwatch_logs_exports=enable_cloudwatch_logs_exports,
|
|
9123
9165
|
enable_iam_database_authentication=enable_iam_database_authentication,
|
|
9124
9166
|
enable_performance_insights=enable_performance_insights,
|
|
9125
|
-
endpoint=endpoint,
|
|
9126
9167
|
engine=engine,
|
|
9127
9168
|
engine_lifecycle_support=engine_lifecycle_support,
|
|
9128
9169
|
engine_version=engine_version,
|
|
@@ -9514,24 +9555,6 @@ class CfnDBInstance(
|
|
|
9514
9555
|
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
9515
9556
|
jsii.set(self, "caCertificateIdentifier", value) # pyright: ignore[reportArgumentType]
|
|
9516
9557
|
|
|
9517
|
-
@builtins.property
|
|
9518
|
-
@jsii.member(jsii_name="certificateDetails")
|
|
9519
|
-
def certificate_details(
|
|
9520
|
-
self,
|
|
9521
|
-
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDBInstance.CertificateDetailsProperty"]]:
|
|
9522
|
-
'''The details of the DB instance’s server certificate.'''
|
|
9523
|
-
return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDBInstance.CertificateDetailsProperty"]], jsii.get(self, "certificateDetails"))
|
|
9524
|
-
|
|
9525
|
-
@certificate_details.setter
|
|
9526
|
-
def certificate_details(
|
|
9527
|
-
self,
|
|
9528
|
-
value: typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDBInstance.CertificateDetailsProperty"]],
|
|
9529
|
-
) -> None:
|
|
9530
|
-
if __debug__:
|
|
9531
|
-
type_hints = typing.get_type_hints(_typecheckingstub__8fa6bdf9b58edb0597b51a45bb01b0942f96853a6387af364c3ca19f8ebd5009)
|
|
9532
|
-
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
9533
|
-
jsii.set(self, "certificateDetails", value) # pyright: ignore[reportArgumentType]
|
|
9534
|
-
|
|
9535
9558
|
@builtins.property
|
|
9536
9559
|
@jsii.member(jsii_name="certificateRotationRestart")
|
|
9537
9560
|
def certificate_rotation_restart(
|
|
@@ -9916,24 +9939,6 @@ class CfnDBInstance(
|
|
|
9916
9939
|
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
9917
9940
|
jsii.set(self, "enablePerformanceInsights", value) # pyright: ignore[reportArgumentType]
|
|
9918
9941
|
|
|
9919
|
-
@builtins.property
|
|
9920
|
-
@jsii.member(jsii_name="endpoint")
|
|
9921
|
-
def endpoint(
|
|
9922
|
-
self,
|
|
9923
|
-
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDBInstance.EndpointProperty"]]:
|
|
9924
|
-
'''This data type represents the information you need to connect to an Amazon RDS DB instance.'''
|
|
9925
|
-
return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDBInstance.EndpointProperty"]], jsii.get(self, "endpoint"))
|
|
9926
|
-
|
|
9927
|
-
@endpoint.setter
|
|
9928
|
-
def endpoint(
|
|
9929
|
-
self,
|
|
9930
|
-
value: typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDBInstance.EndpointProperty"]],
|
|
9931
|
-
) -> None:
|
|
9932
|
-
if __debug__:
|
|
9933
|
-
type_hints = typing.get_type_hints(_typecheckingstub__33fac2f64e551e516fef566fbc6d4ca2de02e0f84b5ef369d43a164e7683d854)
|
|
9934
|
-
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
9935
|
-
jsii.set(self, "endpoint", value) # pyright: ignore[reportArgumentType]
|
|
9936
|
-
|
|
9937
9942
|
@builtins.property
|
|
9938
9943
|
@jsii.member(jsii_name="engine")
|
|
9939
9944
|
def engine(self) -> typing.Optional[builtins.str]:
|
|
@@ -10959,7 +10964,6 @@ class CfnDBInstance(
|
|
|
10959
10964
|
"availability_zone": "availabilityZone",
|
|
10960
10965
|
"backup_retention_period": "backupRetentionPeriod",
|
|
10961
10966
|
"ca_certificate_identifier": "caCertificateIdentifier",
|
|
10962
|
-
"certificate_details": "certificateDetails",
|
|
10963
10967
|
"certificate_rotation_restart": "certificateRotationRestart",
|
|
10964
10968
|
"character_set_name": "characterSetName",
|
|
10965
10969
|
"copy_tags_to_snapshot": "copyTagsToSnapshot",
|
|
@@ -10986,7 +10990,6 @@ class CfnDBInstance(
|
|
|
10986
10990
|
"enable_cloudwatch_logs_exports": "enableCloudwatchLogsExports",
|
|
10987
10991
|
"enable_iam_database_authentication": "enableIamDatabaseAuthentication",
|
|
10988
10992
|
"enable_performance_insights": "enablePerformanceInsights",
|
|
10989
|
-
"endpoint": "endpoint",
|
|
10990
10993
|
"engine": "engine",
|
|
10991
10994
|
"engine_lifecycle_support": "engineLifecycleSupport",
|
|
10992
10995
|
"engine_version": "engineVersion",
|
|
@@ -11046,7 +11049,6 @@ class CfnDBInstanceProps:
|
|
|
11046
11049
|
availability_zone: typing.Optional[builtins.str] = None,
|
|
11047
11050
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
11048
11051
|
ca_certificate_identifier: typing.Optional[builtins.str] = None,
|
|
11049
|
-
certificate_details: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDBInstance.CertificateDetailsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
11050
11052
|
certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
11051
11053
|
character_set_name: typing.Optional[builtins.str] = None,
|
|
11052
11054
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
@@ -11073,7 +11075,6 @@ class CfnDBInstanceProps:
|
|
|
11073
11075
|
enable_cloudwatch_logs_exports: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
11074
11076
|
enable_iam_database_authentication: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
11075
11077
|
enable_performance_insights: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
11076
|
-
endpoint: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDBInstance.EndpointProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
11077
11078
|
engine: typing.Optional[builtins.str] = None,
|
|
11078
11079
|
engine_lifecycle_support: typing.Optional[builtins.str] = None,
|
|
11079
11080
|
engine_version: typing.Optional[builtins.str] = None,
|
|
@@ -11130,7 +11131,6 @@ class CfnDBInstanceProps:
|
|
|
11130
11131
|
:param availability_zone: The Availability Zone (AZ) where the database will be created. For information on AWS Regions and Availability Zones, see `Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ . For Amazon Aurora, each Aurora DB cluster hosts copies of its storage in three separate Availability Zones. Specify one of these Availability Zones. Aurora automatically chooses an appropriate Availability Zone if you don't specify one. Default: A random, system-chosen Availability Zone in the endpoint's AWS Region . Constraints: - The ``AvailabilityZone`` parameter can't be specified if the DB instance is a Multi-AZ deployment. - The specified Availability Zone must be in the same AWS Region as the current endpoint. Example: ``us-east-1d``
|
|
11131
11132
|
:param backup_retention_period: The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups. *Amazon Aurora* Not applicable. The retention period for automated backups is managed by the DB cluster. Default: 1 Constraints: - Must be a value from 0 to 35 - Can't be set to 0 if the DB instance is a source to read replicas
|
|
11132
11133
|
:param ca_certificate_identifier: The identifier of the CA certificate for this DB instance. For more information, see `Using SSL/TLS to encrypt a connection to a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon RDS User Guide* and `Using SSL/TLS to encrypt a connection to a DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon Aurora User Guide* .
|
|
11133
|
-
:param certificate_details: The details of the DB instance’s server certificate. For more information, see `Using SSL/TLS to encrypt a connection to a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon RDS User Guide* and `Using SSL/TLS to encrypt a connection to a DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon Aurora User Guide*.
|
|
11134
11134
|
:param certificate_rotation_restart: Specifies whether the DB instance is restarted when you rotate your SSL/TLS certificate. By default, the DB instance is restarted when you rotate your SSL/TLS certificate. The certificate is not updated until the DB instance is restarted. .. epigraph:: Set this parameter only if you are *not* using SSL/TLS to connect to the DB instance. If you are using SSL/TLS to connect to the DB instance, follow the appropriate instructions for your DB engine to rotate your SSL/TLS certificate: - For more information about rotating your SSL/TLS certificate for RDS DB engines, see `Rotating Your SSL/TLS Certificate. <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon RDS User Guide.* - For more information about rotating your SSL/TLS certificate for Aurora DB engines, see `Rotating Your SSL/TLS Certificate <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon Aurora User Guide* . This setting doesn't apply to RDS Custom DB instances.
|
|
11135
11135
|
:param character_set_name: For supported engines, indicates that the DB instance should be associated with the specified character set. *Amazon Aurora* Not applicable. The character set is managed by the DB cluster. For more information, see `AWS::RDS::DBCluster <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html>`_ .
|
|
11136
11136
|
:param copy_tags_to_snapshot: Specifies whether to copy tags from the DB instance to snapshots of the DB instance. By default, tags are not copied. This setting doesn't apply to Amazon Aurora DB instances. Copying tags to snapshots is managed by the DB cluster. Setting this value for an Aurora DB instance has no effect on the DB cluster setting.
|
|
@@ -11157,7 +11157,6 @@ class CfnDBInstanceProps:
|
|
|
11157
11157
|
:param enable_cloudwatch_logs_exports: The list of log types that need to be enabled for exporting to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see `Publishing Database Logs to Amazon CloudWatch Logs <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch>`_ in the *Amazon Relational Database Service User Guide* . *Amazon Aurora* Not applicable. CloudWatch Logs exports are managed by the DB cluster. *Db2* Valid values: ``diag.log`` , ``notify.log`` *MariaDB* Valid values: ``audit`` , ``error`` , ``general`` , ``slowquery`` *Microsoft SQL Server* Valid values: ``agent`` , ``error`` *MySQL* Valid values: ``audit`` , ``error`` , ``general`` , ``slowquery`` *Oracle* Valid values: ``alert`` , ``audit`` , ``listener`` , ``trace`` , ``oemagent`` *PostgreSQL* Valid values: ``postgresql`` , ``upgrade``
|
|
11158
11158
|
:param enable_iam_database_authentication: A value that indicates whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. By default, mapping is disabled. This property is supported for RDS for MariaDB, RDS for MySQL, and RDS for PostgreSQL. For more information, see `IAM Database Authentication for MariaDB, MySQL, and PostgreSQL <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html>`_ in the *Amazon RDS User Guide.* *Amazon Aurora* Not applicable. Mapping AWS IAM accounts to database accounts is managed by the DB cluster.
|
|
11159
11159
|
:param enable_performance_insights: Specifies whether to enable Performance Insights for the DB instance. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to RDS Custom DB instances.
|
|
11160
|
-
:param endpoint: This data type represents the information you need to connect to an Amazon RDS DB instance. This data type is used as a response element in the following actions: - ``CreateDBInstance`` - ``DescribeDBInstances`` - ``DeleteDBInstance`` For the data structure that represents Amazon Aurora DB cluster endpoints, see ``DBClusterEndpoint``.
|
|
11161
11160
|
:param engine: The name of the database engine to use for this DB instance. Not every database engine is available in every AWS Region. This property is required when creating a DB instance. .. epigraph:: You can convert an Oracle database from the non-CDB architecture to the container database (CDB) architecture by updating the ``Engine`` value in your templates from ``oracle-ee`` to ``oracle-ee-cdb`` or from ``oracle-se2`` to ``oracle-se2-cdb`` . Converting to the CDB architecture requires an interruption. Valid Values: - ``aurora-mysql`` (for Aurora MySQL DB instances) - ``aurora-postgresql`` (for Aurora PostgreSQL DB instances) - ``custom-oracle-ee`` (for RDS Custom for Oracle DB instances) - ``custom-oracle-ee-cdb`` (for RDS Custom for Oracle DB instances) - ``custom-sqlserver-ee`` (for RDS Custom for SQL Server DB instances) - ``custom-sqlserver-se`` (for RDS Custom for SQL Server DB instances) - ``custom-sqlserver-web`` (for RDS Custom for SQL Server DB instances) - ``db2-ae`` - ``db2-se`` - ``mariadb`` - ``mysql`` - ``oracle-ee`` - ``oracle-ee-cdb`` - ``oracle-se2`` - ``oracle-se2-cdb`` - ``postgres`` - ``sqlserver-ee`` - ``sqlserver-se`` - ``sqlserver-ex`` - ``sqlserver-web``
|
|
11162
11161
|
:param engine_lifecycle_support: The life cycle type for this DB instance. .. epigraph:: By default, this value is set to ``open-source-rds-extended-support`` , which enrolls your DB instance into Amazon RDS Extended Support. At the end of standard support, you can avoid charges for Extended Support by setting the value to ``open-source-rds-extended-support-disabled`` . In this case, creating the DB instance will fail if the DB major version is past its end of standard support date. This setting applies only to RDS for MySQL and RDS for PostgreSQL. For Amazon Aurora DB instances, the life cycle type is managed by the DB cluster. You can use this setting to enroll your DB instance into Amazon RDS Extended Support. With RDS Extended Support, you can run the selected major engine version on your DB instance past the end of standard support for that engine version. For more information, see `Using Amazon RDS Extended Support <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html>`_ in the *Amazon RDS User Guide* . Valid Values: ``open-source-rds-extended-support | open-source-rds-extended-support-disabled`` Default: ``open-source-rds-extended-support``
|
|
11163
11162
|
:param engine_version: The version number of the database engine to use. For a list of valid engine versions, use the ``DescribeDBEngineVersions`` action. The following are the database engines and links to information about the major and minor versions that are available with Amazon RDS. Not every database engine is available for every AWS Region. *Amazon Aurora* Not applicable. The version number of the database engine to be used by the DB instance is managed by the DB cluster. *Db2* See `Amazon RDS for Db2 <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Db2.html#Db2.Concepts.VersionMgmt>`_ in the *Amazon RDS User Guide.* *MariaDB* See `MariaDB on Amazon RDS Versions <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt>`_ in the *Amazon RDS User Guide.* *Microsoft SQL Server* See `Microsoft SQL Server Versions on Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport>`_ in the *Amazon RDS User Guide.* *MySQL* See `MySQL on Amazon RDS Versions <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt>`_ in the *Amazon RDS User Guide.* *Oracle* See `Oracle Database Engine Release Notes <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html>`_ in the *Amazon RDS User Guide.* *PostgreSQL* See `Supported PostgreSQL Database Versions <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.DBVersions>`_ in the *Amazon RDS User Guide.*
|
|
@@ -11225,10 +11224,6 @@ class CfnDBInstanceProps:
|
|
|
11225
11224
|
availability_zone="availabilityZone",
|
|
11226
11225
|
backup_retention_period=123,
|
|
11227
11226
|
ca_certificate_identifier="caCertificateIdentifier",
|
|
11228
|
-
certificate_details=rds.CfnDBInstance.CertificateDetailsProperty(
|
|
11229
|
-
ca_identifier="caIdentifier",
|
|
11230
|
-
valid_till="validTill"
|
|
11231
|
-
),
|
|
11232
11227
|
certificate_rotation_restart=False,
|
|
11233
11228
|
character_set_name="characterSetName",
|
|
11234
11229
|
copy_tags_to_snapshot=False,
|
|
@@ -11255,11 +11250,6 @@ class CfnDBInstanceProps:
|
|
|
11255
11250
|
enable_cloudwatch_logs_exports=["enableCloudwatchLogsExports"],
|
|
11256
11251
|
enable_iam_database_authentication=False,
|
|
11257
11252
|
enable_performance_insights=False,
|
|
11258
|
-
endpoint=rds.CfnDBInstance.EndpointProperty(
|
|
11259
|
-
address="address",
|
|
11260
|
-
hosted_zone_id="hostedZoneId",
|
|
11261
|
-
port="port"
|
|
11262
|
-
),
|
|
11263
11253
|
engine="engine",
|
|
11264
11254
|
engine_lifecycle_support="engineLifecycleSupport",
|
|
11265
11255
|
engine_version="engineVersion",
|
|
@@ -11326,7 +11316,6 @@ class CfnDBInstanceProps:
|
|
|
11326
11316
|
check_type(argname="argument availability_zone", value=availability_zone, expected_type=type_hints["availability_zone"])
|
|
11327
11317
|
check_type(argname="argument backup_retention_period", value=backup_retention_period, expected_type=type_hints["backup_retention_period"])
|
|
11328
11318
|
check_type(argname="argument ca_certificate_identifier", value=ca_certificate_identifier, expected_type=type_hints["ca_certificate_identifier"])
|
|
11329
|
-
check_type(argname="argument certificate_details", value=certificate_details, expected_type=type_hints["certificate_details"])
|
|
11330
11319
|
check_type(argname="argument certificate_rotation_restart", value=certificate_rotation_restart, expected_type=type_hints["certificate_rotation_restart"])
|
|
11331
11320
|
check_type(argname="argument character_set_name", value=character_set_name, expected_type=type_hints["character_set_name"])
|
|
11332
11321
|
check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
|
|
@@ -11353,7 +11342,6 @@ class CfnDBInstanceProps:
|
|
|
11353
11342
|
check_type(argname="argument enable_cloudwatch_logs_exports", value=enable_cloudwatch_logs_exports, expected_type=type_hints["enable_cloudwatch_logs_exports"])
|
|
11354
11343
|
check_type(argname="argument enable_iam_database_authentication", value=enable_iam_database_authentication, expected_type=type_hints["enable_iam_database_authentication"])
|
|
11355
11344
|
check_type(argname="argument enable_performance_insights", value=enable_performance_insights, expected_type=type_hints["enable_performance_insights"])
|
|
11356
|
-
check_type(argname="argument endpoint", value=endpoint, expected_type=type_hints["endpoint"])
|
|
11357
11345
|
check_type(argname="argument engine", value=engine, expected_type=type_hints["engine"])
|
|
11358
11346
|
check_type(argname="argument engine_lifecycle_support", value=engine_lifecycle_support, expected_type=type_hints["engine_lifecycle_support"])
|
|
11359
11347
|
check_type(argname="argument engine_version", value=engine_version, expected_type=type_hints["engine_version"])
|
|
@@ -11419,8 +11407,6 @@ class CfnDBInstanceProps:
|
|
|
11419
11407
|
self._values["backup_retention_period"] = backup_retention_period
|
|
11420
11408
|
if ca_certificate_identifier is not None:
|
|
11421
11409
|
self._values["ca_certificate_identifier"] = ca_certificate_identifier
|
|
11422
|
-
if certificate_details is not None:
|
|
11423
|
-
self._values["certificate_details"] = certificate_details
|
|
11424
11410
|
if certificate_rotation_restart is not None:
|
|
11425
11411
|
self._values["certificate_rotation_restart"] = certificate_rotation_restart
|
|
11426
11412
|
if character_set_name is not None:
|
|
@@ -11473,8 +11459,6 @@ class CfnDBInstanceProps:
|
|
|
11473
11459
|
self._values["enable_iam_database_authentication"] = enable_iam_database_authentication
|
|
11474
11460
|
if enable_performance_insights is not None:
|
|
11475
11461
|
self._values["enable_performance_insights"] = enable_performance_insights
|
|
11476
|
-
if endpoint is not None:
|
|
11477
|
-
self._values["endpoint"] = endpoint
|
|
11478
11462
|
if engine is not None:
|
|
11479
11463
|
self._values["engine"] = engine
|
|
11480
11464
|
if engine_lifecycle_support is not None:
|
|
@@ -11780,19 +11764,6 @@ class CfnDBInstanceProps:
|
|
|
11780
11764
|
result = self._values.get("ca_certificate_identifier")
|
|
11781
11765
|
return typing.cast(typing.Optional[builtins.str], result)
|
|
11782
11766
|
|
|
11783
|
-
@builtins.property
|
|
11784
|
-
def certificate_details(
|
|
11785
|
-
self,
|
|
11786
|
-
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBInstance.CertificateDetailsProperty]]:
|
|
11787
|
-
'''The details of the DB instance’s server certificate.
|
|
11788
|
-
|
|
11789
|
-
For more information, see `Using SSL/TLS to encrypt a connection to a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon RDS User Guide* and `Using SSL/TLS to encrypt a connection to a DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon Aurora User Guide*.
|
|
11790
|
-
|
|
11791
|
-
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-certificatedetails
|
|
11792
|
-
'''
|
|
11793
|
-
result = self._values.get("certificate_details")
|
|
11794
|
-
return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBInstance.CertificateDetailsProperty]], result)
|
|
11795
|
-
|
|
11796
11767
|
@builtins.property
|
|
11797
11768
|
def certificate_rotation_restart(
|
|
11798
11769
|
self,
|
|
@@ -12309,25 +12280,6 @@ class CfnDBInstanceProps:
|
|
|
12309
12280
|
result = self._values.get("enable_performance_insights")
|
|
12310
12281
|
return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
|
|
12311
12282
|
|
|
12312
|
-
@builtins.property
|
|
12313
|
-
def endpoint(
|
|
12314
|
-
self,
|
|
12315
|
-
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBInstance.EndpointProperty]]:
|
|
12316
|
-
'''This data type represents the information you need to connect to an Amazon RDS DB instance.
|
|
12317
|
-
|
|
12318
|
-
This data type is used as a response element in the following actions:
|
|
12319
|
-
|
|
12320
|
-
- ``CreateDBInstance``
|
|
12321
|
-
- ``DescribeDBInstances``
|
|
12322
|
-
- ``DeleteDBInstance``
|
|
12323
|
-
|
|
12324
|
-
For the data structure that represents Amazon Aurora DB cluster endpoints, see ``DBClusterEndpoint``.
|
|
12325
|
-
|
|
12326
|
-
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-endpoint
|
|
12327
|
-
'''
|
|
12328
|
-
result = self._values.get("endpoint")
|
|
12329
|
-
return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBInstance.EndpointProperty]], result)
|
|
12330
|
-
|
|
12331
12283
|
@builtins.property
|
|
12332
12284
|
def engine(self) -> typing.Optional[builtins.str]:
|
|
12333
12285
|
'''The name of the database engine to use for this DB instance.
|
|
@@ -23522,6 +23474,57 @@ class DatabaseInstanceEngine(
|
|
|
23522
23474
|
return typing.cast("IInstanceEngine", jsii.sget(cls, "SQL_SERVER_WEB"))
|
|
23523
23475
|
|
|
23524
23476
|
|
|
23477
|
+
@jsii.data_type(
|
|
23478
|
+
jsii_type="aws-cdk-lib.aws_rds.DatabaseInstanceLookupOptions",
|
|
23479
|
+
jsii_struct_bases=[],
|
|
23480
|
+
name_mapping={"instance_identifier": "instanceIdentifier"},
|
|
23481
|
+
)
|
|
23482
|
+
class DatabaseInstanceLookupOptions:
|
|
23483
|
+
def __init__(self, *, instance_identifier: builtins.str) -> None:
|
|
23484
|
+
'''Properties for looking up an existing DatabaseInstance.
|
|
23485
|
+
|
|
23486
|
+
:param instance_identifier: The instance identifier of the DatabaseInstance.
|
|
23487
|
+
|
|
23488
|
+
:exampleMetadata: infused
|
|
23489
|
+
|
|
23490
|
+
Example::
|
|
23491
|
+
|
|
23492
|
+
# my_user_role: iam.Role
|
|
23493
|
+
|
|
23494
|
+
|
|
23495
|
+
db_from_lookup = rds.DatabaseInstance.from_lookup(self, "dbFromLookup",
|
|
23496
|
+
instance_identifier="instanceId"
|
|
23497
|
+
)
|
|
23498
|
+
|
|
23499
|
+
# Grant a connection
|
|
23500
|
+
db_from_lookup.grant_connect(my_user_role, "my-user-id")
|
|
23501
|
+
'''
|
|
23502
|
+
if __debug__:
|
|
23503
|
+
type_hints = typing.get_type_hints(_typecheckingstub__a68848c3fd35e58159e035ad3a08edd50065e93bc47c43acc588d83b31cd89cc)
|
|
23504
|
+
check_type(argname="argument instance_identifier", value=instance_identifier, expected_type=type_hints["instance_identifier"])
|
|
23505
|
+
self._values: typing.Dict[builtins.str, typing.Any] = {
|
|
23506
|
+
"instance_identifier": instance_identifier,
|
|
23507
|
+
}
|
|
23508
|
+
|
|
23509
|
+
@builtins.property
|
|
23510
|
+
def instance_identifier(self) -> builtins.str:
|
|
23511
|
+
'''The instance identifier of the DatabaseInstance.'''
|
|
23512
|
+
result = self._values.get("instance_identifier")
|
|
23513
|
+
assert result is not None, "Required property 'instance_identifier' is missing"
|
|
23514
|
+
return typing.cast(builtins.str, result)
|
|
23515
|
+
|
|
23516
|
+
def __eq__(self, rhs: typing.Any) -> builtins.bool:
|
|
23517
|
+
return isinstance(rhs, self.__class__) and rhs._values == self._values
|
|
23518
|
+
|
|
23519
|
+
def __ne__(self, rhs: typing.Any) -> builtins.bool:
|
|
23520
|
+
return not (rhs == self)
|
|
23521
|
+
|
|
23522
|
+
def __repr__(self) -> str:
|
|
23523
|
+
return "DatabaseInstanceLookupOptions(%s)" % ", ".join(
|
|
23524
|
+
k + "=" + repr(v) for k, v in self._values.items()
|
|
23525
|
+
)
|
|
23526
|
+
|
|
23527
|
+
|
|
23525
23528
|
@jsii.data_type(
|
|
23526
23529
|
jsii_type="aws-cdk-lib.aws_rds.DatabaseInstanceNewProps",
|
|
23527
23530
|
jsii_struct_bases=[],
|
|
@@ -42890,6 +42893,31 @@ class DatabaseInstanceBase(
|
|
|
42890
42893
|
|
|
42891
42894
|
return typing.cast(IDatabaseInstance, jsii.sinvoke(cls, "fromDatabaseInstanceAttributes", [scope, id, attrs]))
|
|
42892
42895
|
|
|
42896
|
+
@jsii.member(jsii_name="fromLookup")
|
|
42897
|
+
@builtins.classmethod
|
|
42898
|
+
def from_lookup(
|
|
42899
|
+
cls,
|
|
42900
|
+
scope: _constructs_77d1e7e8.Construct,
|
|
42901
|
+
id: builtins.str,
|
|
42902
|
+
*,
|
|
42903
|
+
instance_identifier: builtins.str,
|
|
42904
|
+
) -> IDatabaseInstance:
|
|
42905
|
+
'''Lookup an existing DatabaseInstance using instanceIdentifier.
|
|
42906
|
+
|
|
42907
|
+
:param scope: -
|
|
42908
|
+
:param id: -
|
|
42909
|
+
:param instance_identifier: The instance identifier of the DatabaseInstance.
|
|
42910
|
+
'''
|
|
42911
|
+
if __debug__:
|
|
42912
|
+
type_hints = typing.get_type_hints(_typecheckingstub__48d8ddc93958bf98fee260c9c8ab8ac972c2df71e3a1baf7be3972315129a3f7)
|
|
42913
|
+
check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
|
|
42914
|
+
check_type(argname="argument id", value=id, expected_type=type_hints["id"])
|
|
42915
|
+
options = DatabaseInstanceLookupOptions(
|
|
42916
|
+
instance_identifier=instance_identifier
|
|
42917
|
+
)
|
|
42918
|
+
|
|
42919
|
+
return typing.cast(IDatabaseInstance, jsii.sinvoke(cls, "fromLookup", [scope, id, options]))
|
|
42920
|
+
|
|
42893
42921
|
@jsii.member(jsii_name="addProxy")
|
|
42894
42922
|
def add_proxy(
|
|
42895
42923
|
self,
|
|
@@ -47482,6 +47510,7 @@ __all__ = [
|
|
|
47482
47510
|
"DatabaseInstanceEngine",
|
|
47483
47511
|
"DatabaseInstanceFromSnapshot",
|
|
47484
47512
|
"DatabaseInstanceFromSnapshotProps",
|
|
47513
|
+
"DatabaseInstanceLookupOptions",
|
|
47485
47514
|
"DatabaseInstanceNewProps",
|
|
47486
47515
|
"DatabaseInstanceProps",
|
|
47487
47516
|
"DatabaseInstanceReadReplica",
|
|
@@ -48379,7 +48408,6 @@ def _typecheckingstub__255b0779ca741853674876540bf77279f6293bea05de2cd18724d2b92
|
|
|
48379
48408
|
availability_zone: typing.Optional[builtins.str] = None,
|
|
48380
48409
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
48381
48410
|
ca_certificate_identifier: typing.Optional[builtins.str] = None,
|
|
48382
|
-
certificate_details: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDBInstance.CertificateDetailsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
48383
48411
|
certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
48384
48412
|
character_set_name: typing.Optional[builtins.str] = None,
|
|
48385
48413
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
@@ -48406,7 +48434,6 @@ def _typecheckingstub__255b0779ca741853674876540bf77279f6293bea05de2cd18724d2b92
|
|
|
48406
48434
|
enable_cloudwatch_logs_exports: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
48407
48435
|
enable_iam_database_authentication: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
48408
48436
|
enable_performance_insights: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
48409
|
-
endpoint: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDBInstance.EndpointProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
48410
48437
|
engine: typing.Optional[builtins.str] = None,
|
|
48411
48438
|
engine_lifecycle_support: typing.Optional[builtins.str] = None,
|
|
48412
48439
|
engine_version: typing.Optional[builtins.str] = None,
|
|
@@ -48531,12 +48558,6 @@ def _typecheckingstub__62ccd61fdb1bb7842d321fcd1476ed686baf586bf907671076cafd6ba
|
|
|
48531
48558
|
"""Type checking stubs"""
|
|
48532
48559
|
pass
|
|
48533
48560
|
|
|
48534
|
-
def _typecheckingstub__8fa6bdf9b58edb0597b51a45bb01b0942f96853a6387af364c3ca19f8ebd5009(
|
|
48535
|
-
value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBInstance.CertificateDetailsProperty]],
|
|
48536
|
-
) -> None:
|
|
48537
|
-
"""Type checking stubs"""
|
|
48538
|
-
pass
|
|
48539
|
-
|
|
48540
48561
|
def _typecheckingstub__8300a7358b8f3721e212076b4d43c16dce7eaecbef2865d4c267632cacd1e540(
|
|
48541
48562
|
value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
|
|
48542
48563
|
) -> None:
|
|
@@ -48693,12 +48714,6 @@ def _typecheckingstub__55acaa45776cf6b5432f2a97177653a9807b3c5b475626ccb7e031f2c
|
|
|
48693
48714
|
"""Type checking stubs"""
|
|
48694
48715
|
pass
|
|
48695
48716
|
|
|
48696
|
-
def _typecheckingstub__33fac2f64e551e516fef566fbc6d4ca2de02e0f84b5ef369d43a164e7683d854(
|
|
48697
|
-
value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBInstance.EndpointProperty]],
|
|
48698
|
-
) -> None:
|
|
48699
|
-
"""Type checking stubs"""
|
|
48700
|
-
pass
|
|
48701
|
-
|
|
48702
48717
|
def _typecheckingstub__c1390f99110e4c5a9ba1f2e9dd4d5ccd134a1dd6c4610d4f96e29fca66cf7a9b(
|
|
48703
48718
|
value: typing.Optional[builtins.str],
|
|
48704
48719
|
) -> None:
|
|
@@ -49005,7 +49020,6 @@ def _typecheckingstub__3bddb1be0bd1f1699e3a084c5859d94d8879ff15011f2f2eaac29ec16
|
|
|
49005
49020
|
availability_zone: typing.Optional[builtins.str] = None,
|
|
49006
49021
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
49007
49022
|
ca_certificate_identifier: typing.Optional[builtins.str] = None,
|
|
49008
|
-
certificate_details: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDBInstance.CertificateDetailsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
49009
49023
|
certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
49010
49024
|
character_set_name: typing.Optional[builtins.str] = None,
|
|
49011
49025
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
@@ -49032,7 +49046,6 @@ def _typecheckingstub__3bddb1be0bd1f1699e3a084c5859d94d8879ff15011f2f2eaac29ec16
|
|
|
49032
49046
|
enable_cloudwatch_logs_exports: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
49033
49047
|
enable_iam_database_authentication: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
49034
49048
|
enable_performance_insights: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
49035
|
-
endpoint: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDBInstance.EndpointProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
49036
49049
|
engine: typing.Optional[builtins.str] = None,
|
|
49037
49050
|
engine_lifecycle_support: typing.Optional[builtins.str] = None,
|
|
49038
49051
|
engine_version: typing.Optional[builtins.str] = None,
|
|
@@ -50376,6 +50389,13 @@ def _typecheckingstub__c46002009ab88821e56f6612b8b65e2f4599174816135533fa2342791
|
|
|
50376
50389
|
"""Type checking stubs"""
|
|
50377
50390
|
pass
|
|
50378
50391
|
|
|
50392
|
+
def _typecheckingstub__a68848c3fd35e58159e035ad3a08edd50065e93bc47c43acc588d83b31cd89cc(
|
|
50393
|
+
*,
|
|
50394
|
+
instance_identifier: builtins.str,
|
|
50395
|
+
) -> None:
|
|
50396
|
+
"""Type checking stubs"""
|
|
50397
|
+
pass
|
|
50398
|
+
|
|
50379
50399
|
def _typecheckingstub__d110b1cb0043ae6adf59fc0d1bcb136b4655ac973cfbff361a0a3e2fe97c39f8(
|
|
50380
50400
|
*,
|
|
50381
50401
|
vpc: _IVpc_f30d5663,
|
|
@@ -51645,6 +51665,15 @@ def _typecheckingstub__e84e286636afa00f9c760ec79c7dac8e6bb0eca8b8b9a221372c32480
|
|
|
51645
51665
|
"""Type checking stubs"""
|
|
51646
51666
|
pass
|
|
51647
51667
|
|
|
51668
|
+
def _typecheckingstub__48d8ddc93958bf98fee260c9c8ab8ac972c2df71e3a1baf7be3972315129a3f7(
|
|
51669
|
+
scope: _constructs_77d1e7e8.Construct,
|
|
51670
|
+
id: builtins.str,
|
|
51671
|
+
*,
|
|
51672
|
+
instance_identifier: builtins.str,
|
|
51673
|
+
) -> None:
|
|
51674
|
+
"""Type checking stubs"""
|
|
51675
|
+
pass
|
|
51676
|
+
|
|
51648
51677
|
def _typecheckingstub__1a570d3e3410884069b8a67a8efdb043b454116fb50145140aeead995d1acf19(
|
|
51649
51678
|
id: builtins.str,
|
|
51650
51679
|
*,
|
|
@@ -1363,7 +1363,7 @@ class CfnWorkgroup(
|
|
|
1363
1363
|
:param security_group_ids: A list of security group IDs to associate with the workgroup.
|
|
1364
1364
|
:param snapshot_arn: The Amazon Resource Name (ARN) of the snapshot to restore from.
|
|
1365
1365
|
:param snapshot_name: The snapshot name to restore from.
|
|
1366
|
-
:param snapshot_owner_account: The
|
|
1366
|
+
:param snapshot_owner_account: The Amazon Web Services account that owns the snapshot.
|
|
1367
1367
|
:param subnet_ids: A list of subnet IDs the workgroup is associated with.
|
|
1368
1368
|
:param tags: The map of the key-value pairs used to tag the workgroup.
|
|
1369
1369
|
:param track_name: An optional parameter for the name of the track for the workgroup. If you don't provide a track name, the workgroup is assigned to the current track.
|
|
@@ -1434,14 +1434,6 @@ class CfnWorkgroup(
|
|
|
1434
1434
|
'''
|
|
1435
1435
|
return typing.cast(_IResolvable_da3f097b, jsii.get(self, "attrWorkgroup"))
|
|
1436
1436
|
|
|
1437
|
-
@builtins.property
|
|
1438
|
-
@jsii.member(jsii_name="attrWorkgroupBaseCapacity")
|
|
1439
|
-
def attr_workgroup_base_capacity(self) -> jsii.Number:
|
|
1440
|
-
'''
|
|
1441
|
-
:cloudformationAttribute: Workgroup.BaseCapacity
|
|
1442
|
-
'''
|
|
1443
|
-
return typing.cast(jsii.Number, jsii.get(self, "attrWorkgroupBaseCapacity"))
|
|
1444
|
-
|
|
1445
1437
|
@builtins.property
|
|
1446
1438
|
@jsii.member(jsii_name="attrWorkgroupConfigParameters")
|
|
1447
1439
|
def attr_workgroup_config_parameters(self) -> _IResolvable_da3f097b:
|
|
@@ -1791,7 +1783,7 @@ class CfnWorkgroup(
|
|
|
1791
1783
|
@builtins.property
|
|
1792
1784
|
@jsii.member(jsii_name="snapshotOwnerAccount")
|
|
1793
1785
|
def snapshot_owner_account(self) -> typing.Optional[builtins.str]:
|
|
1794
|
-
'''The
|
|
1786
|
+
'''The Amazon Web Services account that owns the snapshot.'''
|
|
1795
1787
|
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "snapshotOwnerAccount"))
|
|
1796
1788
|
|
|
1797
1789
|
@snapshot_owner_account.setter
|
|
@@ -2701,7 +2693,7 @@ class CfnWorkgroupProps:
|
|
|
2701
2693
|
:param security_group_ids: A list of security group IDs to associate with the workgroup.
|
|
2702
2694
|
:param snapshot_arn: The Amazon Resource Name (ARN) of the snapshot to restore from.
|
|
2703
2695
|
:param snapshot_name: The snapshot name to restore from.
|
|
2704
|
-
:param snapshot_owner_account: The
|
|
2696
|
+
:param snapshot_owner_account: The Amazon Web Services account that owns the snapshot.
|
|
2705
2697
|
:param subnet_ids: A list of subnet IDs the workgroup is associated with.
|
|
2706
2698
|
:param tags: The map of the key-value pairs used to tag the workgroup.
|
|
2707
2699
|
:param track_name: An optional parameter for the name of the track for the workgroup. If you don't provide a track name, the workgroup is assigned to the current track.
|
|
@@ -2980,9 +2972,7 @@ class CfnWorkgroupProps:
|
|
|
2980
2972
|
|
|
2981
2973
|
@builtins.property
|
|
2982
2974
|
def snapshot_owner_account(self) -> typing.Optional[builtins.str]:
|
|
2983
|
-
'''The
|
|
2984
|
-
|
|
2985
|
-
account of the snapshot.
|
|
2975
|
+
'''The Amazon Web Services account that owns the snapshot.
|
|
2986
2976
|
|
|
2987
2977
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshiftserverless-workgroup.html#cfn-redshiftserverless-workgroup-snapshotowneraccount
|
|
2988
2978
|
'''
|