Package software.amazon.awscdk.services.docdb

Interface DatabaseClusterProps

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Implementing Classes:
DatabaseClusterProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)", date="2023-05-31T18:44:13.520Z") @Stability(Stable) public interface DatabaseClusterProps extends software.amazon.jsii.JsiiSerializable
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();

  • Method Details

    • getInstanceType

      @Stability(Stable) @NotNull InstanceType getInstanceType()
      What type of instance to start for the replicas.

    • getMasterUser

      @Stability(Stable) @NotNull Login getMasterUser()
      Username and password for the administrative user.

    • getVpc

      @Stability(Stable) @NotNull IVpc getVpc()
      What subnets to run the DocumentDB instances in.

      Must be at least 2 subnets in two different AZs.

    • getBackup

      @Stability(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:

    • getCloudWatchLogsRetention

      @Stability(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(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.

    • getDbClusterName

      @Stability(Stable) @Nullable default String getDbClusterName()
      An optional identifier for the cluster.

      Default: - A name is automatically generated.

    • getDeletionProtection

      @Stability(Stable) @Nullable default 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

      @Stability(Stable) @Nullable default String getEngineVersion()
      What version of the database to start.

      Default: - The default engine version.

    • getExportAuditLogsToCloudWatch

      @Stability(Stable) @Nullable default 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:

    • getExportProfilerLogsToCloudWatch

      @Stability(Stable) @Nullable default 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:

    • getInstanceIdentifierBase

      @Stability(Stable) @Nullable default 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

      @Stability(Stable) @Nullable default Number getInstances()
      Number of DocDB compute instances.

      Default: 1

    • getKmsKey

      @Stability(Stable) @Nullable default IKey getKmsKey()
      The KMS key for storage encryption.

      Default: - default master key.

    • getParameterGroup

      @Stability(Stable) @Nullable default IClusterParameterGroup getParameterGroup()
      The DB parameter group to associate with the instance.

      Default: no parameter group

    • getPort

      @Stability(Stable) @Nullable default Number getPort()
      The port the DocumentDB cluster will listen on.

      Default: DatabaseCluster.DEFAULT_PORT

    • getPreferredMaintenanceWindow

      @Stability(Stable) @Nullable default 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:

    • getRemovalPolicy

      @Stability(Stable) @Nullable 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

      @Stability(Stable) @Nullable default ISecurityGroup getSecurityGroup()
      Security group.

      Default: a new security group is created.

    • getStorageEncrypted

      @Stability(Stable) @Nullable default Boolean getStorageEncrypted()
      Whether to enable storage encryption.

      Default: true

    • getVpcSubnets

      @Stability(Stable) @Nullable default SubnetSelection getVpcSubnets()
      Where to place the instances within the VPC.

      Default: private subnets

    • builder

      @Stability(Stable) static DatabaseClusterProps.Builder builder()
      Returns:
      a DatabaseClusterProps.Builder of DatabaseClusterProps