ClusterProps

class aws_cdk.aws_redshift.ClusterProps(*, master_user, vpc, cluster_name=None, cluster_type=None, default_database_name=None, encrypted=None, encryption_key=None, logging_bucket=None, logging_key_prefix=None, node_type=None, number_of_nodes=None, parameter_group=None, port=None, preferred_maintenance_window=None, publicly_accessible=None, removal_policy=None, roles=None, security_groups=None, subnet_group=None, vpc_subnets=None)

Bases: object

(experimental) Properties for a new database cluster.

Parameters:

  • master_user (Union[Login, Dict[str, Any]]) – (experimental) Username and password for the administrative user.

  • vpc (IVpc) – (experimental) The VPC to place the cluster in.

  • cluster_name (Optional[str]) – (experimental) An optional identifier for the cluster. Default: - A name is automatically generated.

  • cluster_type (Optional[ClusterType]) – (experimental) Settings for the individual instances that are launched. Default: {@link ClusterType.MULTI_NODE}

  • default_database_name (Optional[str]) – (experimental) Name of a database which is automatically created inside the cluster. Default: - default_db

  • encrypted (Optional[bool]) – (experimental) Whether to enable encryption of data at rest in the cluster. Default: true

  • encryption_key (Optional[IKey]) – (experimental) The KMS key to use for encryption of data at rest. Default: - AWS-managed key, if encryption at rest is enabled

  • logging_bucket (Optional[IBucket]) – (experimental) Bucket to send logs to. Logging information includes queries and connection attempts, for the specified Amazon Redshift cluster. Default: - No Logs

  • logging_key_prefix (Optional[str]) – (experimental) Prefix used for logging. Default: - no prefix

  • node_type (Optional[NodeType]) – (experimental) The node type to be provisioned for the cluster. Default: {@link NodeType.DC2_LARGE}

  • number_of_nodes (Union[int, float, None]) – (experimental) Number of compute nodes in the cluster. Only specify this property for multi-node clusters. Value must be at least 2 and no more than 100. Default: - 2 if clusterType is ClusterType.MULTI_NODE, undefined otherwise

  • parameter_group (Optional[IClusterParameterGroup]) – (experimental) 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.

  • port (Union[int, float, None]) – (experimental) What port to listen on. Default: - The default for the engine is used.

  • preferred_maintenance_window (Optional[str]) – (experimental) 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.

  • publicly_accessible (Optional[bool]) – (experimental) Whether to make cluster publicly accessible. Default: false

  • removal_policy (Optional[RemovalPolicy]) – (experimental) The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update. Default: RemovalPolicy.RETAIN

  • roles (Optional[Sequence[IRole]]) – (experimental) 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.

  • security_groups (Optional[Sequence[ISecurityGroup]]) – (experimental) Security group. Default: - a new security group is created.

  • subnet_group (Optional[IClusterSubnetGroup]) – (experimental) A cluster subnet group to use with this cluster. Default: - a new subnet group will be created.

  • vpc_subnets (Union[SubnetSelection, Dict[str, Any], None]) – (experimental) Where to place the instances within the VPC. Default: - private subnets

Stability:

experimental

ExampleMetadata:

infused

Example:

import aws_cdk.aws_ec2 as ec2


vpc = ec2.Vpc(self, "Vpc")
cluster = Cluster(self, "Redshift",
    master_user=Login(
        master_username="admin"
    ),
    vpc=vpc
)

Attributes

cluster_name

(experimental) An optional identifier for the cluster.

Default:

  • A name is automatically generated.

Stability:

experimental

cluster_type

(experimental) Settings for the individual instances that are launched.

Default:

{@link ClusterType.MULTI_NODE}

Stability:

experimental

default_database_name

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

Default:

  • default_db

Stability:

experimental

encrypted

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

Default:

true

Stability:

experimental

encryption_key

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

Default:

  • AWS-managed key, if encryption at rest is enabled

Stability:

experimental

logging_bucket

(experimental) Bucket to send logs to.

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

Default:

  • No Logs

Stability:

experimental

logging_key_prefix

(experimental) Prefix used for logging.

Default:

  • no prefix

Stability:

experimental

master_user

(experimental) Username and password for the administrative user.

Stability:

experimental

node_type

(experimental) The node type to be provisioned for the cluster.

Default:

{@link NodeType.DC2_LARGE}

Stability:

experimental

number_of_nodes

(experimental) Number of compute nodes in the cluster. Only specify this property for multi-node clusters.

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

Default:

  • 2 if clusterType is ClusterType.MULTI_NODE, undefined otherwise

Stability:

experimental

parameter_group

//docs.aws.amazon.com/redshift/latest/mgmt/working-with-parameter-groups.html.

Default:

  • No parameter group.

Stability:

experimental

Type:

(experimental) Additional parameters to pass to the database engine https

port

(experimental) What port to listen on.

Default:

  • The default for the engine is used.

Stability:

experimental

preferred_maintenance_window

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.

See:

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

Stability:

experimental

Type:

(experimental) A preferred maintenance window day/time range. Should be specified as a range ddd

Type:

hh24

publicly_accessible

(experimental) Whether to make cluster publicly accessible.

Default:

false

Stability:

experimental

removal_policy

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

Default:

RemovalPolicy.RETAIN

Stability:

experimental

roles

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

Stability:

experimental

security_groups

(experimental) Security group.

Default:

  • a new security group is created.

Stability:

experimental

subnet_group

(experimental) A cluster subnet group to use with this cluster.

Default:

  • a new subnet group will be created.

Stability:

experimental

vpc

(experimental) The VPC to place the cluster in.

Stability:

experimental

vpc_subnets

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

Default:

  • private subnets

Stability:

experimental