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, removal_policy=None, roles=None, security_groups=None, vpc_subnets=None)

Bases: object

__init__(*, 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, removal_policy=None, roles=None, security_groups=None, vpc_subnets=None)

Properties for a new database cluster.

Parameters
  • master_user (Login) – Username and password for the administrative user.

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

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

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

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

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

  • encryption_key (Optional[IKey]) – 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]) – 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]) – Prefix used for logging. Default: - no prefix

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

  • number_of_nodes (Union[int, float, None]) – 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]) – 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]) – What port to listen on. Default: - The default for the engine is used.

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

  • removal_policy (Optional[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

  • roles (Optional[List[IRole]]) – 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[List[ISecurityGroup]]) – Security group. Default: a new security group is created.

  • vpc_subnets (Optional[SubnetSelection]) – Where to place the instances within the VPC. Default: private subnets

stability :stability: experimental

Return type

None

Attributes

cluster_name

An optional identifier for the cluster.

default :default: - A name is automatically generated.

stability :stability: experimental

Return type

Optional[str]

cluster_type

Settings for the individual instances that are launched.

default :default: {@link ClusterType.MULTI_NODE}

stability :stability: experimental

Return type

Optional[ClusterType]

default_database_name

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

default :default: - default_db

stability :stability: experimental

Return type

Optional[str]

encrypted

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

default :default: true

stability :stability: experimental

Return type

Optional[bool]

encryption_key

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

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

stability :stability: experimental

Return type

Optional[IKey]

logging_bucket

Bucket to send logs to.

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

default :default: - No Logs

stability :stability: experimental

Return type

Optional[IBucket]

logging_key_prefix

Prefix used for logging.

default :default: - no prefix

stability :stability: experimental

Return type

Optional[str]

master_user

Username and password for the administrative user.

stability :stability: experimental

Return type

Login

node_type

The node type to be provisioned for the cluster.

default :default: {@link NodeType.DC2_LARGE}

stability :stability: experimental

Return type

Optional[NodeType]

number_of_nodes

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 :default: - 2 if clusterType is ClusterType.MULTI_NODE, undefined otherwise

stability :stability: experimental

Return type

Union[int, float, None]

parameter_group

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

default :default: - No parameter group.

stability :stability: experimental

Type

Additional parameters to pass to the database engine https

Return type

Optional[IClusterParameterGroup]

port

What port to listen on.

default :default: - The default for the engine is used.

stability :stability: experimental

Return type

Union[int, float, None]

preferred_maintenance_window

mi-ddd:hh24:mi (24H Clock UTC).

Example: ‘Sun:23:45-Mon:00:15’

default :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 :see: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance stability :stability: experimental

Type

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

Type

hh24

Return type

Optional[str]

removal_policy

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

default :default: RemovalPolicy.RETAIN

stability :stability: experimental

Return type

Optional[RemovalPolicy]

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 :default: - No role is attached to the cluster.

stability :stability: experimental

Return type

Optional[List[IRole]]

security_groups

Security group.

default :default: a new security group is created.

stability :stability: experimental

Return type

Optional[List[ISecurityGroup]]

vpc

The VPC to place the cluster in.

stability :stability: experimental

Return type

IVpc

vpc_subnets

Where to place the instances within the VPC.

default :default: private subnets

stability :stability: experimental

Return type

Optional[SubnetSelection]