DatabaseClusterProps

All Known Implementing Classes:: DatabaseClusterProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.58.0 (build f8ba112)",
           date="2022-05-27T16:28:01.870Z")
public interface DatabaseClusterProps

Properties for a new database cluster.

Example:

 Vpc vpc;
 DatabaseCluster cluster = DatabaseCluster.Builder.create(this, "Database")
         .masterUser(Login.builder()
                 .username("myuser") // NOTE: 'admin' is reserved by DocumentDB
                 .excludeCharacters("\"@/:") // optional, defaults to the set "\"@/" and is also used for eventually created rotations
                 .secretName("/myapp/mydocdb/masteruser")
                 .build())
         .instanceType(InstanceType.of(InstanceClass.R5, InstanceSize.LARGE))
         .vpcSubnets(SubnetSelection.builder()
                 .subnetType(SubnetType.PUBLIC)
                 .build())
         .vpc(vpc)
         .build();

Nested Class Summary

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

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`static DatabaseClusterProps.Builder`	`builder()`
`default BackupProps`	`getBackup()` Backup settings.
`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 java.lang.String`	`getDbClusterName()` An optional identifier for the cluster.
`default java.lang.Boolean`	`getDeletionProtection()` Specifies whether this cluster can be deleted.
`default java.lang.String`	`getEngineVersion()` What version of the database to start.
`default java.lang.Boolean`	`getExportAuditLogsToCloudWatch()` Whether the audit logs should be exported to CloudWatch.
`default java.lang.Boolean`	`getExportProfilerLogsToCloudWatch()` Whether the profiler logs should be exported to CloudWatch.
`default java.lang.String`	`getInstanceIdentifierBase()` Base identifier for instances.
`default java.lang.Number`	`getInstances()` Number of DocDB compute instances.
`InstanceType`	`getInstanceType()` What type of instance to start for the replicas.
`default IKey`	`getKmsKey()` The KMS key for storage encryption.
`Login`	`getMasterUser()` Username and password for the administrative user.
`default IClusterParameterGroup`	`getParameterGroup()` The DB parameter group to associate with the instance.
`default java.lang.Number`	`getPort()` The port the DocumentDB cluster will listen on.
`default java.lang.String`	`getPreferredMaintenanceWindow()` A weekly time range in which maintenance should preferably execute.
`default RemovalPolicy`	`getRemovalPolicy()` The removal policy to apply when the cluster and its instances are removed or replaced during a stack update, or when the stack is deleted.
`default ISecurityGroup`	`getSecurityGroup()` Security group.
`default java.lang.Boolean`	`getStorageEncrypted()` Whether to enable storage encryption.
`IVpc`	`getVpc()` What subnets to run the DocumentDB instances in.
`default SubnetSelection`	`getVpcSubnets()` Where to place the instances within the VPC.

- Method Detail
  - getInstanceType
```
InstanceType getInstanceType()
```
    What type of instance to start for the replicas.
  - getMasterUser
```
Login getMasterUser()
```
    Username and password for the administrative user.
  - getVpc
```
IVpc getVpc()
```
    What subnets to run the DocumentDB instances in.
    Must be at least 2 subnets in two different AZs.
  - getBackup
```
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/documentdb/latest/developerguide/backup-restore.db-cluster-snapshots.html#backup-restore.backup-window
  - getCloudWatchLogsRetention
```
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
```
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.
  - getDbClusterName
```
default java.lang.String getDbClusterName()
```
    An optional identifier for the cluster.
    Default: - A name is automatically generated.
  - getDeletionProtection
```
default java.lang.Boolean getDeletionProtection()
```
    Specifies whether this cluster can be deleted.
    If deletionProtection is enabled, the cluster cannot be deleted unless it is modified and deletionProtection is disabled. deletionProtection protects clusters from being accidentally deleted.
    Default: - false
  - getEngineVersion
```
default java.lang.String getEngineVersion()
```
    What version of the database to start.
    Default: - The default engine version.
  - getExportAuditLogsToCloudWatch
```
default java.lang.Boolean getExportAuditLogsToCloudWatch()
```
    Whether the audit logs should be exported to CloudWatch.
    Note that you also have to configure the audit log export in the Cluster's Parameter Group.
    Default: false
    
    See Also:
    
    https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html#event-auditing-enabling-auditing
  - getExportProfilerLogsToCloudWatch
```
default java.lang.Boolean getExportProfilerLogsToCloudWatch()
```
    Whether the profiler logs should be exported to CloudWatch.
    Note that you also have to configure the profiler log export in the Cluster's Parameter Group.
    Default: false
    
    See Also:
    
    https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html#profiling.enable-profiling
  - getInstanceIdentifierBase
```
default java.lang.String getInstanceIdentifierBase()
```
    Base identifier for instances.
    Every replica is named by appending the replica number to this string, 1-based.
    Default: - `dbClusterName` is used with the word "Instance" appended. If `dbClusterName` is not provided, the identifier is automatically generated.
  - getInstances
```
default java.lang.Number getInstances()
```
    Number of DocDB compute instances.
    Default: 1
  - getKmsKey
```
default IKey getKmsKey()
```
    The KMS key for storage encryption.
    Default: - default master key.
  - getParameterGroup
```
default IClusterParameterGroup getParameterGroup()
```
    The DB parameter group to associate with the instance.
    Default: no parameter group
  - getPort
```
default java.lang.Number getPort()
```
    The port the DocumentDB cluster will listen on.
    Default: DatabaseCluster.DEFAULT_PORT
  - getPreferredMaintenanceWindow
```
default java.lang.String getPreferredMaintenanceWindow()
```
    A weekly time range in which maintenance should preferably execute.
    Must be at least 30 minutes long.
    Example: 'tue:04:17-tue:04:47'
    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/documentdb/latest/developerguide/db-instance-maintain.html#maintenance-window
  - getRemovalPolicy
```
default RemovalPolicy getRemovalPolicy()
```
    The removal policy to apply when the cluster and its instances are removed or replaced during a stack update, or when the stack is deleted.
    This removal policy also applies to the implicit security group created for the cluster if one is not supplied as a parameter.
    Default: - Retain cluster.
  - getSecurityGroup
```
default ISecurityGroup getSecurityGroup()
```
    Security group.
    Default: a new security group is created.
  - getStorageEncrypted
```
default java.lang.Boolean getStorageEncrypted()
```
    Whether to enable storage encryption.
    Default: true
  - getVpcSubnets
```
default SubnetSelection getVpcSubnets()
```
    Where to place the instances within the VPC.
    Default: private subnets
  - builder
```
static DatabaseClusterProps.Builder builder()
```
    Returns:
    
    a DatabaseClusterProps.Builder of DatabaseClusterProps

Interface DatabaseClusterProps

Nested Class Summary

Method Summary

Method Detail

getInstanceType

getMasterUser

getVpc

getBackup

getCloudWatchLogsRetention

getCloudWatchLogsRetentionRole

getDbClusterName

getDeletionProtection

getEngineVersion

getExportAuditLogsToCloudWatch

getExportProfilerLogsToCloudWatch

getInstanceIdentifierBase

getInstances

getKmsKey

getParameterGroup

getPort

getPreferredMaintenanceWindow

getRemovalPolicy

getSecurityGroup

getStorageEncrypted

getVpcSubnets

builder