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


Copies the specified DB cluster parameter group.

Request Parameters

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


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


  • Must specify a valid DB cluster parameter group.

  • If the source DB cluster parameter group is in the same AWS Region as the copy, specify a valid DB parameter group identifier, for example my-db-cluster-param-group, or a valid ARN.

  • If the source DB parameter group is in a different AWS Region than the copy, specify a valid DB cluster parameter group ARN, for example arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1.

Type: String

Required: Yes


A list of tags. For more information, see Tagging Amazon RDS Resources.

Type: Array of Tag objects

Required: No


A description for the copied DB cluster parameter group.

Type: String

Required: Yes


The identifier for the copied DB cluster parameter group.


  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-cluster-param-group1

Type: String

Required: Yes

Response Elements

The following element is returned by the service.


Contains the details of an Amazon RDS DB cluster parameter group.

This data type is used as a response element in the DescribeDBClusterParameterGroups action.

Type: DBClusterParameterGroup object


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


A DB parameter group with the same name exists.

HTTP Status Code: 400


DBParameterGroupName does not refer to an existing DB parameter group.

HTTP Status Code: 404


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

HTTP Status Code: 400


Sample Request ?Action=CopyDBClusterParameterGroup &SignatureMethod=HmacSHA256 &SignatureVersion=4 &SourceDBClusterParameterGroupIdentifier=arn%3Aaws%3Ards%3Aus-east-1%3A815981987263%3cluster-pg%3Amy-cluster-pg &TargetDBParameterGroupIdentifier=new-cluster-pg &TargetDBParameterGroupDescription=New%20cluster%20group &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20160705/us-east-1/rds/aws4_request &X-Amz-Date=20160705T143101Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=9164337efa99caf850e874a1cb7ef62f3cea29d0b448b9e0e7c53b288ddffed2

Sample Response

<CopyDBClusterParameterGroupResponse xmlns=""> <CreateDBClusterParameterGroupResult> <DBClusterParameterGroup> <DBParameterGroupFamily>aurora5.6</DBParameterGroupFamily> <Description>New cluster group</Description> <DBClusterParameterGroupName>new-cluster-pg</DBClusterParameterGroupName> </DBClusterParameterGroup> </CreateDBClusterParameterGroupResult> <ResponseMetadata> <RequestId>ae81a963-cd9d-11e4-8b88-8351746a4c92</RequestId> </ResponseMetadata> </CopyDBClusterParameterGroupResponse>

See Also

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