You can call the CloneParameterGroup operation to copy a parameter template to the current region or another region.

You can apply a parameter template to an instance to configure a number of parameters at a time. For more information, see Use a parameter template to configure the parameters of ApsaraDB RDS for MySQL instances or Use a parameter template to configure the parameters of ApsaraDB RDS for PostgreSQL instances.

Note This operation is supported only when your RDS instance runs MySQL or PostgreSQL.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CloneParameterGroup

The operation that you want to perform. Set the value to CloneParameterGroup.

RegionId String Yes cn-hangzhou

The ID of the source region to which the parameter template belongs. You can call the DescribeRegions operation to query the most recent region list.

TargetRegionId String Yes cn-qingdao

The ID of the destination region. You can call the DescribeRegions operation to query the most recent region list.

ParameterGroupId String Yes rpg-13ppdh****

The ID of the parameter template. You can call the DescribeParameterGroups operation to query the most recent parameter templates in a region.

ParameterGroupName String Yes tartestgroup

The name of the parameter template in the destination region.

ParameterGroupDesc String Yes CloneGroup1

The description of the parameter template in the destination region.

Response parameters

Parameter Type Example Description
RequestId String 1D3D5995-6BDD-43B5-93B8-2C41A2ACD6AA

The ID of the request.

Examples

Sample requests

http(s)://rds.aliyuncs.com/?Action=CloneParameterGroup
&RegionId=cn-hangzhou
&TargetRegionId=cn-qingdao
&ParameterGroupId=rpg-13ppdh****
&ParameterGroupName=tartestgroup
&ParameterGroupDesc=CloneGroup1
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CloneParameterGroupResponse>
<RequestId>1D3D5995-6BDD-43B5-93B8-2C41A2ACD6AA</RequestId>
</CloneParameterGroupResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1D3D5995-6BDD-43B5-93B8-2C41A2ACD6AA"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidParameterGroupId.Malformed Specified parameterGroupId is not valid. The error message returned because the value of the parameterGroupId parameter is invalid. You can call the DescribeParameterGroups operation to query the IDs of parameter templates.

For a list of error codes, visit the API Error Center.