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.


   "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.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance that is associated with the parameter group before the change can take effect.

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


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.