AWS CloudFormation
User Guide (Version )

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

AWS::RDS::DBClusterParameterGroup

The AWS::RDS::DBClusterParameterGroup resource creates a new Amazon RDS DB cluster parameter group. For more information, see Managing an Amazon Aurora DB Cluster in the Amazon Aurora User Guide.

Note

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.

Syntax

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

JSON

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

YAML

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

Properties

Description

A friendly description for this DB cluster parameter group.

Required: Yes

Type: String

Update requires: Replacement

Family

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.

Note

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

Parameters

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

Required: Yes

Type: Json

Update requires: No interruption

Tags

Tags to assign to the DB cluster parameter group.

Required: No

Type: List of Tag

Update requires: No interruption

Return Values

Ref

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.

Examples

The following snippet creates a parameter group that sets the character set database to UTF32:

JSON

{ "RDSDBClusterParameterGroup": { "Type": "AWS: : RDS: : DBClusterParameterGroup", "Properties": { "Parameters": { "character_set_database": "utf32" }, "Family": "aurora5.6", "Description": "Asampleparametergroup" } } }

YAML

--- RDSDBClusterParameterGroup: Properties: Description: "A sample parameter group" Family: aurora5.6 Parameters: character_set_database: utf32 Type: "AWS::RDS::DBClusterParameterGroup"