interface DatabaseClusterFromSnapshotProps
Language | Type name |
---|---|
.NET | Amazon.CDK.AWS.RDS.DatabaseClusterFromSnapshotProps |
Go | github.com/aws/aws-cdk-go/awscdk/v2/awsrds#DatabaseClusterFromSnapshotProps |
Java | software.amazon.awscdk.services.rds.DatabaseClusterFromSnapshotProps |
Python | aws_cdk.aws_rds.DatabaseClusterFromSnapshotProps |
TypeScript (source) | aws-cdk-lib » aws_rds » DatabaseClusterFromSnapshotProps |
Properties for DatabaseClusterFromSnapshot
.
Example
declare const vpc: ec2.Vpc;
new rds.DatabaseClusterFromSnapshot(this, 'Database', {
engine: rds.DatabaseClusterEngine.aurora({ version: rds.AuroraEngineVersion.VER_1_22_2 }),
writer: rds.ClusterInstance.provisioned('writer'),
vpc,
snapshotIdentifier: 'mySnapshot',
});
Properties
Name | Type | Description |
---|---|---|
engine | ICluster | What kind of database to start. |
snapshot | string | The identifier for the DB instance snapshot or DB cluster snapshot to restore from. |
backtrack | Duration | The number of seconds to set a cluster's target backtrack window to. |
backup? | Backup | Backup settings. |
cloudwatch | string[] | The list of log types that need to be enabled for exporting to CloudWatch Logs. |
cloudwatch | Retention | The number of days log events are kept in CloudWatch Logs. |
cloudwatch | IRole | The IAM role for the Lambda function associated with the custom resource that sets the retention policy. |
cluster | string | An optional identifier for the cluster. |
copy | boolean | Whether to copy tags to the snapshot when a snapshot is created. |
credentials? | Credentials | Credentials for the administrative user. |
default | string | Name of a database which is automatically created inside the cluster. |
deletion | boolean | Indicates whether the DB cluster should have deletion protection enabled. |
domain? | string | Directory ID for associating the DB cluster with a specific Active Directory. |
domain | IRole | The IAM role to be used when making API calls to the Directory Service. |
enable | boolean | Whether to enable the Data API for the cluster. |
iam | boolean | Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. |
instance | string | Base identifier for instances. |
instance | Instance | Settings for the individual instances that are launched. |
instance | Instance | The ordering of updates for instances. |
instances? | number | How many replicas/instances to create. |
monitoring | Duration | The interval, in seconds, between points when Amazon RDS collects enhanced monitoring metrics for the DB instances. |
monitoring | IRole | Role that will be used to manage DB instances monitoring. |
network | Network | The network type of the DB instance. |
parameter | IParameter | Additional parameters to pass to the database engine. |
parameters? | { [string]: string } | The parameters in the DBClusterParameterGroup to create automatically. |
port? | number | What port to listen on. |
preferred | string | A preferred maintenance window day/time range. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). |
readers? | ICluster [] | A list of instances to create as cluster reader instances. |
removal | Removal | The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update. |
s3 | IBucket [] | S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine. |
s3 | IRole | Role that will be associated with this DB cluster to enable S3 export. |
s3 | IBucket [] | S3 buckets that you want to load data from. This feature is only supported by the Aurora database engine. |
s3 | IRole | Role that will be associated with this DB cluster to enable S3 import. |
security | ISecurity [] | Security group. |
serverless | number | The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. |
serverless | number | The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. |
snapshot | Snapshot | Master user credentials. |
storage | boolean | Whether to enable storage encryption. |
storage | IKey | The KMS key for storage encryption. |
storage | DBCluster | The storage type to be associated with the DB cluster. |
subnet | ISubnet | Existing subnet group for the cluster. |
vpc? | IVpc | What subnets to run the RDS instances in. |
vpc | Subnet | Where to place the instances within the VPC. |
writer? | ICluster | The instance to use for the cluster writer. |
engine
Type:
ICluster
What kind of database to start.
snapshotIdentifier
Type:
string
The identifier for the DB instance snapshot or DB cluster snapshot to restore from.
You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB instance snapshot.
backtrackWindow?
Type:
Duration
(optional, default: 0 seconds (no backtrack))
The number of seconds to set a cluster's target backtrack window to.
This feature is only supported by the Aurora MySQL database engine and cannot be enabled on existing clusters.
See also: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Managing.Backtrack.html
backup?
Type:
Backup
(optional, default: Backup retention period for automated backups is 1 day.
Backup preferred window is set to a 30-minute window selected at random from an
8-hour block of time for each AWS Region, occurring on a random day of the week.)
Backup settings.
cloudwatchLogsExports?
Type:
string[]
(optional, default: no log exports)
The list of log types that need to be enabled for exporting to CloudWatch Logs.
cloudwatchLogsRetention?
Type:
Retention
(optional, default: logs never expire)
The number of days log events are kept in CloudWatch Logs.
When updating
this property, unsetting it doesn't remove the log retention policy. To
remove the retention policy, set the value to Infinity
.
cloudwatchLogsRetentionRole?
Type:
IRole
(optional, default: a new role is created.)
The IAM role for the Lambda function associated with the custom resource that sets the retention policy.
clusterIdentifier?
Type:
string
(optional, default: A name is automatically generated.)
An optional identifier for the cluster.
copyTagsToSnapshot?
Type:
boolean
(optional, default: true)
Whether to copy tags to the snapshot when a snapshot is created.
credentials?
⚠️ Deprecated: use snapshotCredentials
which allows to generate a new password
Type:
Credentials
(optional, default: A username of 'admin' (or 'postgres' for PostgreSQL) and SecretsManager-generated password
that will not be applied to the cluster, use snapshotCredentials
for the correct behavior.)
Credentials for the administrative user.
Note - using this prop only works with Credentials.fromPassword()
with the
username of the snapshot, Credentials.fromUsername()
with the username and
password of the snapshot or Credentials.fromSecret()
with a secret containing
the username and password of the snapshot.
defaultDatabaseName?
Type:
string
(optional, default: Database is not created in cluster.)
Name of a database which is automatically created inside the cluster.
deletionProtection?
Type:
boolean
(optional, default: true if removalPolicy
is RETAIN, undefined
otherwise, which will not enable deletion protection.
To disable deletion protection after it has been enabled, you must explicitly set this value to false
.)
Indicates whether the DB cluster should have deletion protection enabled.
domain?
Type:
string
(optional, default: DB cluster is not associated with an Active Directory; Kerberos authentication is not enabled.)
Directory ID for associating the DB cluster with a specific Active Directory.
Necessary for enabling Kerberos authentication. If specified, the DB cluster joins the given Active Directory, enabling Kerberos authentication. If not specified, the DB cluster will not be associated with any Active Directory, and Kerberos authentication will not be enabled.
domainRole?
Type:
IRole
(optional, default: If DatabaseClusterBaseProps.domain
is specified, a role with the AmazonRDSDirectoryServiceAccess
policy is automatically created.)
The IAM role to be used when making API calls to the Directory Service.
The role needs the AWS-managed policy
AmazonRDSDirectoryServiceAccess
or equivalent.
enableDataApi?
Type:
boolean
(optional, default: false)
Whether to enable the Data API for the cluster.
iamAuthentication?
Type:
boolean
(optional, default: false)
Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts.
instanceIdentifierBase?
Type:
string
(optional, default: clusterIdentifier is used with the word "Instance" appended.
If clusterIdentifier is not provided, the identifier is automatically generated.)
Base identifier for instances.
Every replica is named by appending the replica number to this string, 1-based.
instanceProps?
⚠️ Deprecated: - use writer and readers instead
Type:
Instance
(optional)
Settings for the individual instances that are launched.
instanceUpdateBehaviour?
Type:
Instance
(optional, default: InstanceUpdateBehaviour.BULK)
The ordering of updates for instances.
instances?
⚠️ Deprecated: - use writer and readers instead
Type:
number
(optional, default: 2)
How many replicas/instances to create.
Has to be at least 1.
monitoringInterval?
Type:
Duration
(optional, default: no enhanced monitoring)
The interval, in seconds, between points when Amazon RDS collects enhanced monitoring metrics for the DB instances.
monitoringRole?
Type:
IRole
(optional, default: A role is automatically created for you)
Role that will be used to manage DB instances monitoring.
networkType?
Type:
Network
(optional, default: IPV4)
The network type of the DB instance.
parameterGroup?
Type:
IParameter
(optional, default: No parameter group.)
Additional parameters to pass to the database engine.
parameters?
Type:
{ [string]: string }
(optional, default: None)
The parameters in the DBClusterParameterGroup to create automatically.
You can only specify parameterGroup or parameters but not both. You need to use a versioned engine to auto-generate a DBClusterParameterGroup.
port?
Type:
number
(optional, default: The default for the engine is used.)
What port to listen on.
preferredMaintenanceWindow?
Type:
string
(optional, default: 30-minute window selected at random from an 8-hour block of time for
each AWS Region, occurring on a random day of the week.)
A preferred maintenance window day/time range. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC).
Example: 'Sun:23:45-Mon:00:15'
readers?
Type:
ICluster
[]
(optional, default: no readers are created. The cluster will have a single writer/reader)
A list of instances to create as cluster reader instances.
removalPolicy?
Type:
Removal
(optional, default: RemovalPolicy.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data))
The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update.
s3ExportBuckets?
Type:
IBucket
[]
(optional, default: None)
S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine.
This property must not be used if s3ExportRole
is used.
For MySQL:
See also: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/postgresql-s3-export.html
s3ExportRole?
Type:
IRole
(optional, default: New role is created if s3ExportBuckets
is set, no role is defined otherwise)
Role that will be associated with this DB cluster to enable S3 export.
This feature is only supported by the Aurora database engine.
This property must not be used if s3ExportBuckets
is used.
To use this property with Aurora PostgreSQL, it must be configured with the S3 export feature enabled when creating the DatabaseClusterEngine
For MySQL:
See also: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/postgresql-s3-export.html
s3ImportBuckets?
Type:
IBucket
[]
(optional, default: None)
S3 buckets that you want to load data from. This feature is only supported by the Aurora database engine.
This property must not be used if s3ImportRole
is used.
For MySQL:
See also: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Migrating.html
s3ImportRole?
Type:
IRole
(optional, default: New role is created if s3ImportBuckets
is set, no role is defined otherwise)
Role that will be associated with this DB cluster to enable S3 import.
This feature is only supported by the Aurora database engine.
This property must not be used if s3ImportBuckets
is used.
To use this property with Aurora PostgreSQL, it must be configured with the S3 import feature enabled when creating the DatabaseClusterEngine
For MySQL:
See also: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Migrating.html
securityGroups?
Type:
ISecurity
[]
(optional, default: a new security group is created.)
Security group.
serverlessV2MaxCapacity?
Type:
number
(optional, default: 2)
The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster.
You can specify ACU values in half-step increments, such as 40, 40.5, 41, and so on. The largest value that you can use is 128 (256GB).
The maximum capacity must be higher than 0.5 ACUs.
serverlessV2MinCapacity?
Type:
number
(optional, default: 0.5)
The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster.
You can specify ACU values in half-step increments, such as 8, 8.5, 9, and so on. The smallest value that you can use is 0.5.
snapshotCredentials?
Type:
Snapshot
(optional, default: The existing username and password from the snapshot will be used.)
Master user credentials.
Note - It is not possible to change the master username for a snapshot; however, it is possible to provide (or generate) a new password.
storageEncrypted?
Type:
boolean
(optional, default: true if storageEncryptionKey is provided, false otherwise)
Whether to enable storage encryption.
storageEncryptionKey?
Type:
IKey
(optional, default: if storageEncrypted is true then the default master key, no key otherwise)
The KMS key for storage encryption.
If specified, storageEncrypted
will be set to true
.
storageType?
Type:
DBCluster
(optional, default: DBClusterStorageType.AURORA_IOPT1)
The storage type to be associated with the DB cluster.
subnetGroup?
Type:
ISubnet
(optional, default: a new subnet group will be created.)
Existing subnet group for the cluster.
vpc?
Type:
IVpc
(optional)
What subnets to run the RDS instances in.
Must be at least 2 subnets in two different AZs.
vpcSubnets?
Type:
Subnet
(optional, default: the Vpc default strategy if not specified.)
Where to place the instances within the VPC.
writer?
Type:
ICluster
(optional, default: required if instanceProps is not provided)
The instance to use for the cluster writer.