Menu
Amazon Relational Database Service
Command Line Interface Reference (API Version 2014-10-31)

rds-copy-db-parameter-group

The Amazon RDS Command Line Interface (RDS CLI) has been deprecated. Instead, use the AWS CLI for RDS. To learn how to download and use the AWS CLI, see AWS Command Line Interface User Guide. For RDS commands available in the AWS CLI, see AWS CLI Reference for Amazon RDS.

The AWS CLI does not currently support the DownloadCompleteDBLogFile REST API action. To download an entire log file at once, rather than in parts using the download-db-log-file-portion command, use the last published RDS CLI and the rds-download-db-logfile command.

Description

Creates a copy of the specified DB parameter group.

Syntax

rds-copy-db-parameter-group source-db-parameter-group-identifier

-t (--target-db-parameter-group-identifier) value

-td (--target-db-parameter-group-description) value

[-tk (--tag-key) value ]

[-tv (--tag-value) value ]

[General Options]

Options

Name Description Required

--source-db-parameter-group-identifier value

-s value

The identifier of the source DB parameter group. This unique name or ARN identifies an existing DB parameter group to copy.

This parameter is the default parameter and can be passed as the first value in the command and without a parameter name, for example: rds-copy-db-parameter-group my-source-db-parameter-group-identifier.

Type: String

Default: None

Constraints:

  • Must specify a valid DB parameter group.

  • If the source DB parameter group is in the same region as the copy, specify a valid DB parameter group identifier, for example my-db-parameter-group.

  • If the source DB parameter group is in a different region than the copy, specify a valid DB parameter group ARN, for example arn:aws:rds:us-west-2:123456789012:og:special-parameters, or a valid ARN.

Yes

--target-db-parameter-group-identifier value

-t value

The identifier for the DB parameter group to create.

Type: String

Default: None

Constraints:

  • Cannot be null, empty, or blank.

  • Must contain 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: -t my-copied-db-parameter-group-id

Yes

--target-db-parameter-group-description value

-td value

A description of the DB parameter group to create.

Type: String

Default: None

Yes

--tag-key

-tk

The name of a tag to add for the DB parameter group.

No

--tag-value

-tv

The value of the tag to add for the DB parameter group.

No

Output

The command returns the following information:

Note

Output values list the possible values returned by CLI commands. Not all values are returned for every call to a command. If a value is null or empty, it will not be included in the command output. For example, CLI commands to create or restore a DB instance will not return the Endpoint Address value because that value is null until the DB instance has finished being created or restored.

  • Group name—The name of the new DB parameter group.

  • Parameter group family—Parameter group family to which the new DB parameter group applies.

  • Description—The description of the new DB parameter group.

Examples

Copy a DB Parameter Group

The following example copies a DB parameter group and creates a new DB parameter group in the same region.

Copy
PROMPT> rds-copy-db-parameter-group my-source-db-parameter-group -t my-new-db-parameter-group -td "My new DB parameter group"