software.amazon.awscdk.services.docdb

Class DatabaseCluster

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.docdb.DatabaseCluster

All Implemented Interfaces:

IDependable, IResource, IDatabaseCluster, IConnectable, ISecretAttachmentTarget, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-04T15:39:05.690Z")
 @Stability(value=Experimental)
public class DatabaseCluster
extends Resource
implements IDatabaseCluster

(experimental) Create a clustered database with a given number of instances.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.core.*;
 import software.amazon.awscdk.services.docdb.*;
 import software.amazon.awscdk.services.ec2.*;
 import software.amazon.awscdk.services.iam.*;
 import software.amazon.awscdk.services.kms.*;
 import software.amazon.awscdk.services.logs.*;
 ClusterParameterGroup clusterParameterGroup;
 Duration duration;
 InstanceType instanceType;
 Key key;
 Role role;
 SecretValue secretValue;
 SecurityGroup securityGroup;
 Subnet subnet;
 SubnetFilter subnetFilter;
 Vpc vpc;
 DatabaseCluster databaseCluster = DatabaseCluster.Builder.create(this, "MyDatabaseCluster")
         .instanceType(instanceType)
         .masterUser(Login.builder()
                 .username("username")
                 // the properties below are optional
                 .excludeCharacters("excludeCharacters")
                 .kmsKey(key)
                 .password(secretValue)
                 .secretName("secretName")
                 .build())
         .vpc(vpc)
         // the properties below are optional
         .backup(BackupProps.builder()
                 .retention(duration)
                 // the properties below are optional
                 .preferredWindow("preferredWindow")
                 .build())
         .cloudWatchLogsRetention(RetentionDays.ONE_DAY)
         .cloudWatchLogsRetentionRole(role)
         .dbClusterName("dbClusterName")
         .deletionProtection(false)
         .engineVersion("engineVersion")
         .exportAuditLogsToCloudWatch(false)
         .exportProfilerLogsToCloudWatch(false)
         .instanceIdentifierBase("instanceIdentifierBase")
         .instances(123)
         .kmsKey(key)
         .parameterGroup(clusterParameterGroup)
         .port(123)
         .preferredMaintenanceWindow("preferredMaintenanceWindow")
         .removalPolicy(RemovalPolicy.DESTROY)
         .securityGroup(securityGroup)
         .storageEncrypted(false)
         .vpcSubnets(SubnetSelection.builder()
                 .availabilityZones(List.of("availabilityZones"))
                 .onePerAz(false)
                 .subnetFilters(List.of(subnetFilter))
                 .subnetGroupName("subnetGroupName")
                 .subnetName("subnetName")
                 .subnets(List.of(subnet))
                 .subnetType(SubnetType.ISOLATED)
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DatabaseCluster.Builder (experimental) A fluent builder for DatabaseCluster.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.docdb.IDatabaseCluster

IDatabaseCluster.Jsii$Default, IDatabaseCluster.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field and Description
static Number	DEFAULT_NUM_INSTANCES (experimental) The default number of instances in the DocDB cluster if none are specified.
static Number	DEFAULT_PORT (experimental) The default port Document DB listens on.

Constructor Summary

Constructors

Modifier	Constructor and Description
	DatabaseCluster(software.constructs.Construct scope, String id, DatabaseClusterProps props)
protected	DatabaseCluster(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	DatabaseCluster(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
SecretRotation	addRotationMultiUser(String id, RotationMultiUserOptions options) (experimental) Adds the multi user rotation to this cluster.
SecretRotation	addRotationSingleUser() (experimental) Adds the single user rotation of the master password to this cluster.
SecretRotation	addRotationSingleUser(Duration automaticallyAfter) (experimental) Adds the single user rotation of the master password to this cluster.
void	addSecurityGroups(ISecurityGroup... securityGroups) (experimental) Adds security groups to this cluster.
SecretAttachmentTargetProps	asSecretAttachmentTarget() (experimental) Renders the secret attachment target specifications.
static IDatabaseCluster	fromDatabaseClusterAttributes(software.constructs.Construct scope, String id, DatabaseClusterAttributes attrs) (experimental) Import an existing DatabaseCluster from properties.
Endpoint	getClusterEndpoint() (experimental) The endpoint to use for read/write operations.
String	getClusterIdentifier() (experimental) Identifier of the cluster.
Endpoint	getClusterReadEndpoint() (experimental) Endpoint to use for load-balanced read-only operations.
String	getClusterResourceIdentifier() (experimental) The resource id for the cluster;
Connections	getConnections() (experimental) The connections object to implement IConnectable.
List<Endpoint>	getInstanceEndpoints() (experimental) Endpoints which address each individual replica.
List<String>	getInstanceIdentifiers() (experimental) Identifiers of the replicas.
ISecret	getSecret() (experimental) The secret attached to this cluster.
String	getSecurityGroupId() (experimental) Security group identifier of this database.

Methods inherited from class software.amazon.awscdk.core.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class software.constructs.Construct

toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Detail

DEFAULT_NUM_INSTANCES

@Stability(value=Experimental)
public static final Number DEFAULT_NUM_INSTANCES

(experimental) The default number of instances in the DocDB cluster if none are specified.

DEFAULT_PORT

@Stability(value=Experimental)
public static final Number DEFAULT_PORT

(experimental) The default port Document DB listens on.

Constructor Detail

DatabaseCluster

protected DatabaseCluster(software.amazon.jsii.JsiiObjectRef objRef)

DatabaseCluster

protected DatabaseCluster(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

DatabaseCluster

@Stability(value=Experimental)
public DatabaseCluster(@NotNull
                                                      software.constructs.Construct scope,
                                                      @NotNull
                                                      String id,
                                                      @NotNull
                                                      DatabaseClusterProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromDatabaseClusterAttributes

@Stability(value=Experimental)
 @NotNull
public static IDatabaseCluster fromDatabaseClusterAttributes(@NotNull
                                                                                                      software.constructs.Construct scope,
                                                                                                      @NotNull
                                                                                                      String id,
                                                                                                      @NotNull
                                                                                                      DatabaseClusterAttributes attrs)

(experimental) Import an existing DatabaseCluster from properties.

Parameters:

scope - This parameter is required.

id - This parameter is required.

attrs - This parameter is required.

addRotationMultiUser

@Stability(value=Experimental)
 @NotNull
public SecretRotation addRotationMultiUser(@NotNull
                                                                                    String id,
                                                                                    @NotNull
                                                                                    RotationMultiUserOptions options)

(experimental) Adds the multi user rotation to this cluster.

Parameters:

id - This parameter is required.

options - This parameter is required.

addRotationSingleUser

@Stability(value=Experimental)
 @NotNull
public SecretRotation addRotationSingleUser(@Nullable
                                                                                     Duration automaticallyAfter)

(experimental) Adds the single user rotation of the master password to this cluster.

Parameters:

automaticallyAfter - Specifies the number of days after the previous rotation before Secrets Manager triggers the next automatic rotation.

addRotationSingleUser

@Stability(value=Experimental)
 @NotNull
public SecretRotation addRotationSingleUser()

(experimental) Adds the single user rotation of the master password to this cluster.

addSecurityGroups

@Stability(value=Experimental)
public void addSecurityGroups(@NotNull
                                                             ISecurityGroup... securityGroups)

(experimental) Adds security groups to this cluster.

Parameters:

securityGroups - The security groups to add. This parameter is required.

asSecretAttachmentTarget

@Stability(value=Experimental)
 @NotNull
public SecretAttachmentTargetProps asSecretAttachmentTarget()

(experimental) Renders the secret attachment target specifications.

Specified by:

asSecretAttachmentTarget in interface ISecretAttachmentTarget

getClusterEndpoint

@Stability(value=Experimental)
 @NotNull
public Endpoint getClusterEndpoint()

(experimental) The endpoint to use for read/write operations.

Specified by:

getClusterEndpoint in interface IDatabaseCluster

getClusterIdentifier

@Stability(value=Experimental)
 @NotNull
public String getClusterIdentifier()

(experimental) Identifier of the cluster.

Specified by:

getClusterIdentifier in interface IDatabaseCluster

getClusterReadEndpoint

@Stability(value=Experimental)
 @NotNull
public Endpoint getClusterReadEndpoint()

(experimental) Endpoint to use for load-balanced read-only operations.

Specified by:

getClusterReadEndpoint in interface IDatabaseCluster

getClusterResourceIdentifier

@Stability(value=Experimental)
 @NotNull
public String getClusterResourceIdentifier()

(experimental) The resource id for the cluster;

for example: cluster-ABCD1234EFGH5678IJKL90MNOP. The cluster ID uniquely identifies the cluster and is used in things like IAM authentication policies.

getConnections

@Stability(value=Experimental)
 @NotNull
public Connections getConnections()

(experimental) The connections object to implement IConnectable.

Specified by:

getConnections in interface IConnectable

getInstanceEndpoints

@Stability(value=Experimental)
 @NotNull
public List<Endpoint> getInstanceEndpoints()

(experimental) Endpoints which address each individual replica.

Specified by:

getInstanceEndpoints in interface IDatabaseCluster

getInstanceIdentifiers

@Stability(value=Experimental)
 @NotNull
public List<String> getInstanceIdentifiers()

(experimental) Identifiers of the replicas.

Specified by:

getInstanceIdentifiers in interface IDatabaseCluster

getSecurityGroupId

@Stability(value=Experimental)
 @NotNull
public String getSecurityGroupId()

(experimental) Security group identifier of this database.

Specified by:

getSecurityGroupId in interface IDatabaseCluster

getSecret

@Stability(value=Experimental)
 @Nullable
public ISecret getSecret()

(experimental) The secret attached to this cluster.