AWS Fundamentals Logo
AWS Fundamentals
L2 Construct

DatabaseInstanceFromSnapshot

A database instance restored from a snapshot.

Import

import { DatabaseInstanceFromSnapshot } from 'aws-cdk-lib/aws-rds';

Or use the module namespace:

import * as rds from 'aws-cdk-lib/aws-rds';
// rds.DatabaseInstanceFromSnapshot

Properties

Configuration passed to the constructor as DatabaseInstanceFromSnapshotProps.

clusterSnapshotIdentifierOptional
string

The identifier for the Multi-AZ DB cluster snapshot to restore from. For more information on Multi-AZ DB clusters, see [Multi-AZ DB cluster deployments](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) in the *Amazon RDS User Guide* . Constraints: - Can't be specified when `snapshotIdentifier` is specified. - Must be specified when `snapshotIdentifier` isn't specified. - If you are restoring from a shared manual Multi-AZ DB cluster snapshot, the `clusterSnapshotIdentifier` must be the ARN of the shared snapshot. - Can't be the identifier of an Aurora DB cluster snapshot.

Default: - None

credentialsOptional
SnapshotCredentials

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.

Default: - The existing username and password from the snapshot will be used.

snapshotIdentifierOptional
string

The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance. If you're restoring from a shared manual DB snapshot, you must specify the ARN of the snapshot. Constraints: - Can't be specified when `clusterSnapshotIdentifier` is specified. - Must be specified when `clusterSnapshotIdentifier` isn't specified.

Default: - None

8 properties inherited from DatabaseInstanceSourceProps
engineRequiredinherited from DatabaseInstanceSourceProps
IInstanceEngine

The database engine.

allocatedStorageOptionalinherited from DatabaseInstanceSourceProps
number

The allocated storage size, specified in gibibytes (GiB).

Default: 100

allowMajorVersionUpgradeOptionalinherited from DatabaseInstanceSourceProps
boolean

Whether to allow major version upgrades.

Default: false

databaseNameOptionalinherited from DatabaseInstanceSourceProps
string

The name of the database.

Default: - no name

instanceTypeOptionalinherited from DatabaseInstanceSourceProps
InstanceType

The name of the compute and memory capacity for the instance.

Default: - m5.large (or, more specifically, db.m5.large)

licenseModelOptionalinherited from DatabaseInstanceSourceProps
LicenseModel

The license model.

Default: - RDS default license model

parametersOptionalinherited from DatabaseInstanceSourceProps
{ [key: string]: string }

The parameters in the DBParameterGroup to create automatically. You can only specify parameterGroup or parameters but not both. You need to use a versioned engine to auto-generate a DBParameterGroup.

Default: - None

timezoneOptionalinherited from DatabaseInstanceSourceProps
string

The time zone of the instance. This is currently supported only by Microsoft Sql Server.

Default: - RDS default timezone

44 properties inherited from DatabaseInstanceNewProps
vpcRequiredinherited from DatabaseInstanceNewProps
IVpc

The VPC network where the DB subnet group should be created.

applyImmediatelyOptionalinherited from DatabaseInstanceNewProps
boolean

Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the `preferredMaintenanceWindow` setting. If set to `false`, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.

Default: - Changes will be applied immediately

autoMinorVersionUpgradeOptionalinherited from DatabaseInstanceNewProps
boolean

Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.

Default: true

availabilityZoneOptionalinherited from DatabaseInstanceNewProps
string

The name of the Availability Zone where the DB instance will be located.

Default: - no preference

backupRetentionOptionalinherited from DatabaseInstanceNewProps
Duration

The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero.

Default: - Duration.days(1) for source instances, disabled for read replicas

caCertificateOptionalinherited from DatabaseInstanceNewProps
CaCertificate

The identifier of the CA certificate for this DB instance. Specifying or updating this property triggers a reboot. For RDS DB engines:

Default: - RDS will choose a certificate authority

cloudwatchLogsExportsOptionalinherited from DatabaseInstanceNewProps
string[]

The list of log types that need to be enabled for exporting to CloudWatch Logs.

Default: - no log exports

cloudwatchLogsRetentionOptionalinherited from DatabaseInstanceNewProps
RetentionDays

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`.

Default: - logs never expire

cloudwatchLogsRetentionRoleOptionalinherited from DatabaseInstanceNewProps
IRole

The IAM role for the Lambda function associated with the custom resource that sets the retention policy.

Default: - a new role is created.

copyTagsToSnapshotOptionalinherited from DatabaseInstanceNewProps
boolean

Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance.

Default: true

databaseInsightsModeOptionalinherited from DatabaseInstanceNewProps
DatabaseInsightsMode

The database insights mode.

Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.

deleteAutomatedBackupsOptionalinherited from DatabaseInstanceNewProps
boolean

Indicates whether automated backups should be deleted or retained when you delete a DB instance.

Default: true

deletionProtectionOptionalinherited from DatabaseInstanceNewProps
boolean

Indicates whether the DB instance should have deletion protection enabled.

Default: - true if ``removalPolicy`` is RETAIN, false otherwise

domainOptionalinherited from DatabaseInstanceNewProps
string

The Active Directory directory ID to create the DB instance in.

Default: - Do not join domain

domainRoleOptionalinherited from DatabaseInstanceNewProps
IRoleRef

The IAM role to be used when making API calls to the Directory Service. The role needs the AWS-managed policy AmazonRDSDirectoryServiceAccess or equivalent.

Default: - The role will be created for you if `DatabaseInstanceNewProps#domain` is specified

enablePerformanceInsightsOptionalinherited from DatabaseInstanceNewProps
boolean

Whether to enable Performance Insights for the DB instance.

Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set.

engineLifecycleSupportOptionalinherited from DatabaseInstanceNewProps
EngineLifecycleSupport

The life cycle type for this DB instance. This setting applies only to RDS for MySQL and RDS for PostgreSQL.

Default: undefined - AWS RDS default setting is `EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT`

iamAuthenticationOptionalinherited from DatabaseInstanceNewProps
boolean

Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts.

Default: false

instanceIdentifierOptionalinherited from DatabaseInstanceNewProps
string

A name for the DB instance. If you specify a name, AWS CloudFormation converts it to lowercase.

Default: - a CloudFormation generated name

iopsOptionalinherited from DatabaseInstanceNewProps
number

The number of I/O operations per second (IOPS) that the database provisions. The value must be equal to or greater than 1000.

Default: - no provisioned iops if storage type is not specified. For GP3: 3,000 IOPS if allocated storage is less than 400 GiB for MariaDB, MySQL, and PostgreSQL, less than 200 GiB for Oracle and less than 20 GiB for SQL Server. 12,000 IOPS otherwise (except for SQL Server where the default is always 3,000 IOPS).

maxAllocatedStorageOptionalinherited from DatabaseInstanceNewProps
number

Upper limit to which RDS can scale the storage in GiB(Gibibyte).

Default: - No autoscaling of RDS instance

monitoringIntervalOptionalinherited from DatabaseInstanceNewProps
Duration

The interval, in seconds, between points when Amazon RDS collects enhanced monitoring metrics for the DB instance.

Default: - no enhanced monitoring

monitoringRoleOptionalinherited from DatabaseInstanceNewProps
IRoleRef

Role that will be used to manage DB instance monitoring.

Default: - A role is automatically created for you

multiAzOptionalinherited from DatabaseInstanceNewProps
boolean

Specifies if the database instance is a multiple Availability Zone deployment.

Default: false

networkTypeOptionalinherited from DatabaseInstanceNewProps
NetworkType

The network type of the DB instance.

Default: - IPV4

optionGroupOptionalinherited from DatabaseInstanceNewProps
IOptionGroup

The option group to associate with the instance.

Default: - no option group

parameterGroupOptionalinherited from DatabaseInstanceNewProps
IParameterGroup

The DB parameter group to associate with the instance.

Default: - no parameter group

performanceInsightEncryptionKeyOptionalinherited from DatabaseInstanceNewProps
IKeyRef

The AWS KMS key for encryption of Performance Insights data.

Default: - default master key

performanceInsightRetentionOptionalinherited from DatabaseInstanceNewProps
PerformanceInsightRetention

The amount of time, in days, to retain Performance Insights data. If you set `databaseInsightsMode` to `DatabaseInsightsMode.ADVANCED`, you must set this property to `PerformanceInsightRetention.MONTHS_15`.

Default: 7 this is the free tier

portOptionalinherited from DatabaseInstanceNewProps
number

The port for the instance.

Default: - the default port for the chosen engine.

preferredBackupWindowOptionalinherited from DatabaseInstanceNewProps
string

The daily time range during which automated backups are performed. Constraints: - Must be in the format `hh24:mi-hh24:mi`. - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes.

Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow

preferredMaintenanceWindowOptionalinherited from DatabaseInstanceNewProps
string

The weekly time range (in UTC) during which system maintenance can occur. Format: `ddd:hh24:mi-ddd:hh24:mi` Constraint: Minimum 30-minute window

Default: - 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. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance

processorFeaturesOptionalinherited from DatabaseInstanceNewProps
ProcessorFeatures

The number of CPU cores and the number of threads per core.

Default: - the default number of CPU cores and threads per core for the chosen instance class. See https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#USER_ConfigureProcessor

publiclyAccessibleOptionalinherited from DatabaseInstanceNewProps
boolean

Indicates whether the DB instance is an internet-facing instance. If not specified, the instance's vpcSubnets will be used to determine if the instance is internet-facing or not.

Default: - `true` if the instance's `vpcSubnets` is `subnetType: SubnetType.PUBLIC`, `false` otherwise

removalPolicyOptionalinherited from DatabaseInstanceNewProps
RemovalPolicy

The CloudFormation policy to apply when the instance is removed from the stack or replaced during an update.

Default: - RemovalPolicy.SNAPSHOT (remove the resource, but retain a snapshot of the data)

s3ExportBucketsOptionalinherited from DatabaseInstanceNewProps
IBucket[]

S3 buckets that you want to load data into. This property must not be used if `s3ExportRole` is used. For Microsoft SQL Server:

Default: - None

s3ExportRoleOptionalinherited from DatabaseInstanceNewProps
IRole

Role that will be associated with this DB instance to enable S3 export. This property must not be used if `s3ExportBuckets` is used. For Microsoft SQL Server:

Default: - New role is created if `s3ExportBuckets` is set, no role is defined otherwise

s3ImportBucketsOptionalinherited from DatabaseInstanceNewProps
IBucket[]

S3 buckets that you want to load data from. This feature is only supported by the Microsoft SQL Server, Oracle, and PostgreSQL engines. This property must not be used if `s3ImportRole` is used. For Microsoft SQL Server:

Default: - None

s3ImportRoleOptionalinherited from DatabaseInstanceNewProps
IRole

Role that will be associated with this DB instance to enable S3 import. This feature is only supported by the Microsoft SQL Server, Oracle, and PostgreSQL engines. This property must not be used if `s3ImportBuckets` is used. For Microsoft SQL Server:

Default: - New role is created if `s3ImportBuckets` is set, no role is defined otherwise

securityGroupsOptionalinherited from DatabaseInstanceNewProps
ISecurityGroup[]

The security groups to assign to the DB instance.

Default: - a new security group is created

storageThroughputOptionalinherited from DatabaseInstanceNewProps
number

The storage throughput, specified in mebibytes per second (MiBps). Only applicable for GP3.

Default: - 125 MiBps if allocated storage is less than 400 GiB for MariaDB, MySQL, and PostgreSQL, less than 200 GiB for Oracle and less than 20 GiB for SQL Server. 500 MiBps otherwise (except for SQL Server where the default is always 125 MiBps).

storageTypeOptionalinherited from DatabaseInstanceNewProps
StorageType

The storage type to associate with the DB instance. Storage types supported are gp2, gp3, io1, io2, and standard.

Default: StorageType.GP2

subnetGroupOptionalinherited from DatabaseInstanceNewProps
IDBSubnetGroupRef

Existing subnet group for the instance.

Default: - a new subnet group will be created.

vpcSubnetsOptionalinherited from DatabaseInstanceNewProps
SubnetSelection

The type of subnets to add to the created DB subnet group.

Default: - private subnets

Get the Amazon RDS Cheat Sheet

Everything you need to know about Amazon RDS on one page. HD quality, print-friendly.

Download Free Infographic