AWS CloudFormation
User Guide (API Version 2010-05-15)


Creates a custom parameter group for an RDS database family. For more information about RDS parameter groups, see Working with DB Parameter Groups in the Amazon Relational Database Service User Guide.

This type can be declared in a template and referenced in the DBParameterGroupName parameter of AWS::RDS::DBInstance.


Applying a ParameterGroup to a DBInstance may require the instance to reboot, resulting in a database outage for the duration of the reboot.


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


{ "Type" : "AWS::RDS::DBParameterGroup", "Properties" : { "Description" : String, "Family" : String, "Parameters" : DBParameters, "Tags" : [ Resource Tag, ... ] } }


Type: AWS::RDS::DBParameterGroup Properties: Description: String Family: String Parameters: DBParameters Tags: - Resource Tag



A friendly description of the RDS parameter group. For example, "My Parameter Group".

Required: Yes

Type: String

Update requires: Updates are not supported.


The database family of this RDS parameter group. For example, "MySQL5.1".

Required: Yes

Type: String

Update requires: Updates are not supported.


The parameters to set for this RDS parameter group.

Required: No

Type: A JSON object consisting of string key-value pairs, as shown in the following example:

"Parameters" : { "Key1" : "Value1", "Key2" : "Value2", "Key3" : "Value3" }

Update requires: No interruption or Some interruptions. Changes to dynamic parameters are applied immediately. During an update, if you have static parameters (whether they were changed or not), triggers AWS CloudFormation to reboot the associated DB instance without failover.


The tags that you want to attach to the RDS parameter group.

Required: No

Type: A list of resource tags.

Update requires: No interruption

Return Values


When the logical ID of this resource is provided to the Ref intrinsic function, Ref returns the resource name. For example:

{ "Ref": "MyDBParameterGroup" }

For the RDS::DBParameterGroup with the logical ID "MyDBParameterGroup", Ref will return the resource name.

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


The following snippet creates a parameter group for an Aurora DB cluster that applies the IGNORE_SPACE SQL mode.


"RDSDBParameterGroup": { "Type": "AWS::RDS::DBParameterGroup", "Properties" : { "Description" : "CloudFormation Sample Parameter Group", "Family" : "aurora5.6", "Parameters" : { "sql_mode": "IGNORE_SPACE" } } }


RDSDBParameterGroup: Type: AWS::RDS::DBParameterGroup Properties: Description: CloudFormation Sample Parameter Group Family: aurora5.6 Parameters: sql_mode: IGNORE_SPACE