Updated on 2026-05-30 GMT+08:00

Replicating a Parameter Template (a V3 API)

Function

This API is used to replicate a parameter template.

Constraints

None

API Calling

For details, see Calling APIs.

Authorization Information

Each account has permissions to call all APIs, but IAM users must have the required permissions specifically assigned.

  • If you are using role/policy-based authorization, see the required permissions in Permissions Policies and Supported Actions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    ddm::copyParamGroup

    Write

    parameterGroup *

    -

    ddm:param:create

    -

URI

POST /v3/{project_id}/configurations/{config_id}/copy

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID of a tenant in a region

To obtain this value, see Obtaining a Project ID.

Constraints

N/A

Range

The value can contain 32 characters. Only letters and digits are supported.

Default Value

N/A

config_id

Yes

String

Definition

Parameter template ID

Constraints

A default parameter template cannot be replicated.

Range

The value can contain 36 characters. Only letters and digits are allowed.

Default Value

N/A

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

new_name

Yes

String

Definition

Name of the new parameter template

Constraints

N/A

Range

The parameter template name can contain 1 to 64 characters. It can contain only letters, digits, hyphens (-), underscores (_), and periods (.).

Default Value

N/A

description

No

String

Definition

Description of the new parameter template.

Constraints

N/A

Range

The value can contain a maximum of 256 characters and cannot contain carriage return characters or the following special characters ! < " = ' > &

Default Value

N/A

Example Request

Replicating a parameter template

POST https://{endpoint}/v3/a8e2a5e2a6xxxxxxxxxx5af5b9ddabe5/configurations/31b1304fc0xxxxxxxxxxf846c92318edpr09/copy

{
  "new_name" : "paramTemplate-test",
  "description" : ""
}

Response Parameters

None

Example Response

Status Codes

Error Codes

For details, see Error Codes.