DatabaseClusterFromSnapshotProps (software.amazon.awscdk:aws-cdk-lib 2.56.0 API)

All Superinterfaces:: software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:: DatabaseClusterFromSnapshotProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.72.0 (build 4b8828b)",
           date="2022-12-21T20:29:03.109Z")
 @Stability(value=Stable)
public interface DatabaseClusterFromSnapshotProps
extends software.amazon.jsii.JsiiSerializable

Properties for ``DatabaseClusterFromSnapshot``.

Example:

 Vpc vpc;
 DatabaseClusterFromSnapshot.Builder.create(this, "Database")
         .engine(DatabaseClusterEngine.aurora(AuroraClusterEngineProps.builder().version(AuroraEngineVersion.VER_1_22_2).build()))
         .instanceProps(InstanceProps.builder()
                 .vpc(vpc)
                 .build())
         .snapshotIdentifier("mySnapshot")
         .build();

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`DatabaseClusterFromSnapshotProps.Builder` A builder for `DatabaseClusterFromSnapshotProps`
`static class`	`DatabaseClusterFromSnapshotProps.Jsii$Proxy` An implementation for `DatabaseClusterFromSnapshotProps`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`static DatabaseClusterFromSnapshotProps.Builder`	`builder()`
`default Duration`	`getBacktrackWindow()` The number of seconds to set a cluster's target backtrack window to.
`default BackupProps`	`getBackup()` Backup settings.
`default List<String>`	`getCloudwatchLogsExports()` The list of log types that need to be enabled for exporting to CloudWatch Logs.
`default RetentionDays`	`getCloudwatchLogsRetention()` The number of days log events are kept in CloudWatch Logs.
`default IRole`	`getCloudwatchLogsRetentionRole()` The IAM role for the Lambda function associated with the custom resource that sets the retention policy.
`default String`	`getClusterIdentifier()` An optional identifier for the cluster.
`default Boolean`	`getCopyTagsToSnapshot()` Whether to copy tags to the snapshot when a snapshot is created.
`default Credentials`	`getCredentials()` Deprecated. use `snapshotCredentials` which allows to generate a new password
`default String`	`getDefaultDatabaseName()` Name of a database which is automatically created inside the cluster.
`default Boolean`	`getDeletionProtection()` Indicates whether the DB cluster should have deletion protection enabled.
`IClusterEngine`	`getEngine()` What kind of database to start.
`default Boolean`	`getIamAuthentication()` Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts.
`default String`	`getInstanceIdentifierBase()` Base identifier for instances.
`InstanceProps`	`getInstanceProps()` Settings for the individual instances that are launched.
`default Number`	`getInstances()` How many replicas/instances to create.
`default InstanceUpdateBehaviour`	`getInstanceUpdateBehaviour()` The ordering of updates for instances.
`default Duration`	`getMonitoringInterval()` The interval, in seconds, between points when Amazon RDS collects enhanced monitoring metrics for the DB instances.
`default IRole`	`getMonitoringRole()` Role that will be used to manage DB instances monitoring.
`default NetworkType`	`getNetworkType()` The network type of the DB instance.
`default IParameterGroup`	`getParameterGroup()` Additional parameters to pass to the database engine.
`default Map<String,String>`	`getParameters()` The parameters in the DBClusterParameterGroup to create automatically.
`default Number`	`getPort()` What port to listen on.
`default String`	`getPreferredMaintenanceWindow()` A preferred maintenance window day/time range.
`default RemovalPolicy`	`getRemovalPolicy()` The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update.
`default List<IBucket>`	`getS3ExportBuckets()` S3 buckets that you want to load data into.
`default IRole`	`getS3ExportRole()` Role that will be associated with this DB cluster to enable S3 export.
`default List<IBucket>`	`getS3ImportBuckets()` S3 buckets that you want to load data from.
`default IRole`	`getS3ImportRole()` Role that will be associated with this DB cluster to enable S3 import.
`default SnapshotCredentials`	`getSnapshotCredentials()` Master user credentials.
`String`	`getSnapshotIdentifier()` The identifier for the DB instance snapshot or DB cluster snapshot to restore from.
`default Boolean`	`getStorageEncrypted()` Whether to enable storage encryption.
`default IKey`	`getStorageEncryptionKey()` The KMS key for storage encryption.
`default ISubnetGroup`	`getSubnetGroup()` Existing subnet group for the cluster.

Methods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson

- Method Detail
  - getEngine
```
@Stability(value=Stable)
 @NotNull
IClusterEngine getEngine()
```
    What kind of database to start.
  - getInstanceProps
```
@Stability(value=Stable)
 @NotNull
InstanceProps getInstanceProps()
```
    Settings for the individual instances that are launched.
  - getSnapshotIdentifier
```
@Stability(value=Stable)
 @NotNull
String getSnapshotIdentifier()
```
    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.
  - getBacktrackWindow
```
@Stability(value=Stable)
 @Nullable
default Duration getBacktrackWindow()
```
    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.
    Default: 0 seconds (no backtrack)
    
    See Also:
    
    https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Managing.Backtrack.html
  - getBackup
```
@Stability(value=Stable)
 @Nullable
default BackupProps getBackup()
```
    Backup settings.
    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.
    
    See Also:
    
    https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
  - getCloudwatchLogsExports
```
@Stability(value=Stable)
 @Nullable
default List<String> getCloudwatchLogsExports()
```
    The list of log types that need to be enabled for exporting to CloudWatch Logs.
    Default: - no log exports
  - getCloudwatchLogsRetention
```
@Stability(value=Stable)
 @Nullable
default RetentionDays getCloudwatchLogsRetention()
```
    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
  - getCloudwatchLogsRetentionRole
```
@Stability(value=Stable)
 @Nullable
default IRole getCloudwatchLogsRetentionRole()
```
    The IAM role for the Lambda function associated with the custom resource that sets the retention policy.
    Default: - a new role is created.
  - getClusterIdentifier
```
@Stability(value=Stable)
 @Nullable
default String getClusterIdentifier()
```
    An optional identifier for the cluster.
    Default: - A name is automatically generated.
  - getCopyTagsToSnapshot
```
@Stability(value=Stable)
 @Nullable
default Boolean getCopyTagsToSnapshot()
```
    Whether to copy tags to the snapshot when a snapshot is created.
    Default: - true
  - getCredentials
```
@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default Credentials getCredentials()
```
    Deprecated. use `snapshotCredentials` which allows to generate a new password
    
    (deprecated) 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.
    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.
  - getDefaultDatabaseName
```
@Stability(value=Stable)
 @Nullable
default String getDefaultDatabaseName()
```
    Name of a database which is automatically created inside the cluster.
    Default: - Database is not created in cluster.
  - getDeletionProtection
```
@Stability(value=Stable)
 @Nullable
default Boolean getDeletionProtection()
```
    Indicates whether the DB cluster should have deletion protection enabled.
    Default: - true if ``removalPolicy`` is RETAIN, false otherwise
  - getIamAuthentication
```
@Stability(value=Stable)
 @Nullable
default Boolean getIamAuthentication()
```
    Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts.
    Default: false
  - getInstanceIdentifierBase
```
@Stability(value=Stable)
 @Nullable
default String getInstanceIdentifierBase()
```
    Base identifier for instances.
    Every replica is named by appending the replica number to this string, 1-based.
    Default: - clusterIdentifier is used with the word "Instance" appended. If clusterIdentifier is not provided, the identifier is automatically generated.
  - getInstances
```
@Stability(value=Stable)
 @Nullable
default Number getInstances()
```
    How many replicas/instances to create.
    Has to be at least 1.
    Default: 2
  - getInstanceUpdateBehaviour
```
@Stability(value=Stable)
 @Nullable
default InstanceUpdateBehaviour getInstanceUpdateBehaviour()
```
    The ordering of updates for instances.
    Default: InstanceUpdateBehaviour.BULK
  - getMonitoringInterval
```
@Stability(value=Stable)
 @Nullable
default Duration getMonitoringInterval()
```
    The interval, in seconds, between points when Amazon RDS collects enhanced monitoring metrics for the DB instances.
    Default: no enhanced monitoring
  - getMonitoringRole
```
@Stability(value=Stable)
 @Nullable
default IRole getMonitoringRole()
```
    Role that will be used to manage DB instances monitoring.
    Default: - A role is automatically created for you
  - getNetworkType
```
@Stability(value=Stable)
 @Nullable
default NetworkType getNetworkType()
```
    The network type of the DB instance.
    Default: - IPV4
  - getParameterGroup
```
@Stability(value=Stable)
 @Nullable
default IParameterGroup getParameterGroup()
```
    Additional parameters to pass to the database engine.
    Default: - No parameter group.
  - getParameters
```
@Stability(value=Stable)
 @Nullable
default Map<String,String> getParameters()
```
    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.
    Default: - None
  - getPort
```
@Stability(value=Stable)
 @Nullable
default Number getPort()
```
    What port to listen on.
    Default: - The default for the engine is used.
  - getPreferredMaintenanceWindow
```
@Stability(value=Stable)
 @Nullable
default String getPreferredMaintenanceWindow()
```
    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'
    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.
    
    See Also:
    
    https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
  - getRemovalPolicy
```
@Stability(value=Stable)
 @Nullable
default RemovalPolicy getRemovalPolicy()
```
    The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update.
    Default: - RemovalPolicy.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data)
  - getS3ExportBuckets
```
@Stability(value=Stable)
 @Nullable
default List<IBucket> getS3ExportBuckets()
```
    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:
    Default: - None
    
    See Also:
    
    https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/postgresql-s3-export.html
  - getS3ExportRole
```
@Stability(value=Stable)
 @Nullable
default IRole getS3ExportRole()
```
    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.
    For MySQL:
    Default: - New role is created if `s3ExportBuckets` is set, no role is defined otherwise
    
    See Also:
    
    https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/postgresql-s3-export.html
  - getS3ImportBuckets
```
@Stability(value=Stable)
 @Nullable
default List<IBucket> getS3ImportBuckets()
```
    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:
    Default: - None
    
    See Also:
    
    https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Migrating.html
  - getS3ImportRole
```
@Stability(value=Stable)
 @Nullable
default IRole getS3ImportRole()
```
    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.
    For MySQL:
    Default: - New role is created if `s3ImportBuckets` is set, no role is defined otherwise
    
    See Also:
    
    https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Migrating.html
  - getSnapshotCredentials
```
@Stability(value=Stable)
 @Nullable
default SnapshotCredentials getSnapshotCredentials()
```
    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.
  - getStorageEncrypted
```
@Stability(value=Stable)
 @Nullable
default Boolean getStorageEncrypted()
```
    Whether to enable storage encryption.
    Default: - true if storageEncryptionKey is provided, false otherwise
  - getStorageEncryptionKey
```
@Stability(value=Stable)
 @Nullable
default IKey getStorageEncryptionKey()
```
    The KMS key for storage encryption.
    If specified, {@link storageEncrypted} will be set to true.
    Default: - if storageEncrypted is true then the default master key, no key otherwise
  - getSubnetGroup
```
@Stability(value=Stable)
 @Nullable
default ISubnetGroup getSubnetGroup()
```
    Existing subnet group for the cluster.
    Default: - a new subnet group will be created.
  - builder
```
@Stability(value=Stable)
static DatabaseClusterFromSnapshotProps.Builder builder()
```
    Returns:
    
    a DatabaseClusterFromSnapshotProps.Builder of DatabaseClusterFromSnapshotProps

Interface DatabaseClusterFromSnapshotProps

Nested Class Summary

Method Summary

Methods inherited from interface software.amazon.jsii.JsiiSerializable

Method Detail

getEngine

getInstanceProps

getSnapshotIdentifier

getBacktrackWindow

getBackup

getCloudwatchLogsExports

getCloudwatchLogsRetention

getCloudwatchLogsRetentionRole

getClusterIdentifier

getCopyTagsToSnapshot

getCredentials

getDefaultDatabaseName

getDeletionProtection

getIamAuthentication

getInstanceIdentifierBase

getInstances

getInstanceUpdateBehaviour

getMonitoringInterval

getMonitoringRole

getNetworkType

getParameterGroup

getParameters

getPort

getPreferredMaintenanceWindow

getRemovalPolicy

getS3ExportBuckets

getS3ExportRole

getS3ImportBuckets

getS3ImportRole

getSnapshotCredentials

getStorageEncrypted

getStorageEncryptionKey

getSubnetGroup

builder