Files
doc-exports/docs/taurusdb/api-ref/gaussdb_11_0016.html
wangdengke2 ee9f8aa0b6 taurusdb_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>
2025-10-30 15:48:33 +00:00

181 lines
15 KiB
HTML

<a name="gaussdb_11_0016"></a><a name="gaussdb_11_0016"></a>
<h1 class="topictitle1">Deleting a Read Replica</h1>
<div id="body8662426"><div class="section" id="gaussdb_11_0016__en-us_topic_0000001297664649_section4284989"><h4 class="sectiontitle">Function</h4><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p0506143014918">This API is used to delete a read replica. Before calling this API:</p>
<ul id="gaussdb_11_0016__en-us_topic_0000001297664649_ul924420236520"><li id="gaussdb_11_0016__en-us_topic_0000001267522832_en-us_topic_0000001250985350_li136356359522">Learn how to <a href="gaussdb_03_0001.html">authorize and authenticate</a> it.</li><li id="gaussdb_11_0016__en-us_topic_0000001267522832_en-us_topic_0000001250985350_li1991981933613">Obtain the required <a href="gaussdb_00_0003.html">region and endpoint</a>.</li></ul>
</div>
<div class="section" id="gaussdb_11_0016__en-us_topic_0000001297664649_section38564907"><h4 class="sectiontitle">URI</h4><ul id="gaussdb_11_0016__en-us_topic_0000001297664649_ul13194498"><li id="gaussdb_11_0016__en-us_topic_0000001297664649_li51641620">URI format<p id="gaussdb_11_0016__en-us_topic_0000001297664649_p819462816594"><a name="gaussdb_11_0016__en-us_topic_0000001297664649_li51641620"></a><a name="en-us_topic_0000001297664649_li51641620"></a>DELETE https://{endpoint}/mysql/v3/{project_id}/instances/{instance_id}/nodes/{node_id}</p>
</li><li id="gaussdb_11_0016__en-us_topic_0000001297664649_li4411135064210">URI example<p id="gaussdb_11_0016__p197591101041"><a name="gaussdb_11_0016__en-us_topic_0000001297664649_li4411135064210"></a><a name="en-us_topic_0000001297664649_li4411135064210"></a>DELETE https://gaussdb-mysql.eu-de.otc.t-systems.com/mysql/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/nodes/d11ae66fsfdsaer3w3ino9</p>
</li><li id="gaussdb_11_0016__en-us_topic_0000001297664649_li22221662">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="gaussdb_11_0016__en-us_topic_0000001297664649_table65777232" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="gaussdb_11_0016__en-us_topic_0000001297664649_row46529701"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.3.1.2.4.1.1"><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p10809459"><strong id="gaussdb_11_0016__en-us_topic_0000001297664649_b14734114718102">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.3.1.2.4.1.2"><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p3150961">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.3.1.2.4.1.3"><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p53901255"><strong id="gaussdb_11_0016__en-us_topic_0000001297664649_b1767410413119">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="gaussdb_11_0016__en-us_topic_0000001297664649_row3925534"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.1 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p49532829">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.2 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p52736237">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.3 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p43776822">Project ID of a tenant in a region.</p>
<p id="gaussdb_11_0016__en-us_topic_0000001297664649_p178064411566">To obtain this value, see <a href="gaussdb_10_0004.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="gaussdb_11_0016__en-us_topic_0000001297664649_row19402550154517"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.1 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p1046217474614">instance_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.2 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p246284104619">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.3 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p18462124174611">Instance ID, which is compliant with the UUID format.</p>
</td>
</tr>
<tr id="gaussdb_11_0016__en-us_topic_0000001297664649_row1858005911288"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.1 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p97461944293">node_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.2 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p1757865915283">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.3.1.2.4.1.3 "><p id="gaussdb_11_0016__en-us_topic_0000001297664649_p257813596281">Read-only node ID, which is compliant with the UUID format.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="gaussdb_11_0016__section2308155321319"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="gaussdb_11_0016__en-us_topic_0000001181562670_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="gaussdb_11_0016__row18308353201316"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="gaussdb_11_0016__p13081253201310">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="gaussdb_11_0016__p1030817530138">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.99%" id="mcps1.3.3.2.2.5.1.3"><p id="gaussdb_11_0016__p630845381317">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40.01%" id="mcps1.3.3.2.2.5.1.4"><p id="gaussdb_11_0016__p1309953111313">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="gaussdb_11_0016__row1930825381316"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="gaussdb_11_0016__p18309195371316">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="gaussdb_11_0016__p1309155313138">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.99%" headers="mcps1.3.3.2.2.5.1.3 "><p id="gaussdb_11_0016__p630916536137">String</p>
</td>
<td class="cellrowborder" valign="top" width="40.01%" headers="mcps1.3.3.2.2.5.1.4 "><p id="gaussdb_11_0016__p43091353131316">User token.</p>
</td>
</tr>
<tr id="gaussdb_11_0016__row430813536136"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="gaussdb_11_0016__p1230945310138">X-Language</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="gaussdb_11_0016__p1230911532133">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.99%" headers="mcps1.3.3.2.2.5.1.3 "><p id="gaussdb_11_0016__p7309453171317">String</p>
</td>
<td class="cellrowborder" valign="top" width="40.01%" headers="mcps1.3.3.2.2.5.1.4 "><p id="gaussdb_11_0016__p1030995341319">Language.</p>
</td>
</tr>
<tr id="gaussdb_11_0016__row134943311504"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="gaussdb_11_0016__p15665114311157">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="gaussdb_11_0016__p36651643101518">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.99%" headers="mcps1.3.3.2.2.5.1.3 "><p id="gaussdb_11_0016__p10665443181514">String</p>
</td>
<td class="cellrowborder" valign="top" width="40.01%" headers="mcps1.3.3.2.2.5.1.4 "><p id="gaussdb_11_0016__p1866504318159">MIME type of the request body. You are advised to use the default value <strong id="gaussdb_11_0016__b132775009573523">application/json</strong>. For APIs used to upload objects or images, the value can vary depending on the flow type.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="gaussdb_11_0016__section6309165314134"><h4 class="sectiontitle">Response Parameters</h4><p id="gaussdb_11_0016__p1530916534132"><strong id="gaussdb_11_0016__b130912536131">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="gaussdb_11_0016__en-us_topic_0000001181562670_response_MysqlJobId" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response body parameters</caption><thead align="left"><tr id="gaussdb_11_0016__row3310125310139"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.1"><p id="gaussdb_11_0016__p163101536137">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.2"><p id="gaussdb_11_0016__p14310185321318">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.3.2.4.1.3"><p id="gaussdb_11_0016__p15310253151319">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="gaussdb_11_0016__row131045318135"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="gaussdb_11_0016__p93101953191317">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="gaussdb_11_0016__p8310853151319">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="gaussdb_11_0016__p16655115865012">ID of the task for deleting a read replica.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="gaussdb_11_0016__p143101353131318"><strong id="gaussdb_11_0016__b207099640372459">Status code: 400</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="gaussdb_11_0016__en-us_topic_0000001181562670_response_MysqlErrorResponse" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response body parameters</caption><thead align="left"><tr id="gaussdb_11_0016__row53119535139"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.4.1.1"><p id="gaussdb_11_0016__p12311145315134">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.4.1.2"><p id="gaussdb_11_0016__p13311205311139">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.5.2.4.1.3"><p id="gaussdb_11_0016__p4311205316136">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="gaussdb_11_0016__row133111153101312"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="gaussdb_11_0016__p11311165320133">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="gaussdb_11_0016__p15311053191316">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="gaussdb_11_0016__p1931175310138">Error code.</p>
</td>
</tr>
<tr id="gaussdb_11_0016__row143115538131"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="gaussdb_11_0016__p43115534133">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="gaussdb_11_0016__p13312553151319">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="gaussdb_11_0016__p113127539139">Error message.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="gaussdb_11_0016__p12312155371312"><strong id="gaussdb_11_0016__b8997009086407">Status code: 500</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="gaussdb_11_0016__table7312053171314" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="gaussdb_11_0016__row113121753131313"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.4.1.1"><p id="gaussdb_11_0016__p103126538132">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.4.1.2"><p id="gaussdb_11_0016__p143121653201318">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.7.2.4.1.3"><p id="gaussdb_11_0016__p11312145351313">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="gaussdb_11_0016__row11312195311311"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="gaussdb_11_0016__p83121453131315">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="gaussdb_11_0016__p83131553171318">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="gaussdb_11_0016__p63131753161314">Error code.</p>
</td>
</tr>
<tr id="gaussdb_11_0016__row113121653151314"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="gaussdb_11_0016__p83130530137">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="gaussdb_11_0016__p103131653111314">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="gaussdb_11_0016__p8313553111318">Error message.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="gaussdb_11_0016__section2164194818121"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="gaussdb_11_0016__screen1468904655315">DELETE https://gaussdb-mysql.eu-de.otc.t-systems.com/mysql/v3/0483b6b16e954cb88930a360d2c4e663/instances/3d39c18788b54a919bab633874c159dfin01/nodes/ss62c18799854a919bab633874c159dfin55</pre>
</div>
<div class="section" id="gaussdb_11_0016__section1931315331310"><h4 class="sectiontitle">Example Response</h4><p id="gaussdb_11_0016__p231318533136"><strong id="gaussdb_11_0016__b21438476506407">Status code: 500</strong></p>
<p id="gaussdb_11_0016__p23139536137">Server error.</p>
<pre class="screen" id="gaussdb_11_0016__screen10313155341318">{
"job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890"
}</pre>
</div>
<div class="section" id="gaussdb_11_0016__section4778540915440"><h4 class="sectiontitle">Status Code</h4><p id="gaussdb_11_0016__p0723374409">For details, see <a href="gaussdb_10_0002.html">Status Codes</a>.</p>
</div>
<div class="section" id="gaussdb_11_0016__section2557116171718"><h4 class="sectiontitle">Error Code</h4><p id="gaussdb_11_0016__p855716160178">For details, see <a href="gaussdb_10_0003.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="gaussdb_11_0003.html">Instance Management</a></div>
</div>
</div>