Amazon Relational Database Service
Command Line Interface Reference (API Version 2012-04-23)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

rds-create-db-parameter-group

Description

Creates a 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 rds-modify-db-parameter-group. Once you've created a DB Parameter Group, you need to associate it with your DB Instance using rds-modify-db-instance. 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.

Syntax

rds-create-db-parameter-group DBParameterGroupName

-d (--description) value

-f (--db-parameter-group-family) value

[General Options]

Options

NameDescriptionRequired

DBParameterGroupName

The name for the DB Parameter Group.

Type: String

Default: None

Constraints: Is non-preserving and case-insensitive. Must contain visible characters only. Must be 1 to 63 alphanumeric characters or hyphens. Must not be "Default".

Example: --db-parameter-group-name mydbparametergroup

Yes

-d value

--description value

The description for the DB Parameter Group.

Type: String

Default: None

Constraints: Must not exceed 255 characters.

Example: -d "This is my parameter group"

Yes

-f value

--db-parameter-group-family value

The DB parameter group family. 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 compatible with that DB paramter group family.

Type: String

Default: None

Example: -f MySQL5.1

Yes

Output

The command returns the following information:

  • Group Name—The user-supplied DB Parameter Group name

  • Parameter Group Family—Parameter group family to which this group applies.

  • Description—The description of the DB Parameter Group

Examples

Create a DB Parameter Group

This example creates a new DB Parameter Group.

PROMPT> rds-create-db-parameter-group mydbparametergroup -f mysql5.1 -d "My first DB Parameter Group"

DBPARAMETERGROUP  Group Name           Parameter Group Family  Description
DBPARAMETERGROUP  mydbparametergroup   mysql5.1                My first DB Parameter Group