Hierarchy

  • Omit<DatabaseInstanceProps, "instanceType">
  • AppIdentity
    • GuDatabaseInstanceProps

Properties

allocatedStorage?: number

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

Default

100

allowMajorVersionUpgrade?: boolean

Whether to allow major version upgrades.

Default

false

app: string
autoMinorVersionUpgrade?: boolean

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

Default

true

availabilityZone?: string

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

Default

  • no preference
backupRetention?: 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
characterSetName?: string

For supported engines, specifies the character set to associate with the DB instance.

Default

  • RDS default character set name
cloudwatchLogsExports?: string[]

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

Default

  • no log exports
cloudwatchLogsRetention?: 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
cloudwatchLogsRetentionRole?: IRole

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

Default

  • a new role is created.
copyTagsToSnapshot?: boolean

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

Default

true

credentials?: Credentials

Credentials for the administrative user

Default

  • A username of 'admin' (or 'postgres' for PostgreSQL) and SecretsManager-generated password
databaseName?: string

The name of the database.

Default

  • no name
deleteAutomatedBackups?: boolean

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

Default

false

deletionProtection?: boolean

Indicates whether the DB instance should have deletion protection enabled.

Default

  • true if removalPolicy is RETAIN, false otherwise
domain?: string

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

Default

  • Do not join domain
domainRole?: IRole

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
enablePerformanceInsights?: boolean

Whether to enable Performance Insights for the DB instance.

Default

  • false, unless performanceInsightRentention or performanceInsightEncryptionKey is set.
engine: IInstanceEngine

The database engine.

iamAuthentication?: boolean

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

Default

false

instanceIdentifier?: string

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

Default

  • a CloudFormation generated name
instanceType: string
iops?: 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
licenseModel?: LicenseModel

The license model.

Default

  • RDS default license model
maxAllocatedStorage?: number

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

See

https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling

Default

  • No autoscaling of RDS instance
monitoringInterval?: Duration

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

Default

  • no enhanced monitoring
monitoringRole?: IRole

Role that will be used to manage DB instance monitoring.

Default

  • A role is automatically created for you
multiAz?: boolean

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

Default

false

optionGroup?: IOptionGroup

The option group to associate with the instance.

Default

  • no option group
parameterGroup?: IParameterGroup

The DB parameter group to associate with the instance.

Default

  • no parameter group
parameters?: { [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

Type declaration

  • [key: string]: string
performanceInsightEncryptionKey?: IKey

The AWS KMS key for encryption of Performance Insights data.

Default

  • default master key
performanceInsightRetention?: PerformanceInsightRetention

The amount of time, in days, to retain Performance Insights data.

Default

7

port?: number

The port for the instance.

Default

  • the default port for the chosen engine.
preferredBackupWindow?: 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

preferredMaintenanceWindow?: 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

processorFeatures?: 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

publiclyAccessible?: boolean

Indicates whether the DB instance is an internet-facing instance.

Default

  • true if vpcSubnets is subnetType: SubnetType.PUBLIC, false otherwise
removalPolicy?: 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)
s3ExportBuckets?: IBucket[]

S3 buckets that you want to load data into.

This property must not be used if s3ExportRole is used.

For Microsoft SQL Server:

See

Default

  • None
s3ExportRole?: 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:

See

Default

  • New role is created if s3ExportBuckets is set, no role is defined otherwise
s3ImportBuckets?: 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:

See

Default

  • None
s3ImportRole?: 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:

See

Default

  • New role is created if s3ImportBuckets is set, no role is defined otherwise
securityGroups?: ISecurityGroup[]

The security groups to assign to the DB instance.

Default

  • a new security group is created
storageEncrypted?: boolean

Indicates whether the DB instance is encrypted.

Default

  • true if storageEncryptionKey has been provided, false otherwise
storageEncryptionKey?: IKey

The KMS key that's used to encrypt the DB instance.

Default

  • default master key if storageEncrypted is true, no key otherwise
storageType?: StorageType

The storage type. Storage types supported are gp2, io1, standard.

See

https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#Concepts.Storage.GeneralSSD

Default

GP2

subnetGroup?: ISubnetGroup

Existing subnet group for the instance.

Default

  • a new subnet group will be created.
timezone?: string

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

Default

  • RDS default timezone
vpc: IVpc

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

vpcSubnets?: SubnetSelection

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

Default

  • private subnets

Generated using TypeDoc