AWS::RDS::DBClusterParameterGroup - AWS CloudFormation


The AWS::RDS::DBClusterParameterGroup resource creates a new Amazon RDS DB cluster parameter group.

For information about configuring parameters for Amazon Aurora DB instances, see Working with DB parameter groups and DB cluster parameter groups in the Amazon Aurora User Guide.


If you apply a parameter group to a DB cluster, then its DB instances might need to reboot. This can result in an outage while the DB instances are rebooting.

If you apply a change to parameter group associated with a stopped DB cluster, then the update stack waits until the DB cluster is started.


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


{ "Type" : "AWS::RDS::DBClusterParameterGroup", "Properties" : { "Description" : String, "Family" : String, "Parameters" : Json, "Tags" : [ Tag, ... ] } }


Type: AWS::RDS::DBClusterParameterGroup Properties: Description: String Family: String Parameters: Json Tags: - Tag



A friendly description for this DB cluster parameter group.

Required: Yes

Type: String

Update requires: Replacement


The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a DB engine and engine version compatible with that DB cluster parameter group family.


The DB cluster parameter group family can't be changed when updating a DB cluster parameter group.

To list all of the available parameter group families, use the following command:

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"

The output contains duplicates.

For more information, see CreateDBClusterParameterGroup.

Required: Yes

Type: String

Update requires: Replacement


Provides a list of parameters for the DB cluster parameter group.

Required: Yes

Type: Json

Update requires: No interruption


Tags to assign to the DB cluster parameter group.

Required: No

Type: List of Tag

Update requires: No interruption

Return values


When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the name of the DB cluster parameter group.

For more information about using the Ref function, see Ref.


The following snippet creates a DB cluster parameter group for an Aurora MySQL DB cluster and sets the time_zone and character_set_database parameters:


"RDSDBClusterParameterGroup": { "Type": "AWS::RDS::DBClusterParameterGroup", "Properties": { "Description": "CloudFormation Sample Aurora Cluster Parameter Group", "Family": "aurora5.6", "Parameters": { "time_zone": "US/Eastern", "character_set_database": "utf32" } } }


RDSDBClusterParameterGroup: Type: 'AWS::RDS::DBClusterParameterGroup' Properties: Description: CloudFormation Sample Aurora Cluster Parameter Group Family: aurora5.6 Parameters: time_zone: US/Eastern character_set_database: utf32