Files
doc-exports/docs/rds/api-ref/rds_09_0309.html
wangdengke2 1ddaec1a62 rds_api
Reviewed-by: Gladkov, Maksim <mgladkov@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: wangdengke2 <wangdengke2@huawei.com>
Co-committed-by: wangdengke2 <wangdengke2@huawei.com>
2026-01-29 11:28:26 +00:00

203 lines
16 KiB
HTML

<a name="rds_09_0309"></a><a name="rds_09_0309"></a>
<h1 class="topictitle1">Replicating a Parameter Template</h1>
<div id="body0000002506523301"><div class="section" id="rds_09_0309__section34921715163618"><h4 class="sectiontitle">Function</h4><p id="rds_09_0309__p1224105211917">This API is used to replicate a parameter template.</p>
<ul id="rds_09_0309__ul12259155218373"><li id="rds_09_0309__en-us_topic_0240111818_li836513175363">Before calling an API, you need to understand the API in <a href="rds_03_0001.html">Authentication</a>.</li><li id="rds_09_0309__en-us_topic_0240111818_li1991981933613">Before calling this API, obtain the required <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">region and endpoint</a>.</li></ul>
</div>
<div class="section" id="rds_09_0309__section349221518369"><h4 class="sectiontitle">URI</h4><ul id="rds_09_0309__ul5788171512366"><li id="rds_09_0309__li187887157365">URI format<p id="rds_09_0309__p107889155367"><a name="rds_09_0309__li187887157365"></a><a name="li187887157365"></a>POST https://{<em id="rds_09_0309__i426828201615">Endpoint</em>}/v3/{<em id="rds_09_0309__i94964418507">project_id</em>}/configurations/{config_id}/copy</p>
</li><li id="rds_09_0309__li57880154363">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_09_0309__table350771512364" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="rds_09_0309__row178891510369"><th align="left" class="cellrowborder" valign="top" width="21.21%" id="mcps1.3.2.2.2.1.2.4.1.1"><p id="rds_09_0309__p2078801512364"><strong id="rds_09_0309__b84235270691445">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="28.610000000000003%" id="mcps1.3.2.2.2.1.2.4.1.2"><p id="rds_09_0309__p1778841553610"><strong id="rds_09_0309__b6911841153320">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.18%" id="mcps1.3.2.2.2.1.2.4.1.3"><p id="rds_09_0309__p0788171593617"><strong id="rds_09_0309__b842352706163417">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="rds_09_0309__row16788161516363"><td class="cellrowborder" valign="top" width="21.21%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="rds_09_0309__p1478816159368">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="28.610000000000003%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="rds_09_0309__p77882156369">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.18%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="rds_09_0309__p107881159368">Specifies the project ID of a tenant in a region.</p>
<p id="rds_09_0309__p1955917142067">For details about how to obtain the project ID, see <a href="rds_03_0002.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="rds_09_0309__row14788171523612"><td class="cellrowborder" valign="top" width="21.21%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="rds_09_0309__p107881815193611">config_id</p>
</td>
<td class="cellrowborder" valign="top" width="28.610000000000003%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="rds_09_0309__p157881915113616">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.18%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="rds_09_0309__p77882015143610">Specifies the parameter template ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="rds_09_0309__section15386150366"><h4 class="sectiontitle">Request</h4><ul id="rds_09_0309__ul207881915183612"><li id="rds_09_0309__li16788121519369">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_09_0309__table12536623333" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="rds_09_0309__row153612211337"><th align="left" class="cellrowborder" valign="top" width="19.7%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="rds_09_0309__p95111733143318">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.780000000000001%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="rds_09_0309__p13511123373311">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.959999999999999%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="rds_09_0309__p125111433133312">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53.559999999999995%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="rds_09_0309__p551110331335">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="rds_09_0309__row353717218338"><td class="cellrowborder" valign="top" width="19.7%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="rds_09_0309__p18511533163317">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="13.780000000000001%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="rds_09_0309__p13511153333312">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="12.959999999999999%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="rds_09_0309__p55111833183319">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.559999999999995%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="rds_09_0309__p35111331332">The content type.</p>
<p id="rds_09_0309__p1351133311330">The default value is <strong id="rds_09_0309__b105111133143310">application/json</strong>.</p>
</td>
</tr>
<tr id="rds_09_0309__row05378213331"><td class="cellrowborder" valign="top" width="19.7%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="rds_09_0309__p1163015550331">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="13.780000000000001%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="rds_09_0309__p1963035563316">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="12.959999999999999%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="rds_09_0309__p1630105520331">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.559999999999995%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="rds_09_0309__p1086851153317">Specifies the user token.</p>
<p id="rds_09_0309__p1057635831">The user token is a response to the API used to <a href="https://docs.otc.t-systems.com/en-us/api/iam/en-us_topic_0057845583.html" target="_blank" rel="noopener noreferrer">obtain a user token</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_09_0309__table05381415103619" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameter description</caption><thead align="left"><tr id="rds_09_0309__row97881015193611"><th align="left" class="cellrowborder" valign="top" width="19.13%" id="mcps1.3.3.2.1.2.2.5.1.1"><p id="rds_09_0309__p778891543617"><strong id="rds_09_0309__b1501362188">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.41%" id="mcps1.3.3.2.1.2.2.5.1.2"><p id="rds_09_0309__p10788141533620"><strong id="rds_09_0309__b1119184114332">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23.75%" id="mcps1.3.3.2.1.2.2.5.1.3"><p id="rds_09_0309__p167880155368"><strong id="rds_09_0309__b842352706164541">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="39.71%" id="mcps1.3.3.2.1.2.2.5.1.4"><p id="rds_09_0309__p147881915193611"><strong id="rds_09_0309__b314512256">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="rds_09_0309__row5788121519368"><td class="cellrowborder" valign="top" width="19.13%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="rds_09_0309__p1199013982310">name</p>
</td>
<td class="cellrowborder" valign="top" width="17.41%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="rds_09_0309__p89901239192317">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="23.75%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="rds_09_0309__p7991163952320">String</p>
</td>
<td class="cellrowborder" valign="top" width="39.71%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="rds_09_0309__p1351982315114">Name of the new parameter template.</p>
<p id="rds_09_0309__p3991153922314">The name can contain 1 to 64 characters. It is case-sensitive and can contain only letters, digits, periods (.), underscores (_), and hyphens (-).</p>
</td>
</tr>
<tr id="rds_09_0309__row2093822155614"><td class="cellrowborder" valign="top" width="19.13%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="rds_09_0309__p599143911238">description</p>
</td>
<td class="cellrowborder" valign="top" width="17.41%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="rds_09_0309__p19992103952313">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.75%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="rds_09_0309__p1999213942318">String</p>
</td>
<td class="cellrowborder" valign="top" width="39.71%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="rds_09_0309__p187871427131120">Description of the new parameter template.</p>
<p id="rds_09_0309__p19992539172314">The description can contain 0 to 256 characters and cannot contain the following characters: ! &lt; &gt; = &amp; " '</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="rds_09_0309__section1811612591711"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="rds_09_0309__screen6234301180">POST https://rds.eu-de.otc.t-systems.com/v3/054e292c9880d4992f02c0196d3ea468/configurations/66251c9024774eeb9edd8663a4cbb0a1pr04/copy
{
"name" : "copy_by_v31",
"description" : "copy"
}</pre>
</div>
<div class="section" id="rds_09_0309__section8569161515366"><h4 class="sectiontitle">Response</h4><ul id="rds_09_0309__ul1578821563619"><li id="rds_09_0309__li17788151583618">Normal response
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_09_0309__table1056917157367" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Parameter description</caption><thead align="left"><tr id="rds_09_0309__row97881615113617"><th align="left" class="cellrowborder" valign="top" width="25.509999999999998%" id="mcps1.3.5.2.1.1.2.4.1.1"><p id="rds_09_0309__p13788715133620"><strong id="rds_09_0309__b969820788">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="29.65%" id="mcps1.3.5.2.1.1.2.4.1.2"><p id="rds_09_0309__p978811516362"><strong id="rds_09_0309__b970759315">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.84%" id="mcps1.3.5.2.1.1.2.4.1.3"><p id="rds_09_0309__p177889156366"><strong id="rds_09_0309__b2037165250">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="rds_09_0309__row1378819159369"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_09_0309__p166663693016">id</p>
</td>
<td class="cellrowborder" valign="top" width="29.65%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_09_0309__p15666183693019">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_09_0309__p1766611362309">Parameter template ID.</p>
</td>
</tr>
<tr id="rds_09_0309__row178810158365"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_09_0309__p5666113633015">name</p>
</td>
<td class="cellrowborder" valign="top" width="29.65%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_09_0309__p86675365308">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_09_0309__p866733673017">Parameter template name.</p>
</td>
</tr>
<tr id="rds_09_0309__row8788715153611"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_09_0309__p4667336103014">description</p>
</td>
<td class="cellrowborder" valign="top" width="29.65%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_09_0309__p56679363307">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_09_0309__p3667123673013">Parameter template description.</p>
</td>
</tr>
<tr id="rds_09_0309__row10788161543616"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_09_0309__p96677364307">datastore_version_name</p>
</td>
<td class="cellrowborder" valign="top" width="29.65%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_09_0309__p19667143611303">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_09_0309__p8326111092216">Database version name.</p>
</td>
</tr>
<tr id="rds_09_0309__row124241638115214"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_09_0309__p1566710364301">datastore_name</p>
</td>
<td class="cellrowborder" valign="top" width="29.65%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_09_0309__p7667136193013">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_09_0309__p366710367303">Database name.</p>
</td>
</tr>
<tr id="rds_09_0309__row1549611514194"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_09_0309__p666723620300">create_time</p>
</td>
<td class="cellrowborder" valign="top" width="29.65%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_09_0309__p7667163693012">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_09_0309__p12681154362212">Creation time.</p>
<p id="rds_09_0309__p126671236113011">The value is in the yyyy-MM-ddTHH:mm:ssZ format. <strong id="rds_09_0309__b97701819133718">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="rds_09_0309__b12128162218372">Z</strong> indicates the time zone offset.</p>
</td>
</tr>
<tr id="rds_09_0309__row2731155121916"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="rds_09_0309__p16667123683018">update_time</p>
</td>
<td class="cellrowborder" valign="top" width="29.65%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="rds_09_0309__p0667193616304">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="rds_09_0309__p177310517194">Update time.</p>
<p id="rds_09_0309__p3667123613019">The value is in the yyyy-MM-ddTHH:mm:ssZ format. <strong id="rds_09_0309__b372411376384">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="rds_09_0309__b117261937173819">Z</strong> indicates the time zone offset.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="rds_09_0309__ul68041615123617"><li id="rds_09_0309__li1280471518366">Example normal response<pre class="screen" id="rds_09_0309__screen1311828202015">{
"id" : "a73a272e50ba427397e90992fbb96f3cpr04",
"name" : "copy_by_v31",
"description" : "copy",
"datastore_version_name" : "mysql5.7",
"datastore_name" : "mysql",
"create_time" : "2022-10-31T08:24:06+0000",
"update_time" : "2022-10-31T08:24:06+0000"
}</pre>
</li><li id="rds_09_0309__li19251126312">Abnormal response<p id="rds_09_0309__p14804191573611"><a name="rds_09_0309__li19251126312"></a><a name="li19251126312"></a>For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
</li></ul>
</div>
<div class="section" id="rds_09_0309__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="rds_09_0309__en-us_topic_0032347778_ul7858132212142"><li id="rds_09_0309__en-us_topic_0032347778_li58581622171411">Normal<p id="rds_09_0309__en-us_topic_0032347778_p1040982941020"><a name="rds_09_0309__en-us_topic_0032347778_li58581622171411"></a><a name="en-us_topic_0032347778_li58581622171411"></a>200</p>
</li><li id="rds_09_0309__en-us_topic_0032347778_li11583183218149">Abnormal<p id="rds_09_0309__en-us_topic_0032347778_p0723374409"><a name="rds_09_0309__en-us_topic_0032347778_li11583183218149"></a><a name="en-us_topic_0032347778_li11583183218149"></a>For details, see <a href="en-us_topic_0032488240.html">Status Codes</a>.</p>
</li></ul>
</div>
<div class="section" id="rds_09_0309__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="rds_09_0309__en-us_topic_0032347778_p19357163913406">For details, see <a href="en-us_topic_0032488241.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0056887471.html">Parameter Configuration</a></div>
</div>
</div>