CreateDBParameterGroup - Amazon Relational Database Service

Description

Creates a new DB Parameter Group.

A DB Parameter Group is initially created with the default parameters for the database engine used by the DB Instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB Parameter Group, you need to associate it with your DB Instance using ModifyDBInstance. When you associate a new DB Parameter Group with a running DB Instance, you need to reboot the DB Instance for the new DB Parameter Group and associated settings to take effect.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

Name Description Required

DBParameterGroupFamily

The DB Parameter Group Family name. A DB Parameter Group can be associated with one and only one DB Parameter Group Family, and can be applied only to a DB Instance running a database engine and engine version compatible with that DB Parameter Group Family.

Type: String

Yes

DBParameterGroupName

The name of the DB Parameter Group.

Constraints:

Must be 1 to 255 alphanumeric characters
First character must be a letter
Cannot end with a hyphen or contain two consecutive hyphens

	Note
	This value is stored as a lower-case string.

Type: String

Yes

Description

The description for the DB Parameter Group.

Type: String

Yes

Response Elements

The following elements come wrapped in a DBParameterGroup structure.

Name Description

Name	Description
`DBParameterGroupFamily`	Provides the name of the DB Parameter Group Family that this DB Parameter Group is compatible with. Type: String
`DBParameterGroupName`	Provides the name of the DB Parameter Group. Type: String
`Description`	Provides the customer-specified description for this DB Parameter Group. Type: String

DBParameterGroupFamily

Provides the name of the DB Parameter Group Family that this DB Parameter Group is compatible with.

Type: String

DBParameterGroupName

Provides the name of the DB Parameter Group.

Type: String

Description

Provides the customer-specified description for this DB Parameter Group.

Type: String

Errors

For information about the common errors that all actions use, see Common Errors.

Error	Description	HTTP Status Code
`DBParameterGroupAlreadyExists`	A DB Parameter Group with the same name exists.	400
`DBParameterGroupQuotaExceeded`	Request would result in user exceeding the allowed number of DB Parameter Groups.	400

Examples

Sample Request

https://rds.amazonaws.com/
    ?Action=CreateDBParameterGroup
    &DBParameterGroupName=mydbparametergroup3
    &DBParameterGroupFamily=MySQL5.1
    &Version=2012-04-23
    &Description=My%20new%20DBParameterGroup
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2011-05-11T18%3A09%3A29.793Z
    &AWSAccessKeyId=<AWS Access Key ID>
    &Signature=<Signature>

Sample Response

<CreateDBParameterGroupResponse xmlns="http://rds.amazonaws.com/doc/2012-04-23/">
  <CreateDBParameterGroupResult>
    <DBParameterGroup>
      <DBParameterGroupFamily>mysql5.1</DBParameterGroupFamily>
      <Description>My new DBParameterGroup</Description>
      <DBParameterGroupName>mydbparametergroup3</DBParameterGroupName>
    </DBParameterGroup>
  </CreateDBParameterGroupResult>
  <ResponseMetadata>
    <RequestId>0b447b66-bf36-11de-a88b-7b5b3d23b3a7</RequestId>
  </ResponseMetadata>
</CreateDBParameterGroupResponse>