Creating a DB cluster that uses Aurora Serverless v2

To create a DB cluster that's compatible with Aurora Serverless v2 DB instances using the Amazon CLI, you follow the CLI procedure in Creating an Amazon Aurora DB cluster. Include the following parameters in your create-db-cluster command:

The following example shows the creation of an Aurora Serverless v2 DB cluster.

aws rds create-db-cluster \
    --db-cluster-identifier my-serverless-v2-cluster \
    --region eu-central-1 \
    --engine aurora-mysql \
    --engine-version 8.0.mysql_aurora.3.04.1 \
    --serverless-v2-scaling-configuration MinCapacity=1,MaxCapacity=4 \
    --master-username myuser \
    --manage-master-user-password

This example specifies the --manage-master-user-password option to generate the master user password and manage it in Secrets Manager. For more information, see Password management with Amazon Aurora and Amazon Secrets Manager. Alternatively, you can use the --master-password option to specify and manage the password yourself.

For information about the Aurora Serverless v2 version requirements, see Requirements and limitations for Aurora Serverless v2. For information about the allowed numbers for the capacity range and what those numbers represent, see Aurora Serverless v2 capacity and Performance and scaling for Aurora Serverless v2.

To verify whether an existing cluster has the capacity settings specified, check the output of the describe-db-clusters command for the ServerlessV2ScalingConfiguration attribute. Thatattribute looks similar to the following.

"ServerlessV2ScalingConfiguration": {
    "MinCapacity": 1.5,
    "MaxCapacity": 24.0
}

To create a DB cluster that's compatible with Aurora Serverless v2 DB instances using the RDS API, you follow the API procedure in Creating an Amazon Aurora DB cluster. Choose the following settings. Make sure that your CreateDBCluster operation includes the following parameters:

EngineVersion serverless_v2_compatible_engine_version
ServerlessV2ScalingConfiguration with MinCapacity=minimum_capacity and MaxCapacity=maximum_capacity

For information about the Aurora Serverless v2 version requirements, see Requirements and limitations for Aurora Serverless v2. For information about the allowed numbers for the capacity range and what those numbers represent, see Aurora Serverless v2 capacity and Performance and scaling for Aurora Serverless v2.

To check if an existing cluster has the capacity settings specified, check the output of the DescribeDBClusters operation for the ServerlessV2ScalingConfiguration attribute. That attribute looks similar to the following.

"ServerlessV2ScalingConfiguration": {
    "MinCapacity": 1.5,
    "MaxCapacity": 24.0
}

When you create a DB cluster using the Amazon Web Services Management Console, you specify the properties of the writer DB instance at the same time. To make the writer DB instance use Aurora Serverless v2, choose the Serverless DB instance class.

Then you set the capacity range for the cluster by specifying the minimum and maximum Aurora capacity unit (ACU) values. These minimum and maximum values apply to each Aurora Serverless v2 DB instance in the cluster.

If you don't create an Aurora Serverless v2 DB instance when you first create the cluster, you can add one or more Aurora Serverless v2 DB instances later. To do so, follow the procedures in Adding an Aurora Serverless v2 reader and Converting a provisioned writer or reader to Aurora Serverless v2. You specify the capacity range at the time that you add the first Aurora Serverless v2 DB instance to the cluster. You can change the capacity range later by following the procedure in Setting the Aurora Serverless v2 capacity range for a cluster.

When you create a Aurora Serverless v2 DB cluster using the Amazon CLI, you explicitly add the writer DB instance using the create-db-instance command. Include the following parameter:

The following example shows the creation of an Aurora Serverless v2 writer DB instance.

aws rds create-db-instance \
    --db-cluster-identifier my-serverless-v2-cluster \
    --db-instance-identifier my-serverless-v2-instance \
    --db-instance-class db.serverless \
    --engine aurora-mysql