ServerlessClusterFromSnapshotProps

class aws_cdk.aws_rds.ServerlessClusterFromSnapshotProps(*, engine, snapshot_identifier, 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, subnet_group=None, vpc=None, vpc_subnets=None)

Bases: object

Properties for ServerlessClusterFromSnapshot.

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

  • snapshot_identifier (str) – The identifier for the DB instance snapshot or DB cluster snapshot to restore from. You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB instance snapshot.

  • backup_retention (Optional[Duration]) – 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]) – An optional identifier for the cluster. Default: - A name is automatically generated.

  • credentials (Optional[SnapshotCredentials]) – Master user credentials. Note - It is not possible to change the master username for a snapshot; however, it is possible to provide (or generate) a new password. Default: - The existing username and password from the snapshot will be used.

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

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

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

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

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

  • scaling (Optional[ServerlessScalingOptions]) – 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[Sequence[ISecurityGroup]]) – Security group. Default: - a new security group is created if vpc was provided. If the vpc property was not provided, no VPC security groups will be associated with the DB cluster.

  • subnet_group (Optional[ISubnetGroup]) – Existing subnet group for the cluster. Default: - a new subnet group is created if vpc was provided. If the vpc property was not provided, no subnet group will be associated with the DB cluster

  • vpc (Optional[IVpc]) – The VPC that this Aurora Serverless cluster has been created in. Default: - the default VPC in the account and region will be used

  • vpc_subnets (Optional[SubnetSelection]) – Where to place the instances within the VPC. If provided, the vpc property must also be specified. Default: - the VPC default strategy if not specified.

ExampleMetadata

infused

Example:

# vpc: ec2.Vpc

rds.ServerlessClusterFromSnapshot(self, "Cluster",
    engine=rds.DatabaseClusterEngine.AURORA_MYSQL,
    vpc=vpc,
    snapshot_identifier="mySnapshot"
)

Attributes

backup_retention

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)

Return type

Optional[Duration]

cluster_identifier

An optional identifier for the cluster.

Default
  • A name is automatically generated.

Return type

Optional[str]

credentials

Master user credentials.

Note - It is not possible to change the master username for a snapshot; however, it is possible to provide (or generate) a new password.

Default
  • The existing username and password from the snapshot will be used.

Return type

Optional[SnapshotCredentials]

default_database_name

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

Default
  • Database is not created in cluster.

Return type

Optional[str]

deletion_protection

Indicates whether the DB cluster should have deletion protection enabled.

Default
  • true if removalPolicy is RETAIN, false otherwise

Return type

Optional[bool]

enable_data_api

Whether to enable the Data API.

Default

false

See

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

Return type

Optional[bool]

engine

What kind of database to start.

Return type

IClusterEngine

parameter_group

Additional parameters to pass to the database engine.

Default
  • no parameter group.

Return type

Optional[IParameterGroup]

removal_policy

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)

Return type

Optional[RemovalPolicy]

scaling

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

Return type

Optional[ServerlessScalingOptions]

security_groups

Security group.

Default

  • a new security group is created if vpc was provided.

If the vpc property was not provided, no VPC security groups will be associated with the DB cluster.

Return type

Optional[List[ISecurityGroup]]

snapshot_identifier

The identifier for the DB instance snapshot or DB cluster snapshot to restore from.

You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB instance snapshot.

Return type

str

subnet_group

Existing subnet group for the cluster.

Default

  • a new subnet group is created if vpc was provided.

If the vpc property was not provided, no subnet group will be associated with the DB cluster

Return type

Optional[ISubnetGroup]

vpc

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

Default
  • the default VPC in the account and region will be used

Return type

Optional[IVpc]

vpc_subnets

Where to place the instances within the VPC.

If provided, the vpc property must also be specified.

Default
  • the VPC default strategy if not specified.

Return type

Optional[SubnetSelection]