ServerlessClusterProps

class aws_cdk.aws_rds.ServerlessClusterProps(*, engine, vpc, backup_retention=None, cluster_identifier=None, credentials=None, default_database_name=None, deletion_protection=None, enable_data_api=None, parameter_group=None, removal_policy=None, scaling=None, security_groups=None, storage_encryption_key=None, subnet_group=None, vpc_subnets=None)

Bases: object

(experimental) Properties to configure an Aurora Serverless Cluster.

Parameters
  • engine (IClusterEngine) – (experimental) What kind of database to start.

  • vpc (IVpc) – (experimental) The VPC that this Aurora Serverless cluster has been created in.

  • backup_retention (Optional[Duration]) – (experimental) The number of days during which automatic DB snapshots are retained. Automatic backup retention cannot be disabled on serverless clusters. Must be a value from 1 day to 35 days. Default: Duration.days(1)

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

  • credentials (Optional[Credentials]) – (experimental) Credentials for the administrative user. Default: - A username of ‘admin’ and SecretsManager-generated password

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

  • deletion_protection (Optional[bool]) – (experimental) Indicates whether the DB cluster should have deletion protection enabled. Default: - true if removalPolicy is RETAIN, false otherwise

  • enable_data_api (Optional[bool]) – (experimental) Whether to enable the Data API. Default: false

  • parameter_group (Optional[IParameterGroup]) – (experimental) Additional parameters to pass to the database engine. Default: - no parameter group.

  • 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.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data)

  • scaling (Optional[ServerlessScalingOptions]) – (experimental) Scaling configuration of an Aurora Serverless database cluster. Default: - Serverless cluster is automatically paused after 5 minutes of being idle. minimum capacity: 2 ACU maximum capacity: 16 ACU

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

  • storage_encryption_key (Optional[IKey]) – (experimental) The KMS key for storage encryption. Default: - the default master key will be used for storage encryption

  • subnet_group (Optional[ISubnetGroup]) – (experimental) Existing subnet group for the cluster. Default: - a new subnet group will be created.

  • vpc_subnets (Optional[SubnetSelection]) – (experimental) Where to place the instances within the VPC. Default: - the VPC default strategy if not specified.

Stability

experimental

Attributes

backup_retention

(experimental) The number of days during which automatic DB snapshots are retained.

Automatic backup retention cannot be disabled on serverless clusters. Must be a value from 1 day to 35 days.

Default

Duration.days(1)

Stability

experimental

Return type

Optional[Duration]

cluster_identifier

(experimental) An optional identifier for the cluster.

Default
  • A name is automatically generated.

Stability

experimental

Return type

Optional[str]

credentials

(experimental) Credentials for the administrative user.

Default
  • A username of ‘admin’ and SecretsManager-generated password

Stability

experimental

Return type

Optional[Credentials]

default_database_name

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

Default
  • Database is not created in cluster.

Stability

experimental

Return type

Optional[str]

deletion_protection

(experimental) Indicates whether the DB cluster should have deletion protection enabled.

Default
  • true if removalPolicy is RETAIN, false otherwise

Stability

experimental

Return type

Optional[bool]

enable_data_api

(experimental) Whether to enable the Data API.

Default

false

See

https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html

Stability

experimental

Return type

Optional[bool]

engine

(experimental) What kind of database to start.

Stability

experimental

Return type

IClusterEngine

parameter_group

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

Default
  • no parameter group.

Stability

experimental

Return type

Optional[IParameterGroup]

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.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data)

Stability

experimental

Return type

Optional[RemovalPolicy]

scaling

(experimental) Scaling configuration of an Aurora Serverless database cluster.

Default

  • Serverless cluster is automatically paused after 5 minutes of being idle.

minimum capacity: 2 ACU maximum capacity: 16 ACU

Stability

experimental

Return type

Optional[ServerlessScalingOptions]

security_groups

(experimental) Security group.

Default
  • a new security group is created.

Stability

experimental

Return type

Optional[List[ISecurityGroup]]

storage_encryption_key

(experimental) The KMS key for storage encryption.

Default
  • the default master key will be used for storage encryption

Stability

experimental

Return type

Optional[IKey]

subnet_group

(experimental) Existing subnet group for the cluster.

Default
  • a new subnet group will be created.

Stability

experimental

Return type

Optional[ISubnetGroup]

vpc

(experimental) The VPC that this Aurora Serverless cluster has been created in.

Stability

experimental

Return type

IVpc

vpc_subnets

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

Default
  • the VPC default strategy if not specified.

Stability

experimental

Return type

Optional[SubnetSelection]