software.amazon.awscdk.services.docdb

Class DatabaseCluster.Builder

java.lang.Object

software.amazon.awscdk.services.docdb.DatabaseCluster.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<DatabaseCluster>

Enclosing class:

DatabaseCluster

@Stability(value=Experimental)
public static final class DatabaseCluster.Builder
extends Object
implements software.amazon.jsii.Builder<DatabaseCluster>

(experimental) A fluent builder for DatabaseCluster.

Method Summary

Modifier and Type	Method and Description
DatabaseCluster.Builder	backup(BackupProps backup) (experimental) Backup settings.
DatabaseCluster	build()
static DatabaseCluster.Builder	create(software.constructs.Construct scope, String id)
DatabaseCluster.Builder	dbClusterName(String dbClusterName) (experimental) An optional identifier for the cluster.
DatabaseCluster.Builder	engineVersion(String engineVersion) (experimental) What version of the database to start.
DatabaseCluster.Builder	instanceIdentifierBase(String instanceIdentifierBase) (experimental) Base identifier for instances.
DatabaseCluster.Builder	instances(Number instances) (experimental) Number of DocDB compute instances.
DatabaseCluster.Builder	instanceType(InstanceType instanceType) (experimental) What type of instance to start for the replicas.
DatabaseCluster.Builder	kmsKey(IKey kmsKey) (experimental) The KMS key for storage encryption.
DatabaseCluster.Builder	masterUser(Login masterUser) (experimental) Username and password for the administrative user.
DatabaseCluster.Builder	parameterGroup(IClusterParameterGroup parameterGroup) (experimental) The DB parameter group to associate with the instance.
DatabaseCluster.Builder	port(Number port) (experimental) The port the DocumentDB cluster will listen on.
DatabaseCluster.Builder	preferredMaintenanceWindow(String preferredMaintenanceWindow) (experimental) A weekly time range in which maintenance should preferably execute.
DatabaseCluster.Builder	removalPolicy(RemovalPolicy removalPolicy) (experimental) 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.
DatabaseCluster.Builder	securityGroup(ISecurityGroup securityGroup) (experimental) Security group.
DatabaseCluster.Builder	storageEncrypted(Boolean storageEncrypted) (experimental) Whether to enable storage encryption.
DatabaseCluster.Builder	vpc(IVpc vpc) (experimental) What subnets to run the DocumentDB instances in.
DatabaseCluster.Builder	vpcSubnets(SubnetSelection vpcSubnets) (experimental) Where to place the instances within the VPC.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

@Stability(value=Experimental)
public static DatabaseCluster.Builder create(software.constructs.Construct scope,
                                                                            String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Returns:

a new instance of DatabaseCluster.Builder.

instanceType

@Stability(value=Experimental)
public DatabaseCluster.Builder instanceType(InstanceType instanceType)

(experimental) What type of instance to start for the replicas.

Parameters:

instanceType - What type of instance to start for the replicas. This parameter is required.

Returns:

this

masterUser

@Stability(value=Experimental)
public DatabaseCluster.Builder masterUser(Login masterUser)

(experimental) Username and password for the administrative user.

Parameters:

masterUser - Username and password for the administrative user. This parameter is required.

Returns:

this

vpc

@Stability(value=Experimental)
public DatabaseCluster.Builder vpc(IVpc vpc)

(experimental) What subnets to run the DocumentDB instances in.

Must be at least 2 subnets in two different AZs.

Parameters:

vpc - What subnets to run the DocumentDB instances in. This parameter is required.

Returns:

this

backup

@Stability(value=Experimental)
public DatabaseCluster.Builder backup(BackupProps backup)

(experimental) 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.

Parameters:

backup - Backup settings. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/documentdb/latest/developerguide/backup-restore.db-cluster-snapshots.html#backup-restore.backup-window

dbClusterName

@Stability(value=Experimental)
public DatabaseCluster.Builder dbClusterName(String dbClusterName)

(experimental) An optional identifier for the cluster.

Default: - A name is automatically generated.

Parameters:

dbClusterName - An optional identifier for the cluster. This parameter is required.

Returns:

this

engineVersion

@Stability(value=Experimental)
public DatabaseCluster.Builder engineVersion(String engineVersion)

(experimental) What version of the database to start.

Default: - The default engine version.

Parameters:

engineVersion - What version of the database to start. This parameter is required.

Returns:

this

instanceIdentifierBase

@Stability(value=Experimental)
public DatabaseCluster.Builder instanceIdentifierBase(String instanceIdentifierBase)

(experimental) 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.

Parameters:

instanceIdentifierBase - Base identifier for instances. This parameter is required.

Returns:

this

instances

@Stability(value=Experimental)
public DatabaseCluster.Builder instances(Number instances)

(experimental) Number of DocDB compute instances.

Default: 1

Parameters:

instances - Number of DocDB compute instances. This parameter is required.

Returns:

this

kmsKey

@Stability(value=Experimental)
public DatabaseCluster.Builder kmsKey(IKey kmsKey)

(experimental) The KMS key for storage encryption.

Default: - default master key.

Parameters:

kmsKey - The KMS key for storage encryption. This parameter is required.

Returns:

this

parameterGroup

@Stability(value=Experimental)
public DatabaseCluster.Builder parameterGroup(IClusterParameterGroup parameterGroup)

(experimental) The DB parameter group to associate with the instance.

Default: no parameter group

Parameters:

parameterGroup - The DB parameter group to associate with the instance. This parameter is required.

Returns:

this

port

@Stability(value=Experimental)
public DatabaseCluster.Builder port(Number port)

(experimental) The port the DocumentDB cluster will listen on.

Default: DatabaseCluster.DEFAULT_PORT

Parameters:

port - The port the DocumentDB cluster will listen on. This parameter is required.

Returns:

this

preferredMaintenanceWindow

@Stability(value=Experimental)
public DatabaseCluster.Builder preferredMaintenanceWindow(String preferredMaintenanceWindow)

(experimental) 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.

Parameters:

preferredMaintenanceWindow - A weekly time range in which maintenance should preferably execute. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html#maintenance-window

removalPolicy

@Stability(value=Experimental)
public DatabaseCluster.Builder removalPolicy(RemovalPolicy removalPolicy)

(experimental) 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.

Parameters:

removalPolicy - 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 parameter is required.

Returns:

this

securityGroup

@Stability(value=Experimental)
public DatabaseCluster.Builder securityGroup(ISecurityGroup securityGroup)

(experimental) Security group.

Default: a new security group is created.

Parameters:

securityGroup - Security group. This parameter is required.

Returns:

this

storageEncrypted

@Stability(value=Experimental)
public DatabaseCluster.Builder storageEncrypted(Boolean storageEncrypted)

(experimental) Whether to enable storage encryption.

Default: true

Parameters:

storageEncrypted - Whether to enable storage encryption. This parameter is required.

Returns:

this

vpcSubnets

@Stability(value=Experimental)
public DatabaseCluster.Builder vpcSubnets(SubnetSelection vpcSubnets)

(experimental) Where to place the instances within the VPC.

Default: private subnets

Parameters:

vpcSubnets - Where to place the instances within the VPC. This parameter is required.

Returns:

this

build

@Stability(value=Experimental)
public DatabaseCluster build()

Specified by:

build in interface software.amazon.jsii.Builder<DatabaseCluster>