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

CopyDBParameterGroup

Copies the specified DB parameter group.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

SourceDBParameterGroupIdentifier

The identifier or ARN for the source DB parameter group. For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

Constraints:

  • Must specify a valid DB parameter group.

  • Must specify a valid DB parameter group identifier, for example my-db-param-group, or a valid ARN.

Type: String

Required: Yes

Tags.Tag.N

A list of tags.

Type: array of Tag objects

Required: No

TargetDBParameterGroupDescription

A description for the copied DB parameter group.

Type: String

Required: Yes

TargetDBParameterGroupIdentifier

The identifier for the copied DB parameter group.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 alphanumeric characters or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-db-parameter-group

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

DBParameterGroup

Contains the result of a successful invocation of the CreateDBParameterGroup action.

This data type is used as a request parameter in the DeleteDBParameterGroup action, and as a response element in the DescribeDBParameterGroups action.

Type: DBParameterGroup object

Errors

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

DBParameterGroupAlreadyExists

A DB parameter group with the same name exists.

HTTP Status Code: 400

DBParameterGroupNotFound

DBParameterGroupName does not refer to an existing DB parameter group.

HTTP Status Code: 404

DBParameterGroupQuotaExceeded

Request would result in user exceeding the allowed number of DB parameter groups.

HTTP Status Code: 400

Example

Sample Request

Copy
https://rds.us-east-1.amazonaws.com/ ?Action=CopyDBParameterGroup &SignatureMethod=HmacSHA256 &SignatureVersion=4 &SourceDBParameterGroupIdentifier=arn%3Aaws%3Ards%3Aus-west-2%3A815981987263%3pg%3Amy-remote-param-group &TargetDBParameterGroupIdentifier=new-local-param-group &TargetDBParameterGroupDescription=description &Version=2014-09-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20140429/us-east-1/rds/aws4_request &X-Amz-Date=20140429T175351Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=9164337efa99caf850e874a1cb7ef62f3cea29d0b448b9e0e7c53b288ddffed2

Sample Response

Copy
<CopyDBParameterGroupResponse xmlns="http://rds.amazonaws.com/doc/2014-09-01/"> <CopyDBParameterGroupResult> <DBParameterGroup> <DBParameterGroupFamily>mysql5.6</DBParameterGroupFamily> <Description>description</Description> <DBParameterGroupName>new-local-param-group</DBParameterGroupName> </DBParameterGroup> </CopyDBParameterGroupResult> <ResponseMetadata> <RequestId>2928d60e-beb6-11d3-8e5c-3ccda5460c46</RequestId> </ResponseMetadata> </CopyDBParameterGroupResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: