Class DatabaseInstanceFromSnapshotProps
Construction properties for a DatabaseInstanceFromSnapshot.
Inheritance
Implements
Namespace: Amazon.CDK.AWS.RDS
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public class DatabaseInstanceFromSnapshotProps : Object, IDatabaseInstanceFromSnapshotProps, IDatabaseInstanceSourceProps, IDatabaseInstanceNewProps
Syntax (vb)
Public Class DatabaseInstanceFromSnapshotProps
Inherits Object
Implements IDatabaseInstanceFromSnapshotProps, IDatabaseInstanceSourceProps, IDatabaseInstanceNewProps
Remarks
ExampleMetadata: infused
Examples
Vpc vpc;
DatabaseInstance sourceInstance;
new DatabaseInstanceFromSnapshot(this, "Instance", new DatabaseInstanceFromSnapshotProps {
SnapshotIdentifier = "my-snapshot",
Engine = DatabaseInstanceEngine.Postgres(new PostgresInstanceEngineProps { Version = PostgresEngineVersion.VER_15_2 }),
// optional, defaults to m5.large
InstanceType = InstanceType.Of(InstanceClass.BURSTABLE2, InstanceSize.LARGE),
Vpc = vpc
});
new DatabaseInstanceReadReplica(this, "ReadReplica", new DatabaseInstanceReadReplicaProps {
SourceDatabaseInstance = sourceInstance,
InstanceType = InstanceType.Of(InstanceClass.BURSTABLE2, InstanceSize.LARGE),
Vpc = vpc
});
Synopsis
Constructors
DatabaseInstanceFromSnapshotProps() |
Properties
AllocatedStorage | The allocated storage size, specified in gibibytes (GiB). |
AllowMajorVersionUpgrade | Whether to allow major version upgrades. |
AutoMinorVersionUpgrade | Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. |
AvailabilityZone | The name of the Availability Zone where the DB instance will be located. |
BackupRetention | The number of days during which automatic DB snapshots are retained. |
CaCertificate | The identifier of the CA certificate for this DB instance. |
CloudwatchLogsExports | The list of log types that need to be enabled for exporting to CloudWatch Logs. |
CloudwatchLogsRetention | The number of days log events are kept in CloudWatch Logs. |
CloudwatchLogsRetentionRole | The IAM role for the Lambda function associated with the custom resource that sets the retention policy. |
CopyTagsToSnapshot | Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. |
Credentials | Master user credentials. |
DatabaseName | The name of the database. |
DeleteAutomatedBackups | Indicates whether automated backups should be deleted or retained when you delete a DB instance. |
DeletionProtection | Indicates whether the DB instance should have deletion protection enabled. |
Domain | The Active Directory directory ID to create the DB instance in. |
DomainRole | The IAM role to be used when making API calls to the Directory Service. |
EnablePerformanceInsights | Whether to enable Performance Insights for the DB instance. |
Engine | The database engine. |
IamAuthentication | Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. |
InstanceIdentifier | A name for the DB instance. |
InstanceType | The name of the compute and memory capacity for the instance. |
Iops | The number of I/O operations per second (IOPS) that the database provisions. |
LicenseModel | The license model. |
MaxAllocatedStorage | Upper limit to which RDS can scale the storage in GiB(Gibibyte). |
MonitoringInterval | The interval, in seconds, between points when Amazon RDS collects enhanced monitoring metrics for the DB instance. |
MonitoringRole | Role that will be used to manage DB instance monitoring. |
MultiAz | Specifies if the database instance is a multiple Availability Zone deployment. |
NetworkType | The network type of the DB instance. |
OptionGroup | The option group to associate with the instance. |
ParameterGroup | The DB parameter group to associate with the instance. |
Parameters | The parameters in the DBParameterGroup to create automatically. |
PerformanceInsightEncryptionKey | The AWS KMS key for encryption of Performance Insights data. |
PerformanceInsightRetention | The amount of time, in days, to retain Performance Insights data. |
Port | The port for the instance. |
PreferredBackupWindow | The daily time range during which automated backups are performed. |
PreferredMaintenanceWindow | The weekly time range (in UTC) during which system maintenance can occur. |
ProcessorFeatures | The number of CPU cores and the number of threads per core. |
PubliclyAccessible | Indicates whether the DB instance is an internet-facing instance. |
RemovalPolicy | The CloudFormation policy to apply when the instance is removed from the stack or replaced during an update. |
S3ExportBuckets | S3 buckets that you want to load data into. |
S3ExportRole | Role that will be associated with this DB instance to enable S3 export. |
S3ImportBuckets | S3 buckets that you want to load data from. |
S3ImportRole | Role that will be associated with this DB instance to enable S3 import. |
SecurityGroups | The security groups to assign to the DB instance. |
SnapshotIdentifier | The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance. |
StorageThroughput | The storage throughput, specified in mebibytes per second (MiBps). |
StorageType | The storage type. |
SubnetGroup | Existing subnet group for the instance. |
Timezone | The time zone of the instance. |
Vpc | The VPC network where the DB subnet group should be created. |
VpcSubnets | The type of subnets to add to the created DB subnet group. |
Constructors
DatabaseInstanceFromSnapshotProps()
public DatabaseInstanceFromSnapshotProps()
Properties
AllocatedStorage
The allocated storage size, specified in gibibytes (GiB).
public Nullable<double> AllocatedStorage { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
Default: 100
AllowMajorVersionUpgrade
Whether to allow major version upgrades.
public Nullable<bool> AllowMajorVersionUpgrade { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: false
AutoMinorVersionUpgrade
Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.
public Nullable<bool> AutoMinorVersionUpgrade { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: true
AvailabilityZone
The name of the Availability Zone where the DB instance will be located.
public string AvailabilityZone { get; set; }
Property Value
System.String
Remarks
Default: - no preference
BackupRetention
The number of days during which automatic DB snapshots are retained.
public Duration BackupRetention { get; set; }
Property Value
Remarks
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
CaCertificate
The identifier of the CA certificate for this DB instance.
public CaCertificate CaCertificate { get; set; }
Property Value
Remarks
Specifying or updating this property triggers a reboot.
For RDS DB engines:
Default: - RDS will choose a certificate authority
CloudwatchLogsExports
The list of log types that need to be enabled for exporting to CloudWatch Logs.
public string[] CloudwatchLogsExports { get; set; }
Property Value
System.String[]
Remarks
Default: - no log exports
CloudwatchLogsRetention
The number of days log events are kept in CloudWatch Logs.
public Nullable<RetentionDays> CloudwatchLogsRetention { get; set; }
Property Value
System.Nullable<RetentionDays>
Remarks
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
The IAM role for the Lambda function associated with the custom resource that sets the retention policy.
public IRole CloudwatchLogsRetentionRole { get; set; }
Property Value
Remarks
Default: - a new role is created.
CopyTagsToSnapshot
Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance.
public Nullable<bool> CopyTagsToSnapshot { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: true
Credentials
Master user credentials.
public SnapshotCredentials Credentials { get; set; }
Property Value
Remarks
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.
DatabaseName
The name of the database.
public string DatabaseName { get; set; }
Property Value
System.String
Remarks
Default: - no name
DeleteAutomatedBackups
Indicates whether automated backups should be deleted or retained when you delete a DB instance.
public Nullable<bool> DeleteAutomatedBackups { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: true
DeletionProtection
Indicates whether the DB instance should have deletion protection enabled.
public Nullable<bool> DeletionProtection { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: - true if removalPolicy
is RETAIN, false otherwise
Domain
The Active Directory directory ID to create the DB instance in.
public string Domain { get; set; }
Property Value
System.String
Remarks
Default: - Do not join domain
DomainRole
The IAM role to be used when making API calls to the Directory Service.
public IRole DomainRole { get; set; }
Property Value
Remarks
The role needs the AWS-managed policy AmazonRDSDirectoryServiceAccess or equivalent.
Default: - The role will be created for you if DatabaseInstanceNewProps#domain
is specified
EnablePerformanceInsights
Whether to enable Performance Insights for the DB instance.
public Nullable<bool> EnablePerformanceInsights { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: - false, unless performanceInsightRetention
or performanceInsightEncryptionKey
is set.
Engine
IamAuthentication
Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts.
public Nullable<bool> IamAuthentication { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: false
InstanceIdentifier
A name for the DB instance.
public string InstanceIdentifier { get; set; }
Property Value
System.String
Remarks
If you specify a name, AWS CloudFormation converts it to lowercase.
Default: - a CloudFormation generated name
InstanceType
The name of the compute and memory capacity for the instance.
public InstanceType InstanceType { get; set; }
Property Value
Remarks
Default: - m5.large (or, more specifically, db.m5.large)
Iops
The number of I/O operations per second (IOPS) that the database provisions.
public Nullable<double> Iops { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
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).
LicenseModel
The license model.
public Nullable<LicenseModel> LicenseModel { get; set; }
Property Value
System.Nullable<LicenseModel>
Remarks
Default: - RDS default license model
MaxAllocatedStorage
Upper limit to which RDS can scale the storage in GiB(Gibibyte).
public Nullable<double> MaxAllocatedStorage { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
Default: - No autoscaling of RDS instance
MonitoringInterval
The interval, in seconds, between points when Amazon RDS collects enhanced monitoring metrics for the DB instance.
public Duration MonitoringInterval { get; set; }
Property Value
Remarks
Default: - no enhanced monitoring
MonitoringRole
Role that will be used to manage DB instance monitoring.
public IRole MonitoringRole { get; set; }
Property Value
Remarks
Default: - A role is automatically created for you
MultiAz
Specifies if the database instance is a multiple Availability Zone deployment.
public Nullable<bool> MultiAz { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: false
NetworkType
The network type of the DB instance.
public Nullable<NetworkType> NetworkType { get; set; }
Property Value
System.Nullable<NetworkType>
Remarks
Default: - IPV4
OptionGroup
The option group to associate with the instance.
public IOptionGroup OptionGroup { get; set; }
Property Value
Remarks
Default: - no option group
ParameterGroup
The DB parameter group to associate with the instance.
public IParameterGroup ParameterGroup { get; set; }
Property Value
Remarks
Default: - no parameter group
Parameters
The parameters in the DBParameterGroup to create automatically.
public IDictionary<string, string> Parameters { get; set; }
Property Value
System.Collections.Generic.IDictionary<System.String, System.String>
Remarks
You can only specify parameterGroup or parameters but not both. You need to use a versioned engine to auto-generate a DBParameterGroup.
Default: - None
PerformanceInsightEncryptionKey
The AWS KMS key for encryption of Performance Insights data.
public IKey PerformanceInsightEncryptionKey { get; set; }
Property Value
Remarks
Default: - default master key
PerformanceInsightRetention
The amount of time, in days, to retain Performance Insights data.
public Nullable<PerformanceInsightRetention> PerformanceInsightRetention { get; set; }
Property Value
System.Nullable<PerformanceInsightRetention>
Remarks
Default: 7 this is the free tier
Port
The port for the instance.
public Nullable<double> Port { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
Default: - the default port for the chosen engine.
PreferredBackupWindow
The daily time range during which automated backups are performed.
public string PreferredBackupWindow { get; set; }
Property Value
System.String
Remarks
Constraints:
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
PreferredMaintenanceWindow
The weekly time range (in UTC) during which system maintenance can occur.
public string PreferredMaintenanceWindow { get; set; }
Property Value
System.String
Remarks
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
ProcessorFeatures
The number of CPU cores and the number of threads per core.
public IProcessorFeatures ProcessorFeatures { get; set; }
Property Value
Remarks
Default: - the default number of CPU cores and threads per core for the chosen instance class.
PubliclyAccessible
Indicates whether the DB instance is an internet-facing instance.
public Nullable<bool> PubliclyAccessible { get; set; }
Property Value
System.Nullable<System.Boolean>
Remarks
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
RemovalPolicy
The CloudFormation policy to apply when the instance is removed from the stack or replaced during an update.
public Nullable<RemovalPolicy> RemovalPolicy { get; set; }
Property Value
System.Nullable<RemovalPolicy>
Remarks
Default: - RemovalPolicy.SNAPSHOT (remove the resource, but retain a snapshot of the data)
S3ExportBuckets
S3 buckets that you want to load data into.
public IBucket[] S3ExportBuckets { get; set; }
Property Value
IBucket[]
Remarks
This property must not be used if s3ExportRole
is used.
For Microsoft SQL Server:
Default: - None
See: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-s3-integration.html
S3ExportRole
Role that will be associated with this DB instance to enable S3 export.
public IRole S3ExportRole { get; set; }
Property Value
Remarks
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
See: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-s3-integration.html
S3ImportBuckets
S3 buckets that you want to load data from.
public IBucket[] S3ImportBuckets { get; set; }
Property Value
IBucket[]
Remarks
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
See: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/PostgreSQL.Procedural.Importing.html
S3ImportRole
Role that will be associated with this DB instance to enable S3 import.
public IRole S3ImportRole { get; set; }
Property Value
Remarks
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
See: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/PostgreSQL.Procedural.Importing.html
SecurityGroups
The security groups to assign to the DB instance.
public ISecurityGroup[] SecurityGroups { get; set; }
Property Value
Remarks
Default: - a new security group is created
SnapshotIdentifier
The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance.
public string SnapshotIdentifier { get; set; }
Property Value
System.String
Remarks
If you're restoring from a shared manual DB snapshot, you must specify the ARN of the snapshot.
StorageThroughput
The storage throughput, specified in mebibytes per second (MiBps).
public Nullable<double> StorageThroughput { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
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).
See: https://docs.aws.amazon.com//AmazonRDS/latest/UserGuide/CHAP_Storage.html#gp3-storage
StorageType
The storage type.
public Nullable<StorageType> StorageType { get; set; }
Property Value
System.Nullable<StorageType>
Remarks
Storage types supported are gp2, io1, standard.
Default: GP2
See: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#Concepts.Storage.GeneralSSD
SubnetGroup
Existing subnet group for the instance.
public ISubnetGroup SubnetGroup { get; set; }
Property Value
Remarks
Default: - a new subnet group will be created.
Timezone
The time zone of the instance.
public string Timezone { get; set; }
Property Value
System.String
Remarks
This is currently supported only by Microsoft Sql Server.
Default: - RDS default timezone
Vpc
The VPC network where the DB subnet group should be created.
public IVpc Vpc { get; set; }
Property Value
VpcSubnets
The type of subnets to add to the created DB subnet group.
public ISubnetSelection VpcSubnets { get; set; }
Property Value
Remarks
Default: - private subnets