AWS::RDS::DBCluster ServerlessV2ScalingConfiguration - AWS CloudFormation
SyntaxPropertiesExamples

AWS::RDS::DBCluster ServerlessV2ScalingConfiguration

The ServerlessV2ScalingConfiguration property type specifies the scaling configuration of an Aurora Serverless V2 DB cluster. For more information, see Using Amazon Aurora Serverless v2 in the Amazon Aurora User Guide.

If you have an Aurora cluster, you must set this attribute before you add a DB instance that uses the db.serverless DB instance class. For more information, see Clusters that use Aurora Serverless v2 must have a capacity range specified in the Amazon Aurora User Guide.

This property is only supported for Aurora Serverless v2. For Aurora Serverless v1, use the ScalingConfiguration property.

Valid for: Aurora Serverless v2 DB clusters

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "MaxCapacity" : Number,
  "MinCapacity" : Number
}

YAML

  MaxCapacity: Number
  MinCapacity: Number

Properties

MaxCapacity

The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 40, 40.5, 41, and so on. The largest value that you can use is 128.

The maximum capacity must be higher than 0.5 ACUs. For more information, see Choosing the maximum Aurora Serverless v2 capacity setting for a cluster in the Amazon Aurora User Guide.

Aurora automatically sets certain parameters for Aurora Serverless V2 DB instances to values that depend on the maximum ACU value in the capacity range. When you update the maximum capacity value, the ParameterApplyStatus value for the DB instance changes to pending-reboot. You can update the parameter values by rebooting the DB instance after changing the capacity range.

Required: No

Type: Number

Update requires: No interruption

MinCapacity

The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 8, 8.5, 9, and so on. For Aurora versions that support the Aurora Serverless v2 auto-pause feature, the smallest value that you can use is 0. For versions that don't support Aurora Serverless v2 auto-pause, the smallest value that you can use is 0.5.

Required: No

Type: Number

Update requires: No interruption

Examples

The following example specifies a scaling configuration for an Aurora Serverless v2 DB cluster.

Specifying a scaling configuration for a Serverless v2 DB cluster

JSON

"ServerlessV2ScalingConfiguration":{
   "MinCapacity": 9,
   "MaxCapacity": 42
}

YAML

ServerlessV2ScalingConfiguration:
  MinCapacity: 9
  MaxCapacity: 42