software.amazon.awscdk.services.redshift

Class Cluster.Builder

java.lang.Object

software.amazon.awscdk.services.redshift.Cluster.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<Cluster>

Enclosing class:

Cluster

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

A fluent builder for Cluster.

Method Summary

Modifier and Type	Method and Description
Cluster	build()
Cluster.Builder	clusterName(String clusterName) An optional identifier for the cluster.
Cluster.Builder	clusterType(ClusterType clusterType) Settings for the individual instances that are launched.
static Cluster.Builder	create(Construct scope, String id) EXPERIMENTAL
Cluster.Builder	defaultDatabaseName(String defaultDatabaseName) Name of a database which is automatically created inside the cluster.
Cluster.Builder	encrypted(Boolean encrypted) Whether to enable encryption of data at rest in the cluster.
Cluster.Builder	encryptionKey(IKey encryptionKey) The KMS key to use for encryption of data at rest.
Cluster.Builder	loggingBucket(IBucket loggingBucket) Bucket to send logs to.
Cluster.Builder	loggingKeyPrefix(String loggingKeyPrefix) Prefix used for logging.
Cluster.Builder	masterUser(Login masterUser) Username and password for the administrative user.
Cluster.Builder	nodeType(NodeType nodeType) The node type to be provisioned for the cluster.
Cluster.Builder	numberOfNodes(Number numberOfNodes) Number of compute nodes in the cluster.
Cluster.Builder	parameterGroup(IClusterParameterGroup parameterGroup) Additional parameters to pass to the database engine https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-parameter-groups.html.
Cluster.Builder	port(Number port) What port to listen on.
Cluster.Builder	preferredMaintenanceWindow(String preferredMaintenanceWindow) A preferred maintenance window day/time range.
Cluster.Builder	removalPolicy(RemovalPolicy removalPolicy) The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update.
Cluster.Builder	roles(List<IRole> roles) A list of AWS Identity and Access Management (IAM) role that can be used by the cluster to access other AWS services.
Cluster.Builder	securityGroups(List<ISecurityGroup> securityGroups) Security group.
Cluster.Builder	vpc(IVpc vpc) The VPC to place the cluster in.
Cluster.Builder	vpcSubnets(SubnetSelection vpcSubnets) 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 Cluster.Builder create(Construct scope,
                                                                    String id)

EXPERIMENTAL

Parameters:

scope - This parameter is required.

id - This parameter is required.

Returns:

a new instance of Cluster.Builder.

masterUser

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

Username and password for the administrative user.

EXPERIMENTAL

Parameters:

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

Returns:

this

vpc

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

The VPC to place the cluster in.

EXPERIMENTAL

Parameters:

vpc - The VPC to place the cluster in. This parameter is required.

Returns:

this

clusterName

@Stability(value=Experimental)
public Cluster.Builder clusterName(String clusterName)

An optional identifier for the cluster.

Default: - A name is automatically generated.

EXPERIMENTAL

Parameters:

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

Returns:

this

clusterType

@Stability(value=Experimental)
public Cluster.Builder clusterType(ClusterType clusterType)

Settings for the individual instances that are launched.

Default: ClusterType.MULTI_NODE

EXPERIMENTAL

Parameters:

clusterType - Settings for the individual instances that are launched. This parameter is required.

Returns:

this

defaultDatabaseName

@Stability(value=Experimental)
public Cluster.Builder defaultDatabaseName(String defaultDatabaseName)

Name of a database which is automatically created inside the cluster.

Default: - default_db

EXPERIMENTAL

Parameters:

defaultDatabaseName - Name of a database which is automatically created inside the cluster. This parameter is required.

Returns:

this

encrypted

@Stability(value=Experimental)
public Cluster.Builder encrypted(Boolean encrypted)

Whether to enable encryption of data at rest in the cluster.

Default: true

EXPERIMENTAL

Parameters:

encrypted - Whether to enable encryption of data at rest in the cluster. This parameter is required.

Returns:

this

encryptionKey

@Stability(value=Experimental)
public Cluster.Builder encryptionKey(IKey encryptionKey)

The KMS key to use for encryption of data at rest.

Default: - AWS-managed key, if encryption at rest is enabled

EXPERIMENTAL

Parameters:

encryptionKey - The KMS key to use for encryption of data at rest. This parameter is required.

Returns:

this

loggingBucket

@Stability(value=Experimental)
public Cluster.Builder loggingBucket(IBucket loggingBucket)

Bucket to send logs to.

Logging information includes queries and connection attempts, for the specified Amazon Redshift cluster.

Default: - No Logs

EXPERIMENTAL

Parameters:

loggingBucket - Bucket to send logs to. This parameter is required.

Returns:

this

loggingKeyPrefix

@Stability(value=Experimental)
public Cluster.Builder loggingKeyPrefix(String loggingKeyPrefix)

Prefix used for logging.

Default: - no prefix

EXPERIMENTAL

Parameters:

loggingKeyPrefix - Prefix used for logging. This parameter is required.

Returns:

this

nodeType

@Stability(value=Experimental)
public Cluster.Builder nodeType(NodeType nodeType)

The node type to be provisioned for the cluster.

Default: NodeType.DC2_LARGE

EXPERIMENTAL

Parameters:

nodeType - The node type to be provisioned for the cluster. This parameter is required.

Returns:

this

numberOfNodes

@Stability(value=Experimental)
public Cluster.Builder numberOfNodes(Number numberOfNodes)

Number of compute nodes in the cluster.

Value must be at least 1 and no more than 100.

Default: 1

EXPERIMENTAL

Parameters:

numberOfNodes - Number of compute nodes in the cluster. This parameter is required.

Returns:

this

parameterGroup

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

Additional parameters to pass to the database engine https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-parameter-groups.html.

Default: - No parameter group.

EXPERIMENTAL

Parameters:

parameterGroup - Additional parameters to pass to the database engine https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-parameter-groups.html. This parameter is required.

Returns:

this

port

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

What port to listen on.

Default: - The default for the engine is used.

EXPERIMENTAL

Parameters:

port - What port to listen on. This parameter is required.

Returns:

this

preferredMaintenanceWindow

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

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.

EXPERIMENTAL

Parameters:

preferredMaintenanceWindow - A preferred maintenance window day/time range. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance

removalPolicy

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

The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update.

Default: RemovalPolicy.RETAIN

EXPERIMENTAL

Parameters:

removalPolicy - The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update. This parameter is required.

Returns:

this

roles

@Stability(value=Experimental)
public Cluster.Builder roles(List<IRole> roles)

A list of AWS Identity and Access Management (IAM) role that can be used by the cluster to access other AWS services.

Specify a maximum of 10 roles.

Default: - No role is attached to the cluster.

EXPERIMENTAL

Parameters:

roles - A list of AWS Identity and Access Management (IAM) role that can be used by the cluster to access other AWS services. This parameter is required.

Returns:

this

securityGroups

@Stability(value=Experimental)
public Cluster.Builder securityGroups(List<ISecurityGroup> securityGroups)

Security group.

Default: a new security group is created.

EXPERIMENTAL

Parameters:

securityGroups - Security group. This parameter is required.

Returns:

this

vpcSubnets

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

Where to place the instances within the VPC.

Default: private subnets

EXPERIMENTAL

Parameters:

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

Returns:

this

build

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

Specified by:

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