forked from docs/doc-exports
Wang , Deng Ke
21e968a153
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Wang , Deng Ke <wangdengke2@huawei.com> Co-committed-by: Wang , Deng Ke <wangdengke2@huawei.com>
138 lines
12 KiB
HTML
138 lines
12 KiB
HTML
<a name="rds_06_0038"></a><a name="rds_06_0038"></a>
|
|
|
|
<h1 class="topictitle1">Deleting Tags in Batches</h1>
|
|
<div id="body1574061742130"><div class="section" id="rds_06_0038__section61759636"><h4 class="sectiontitle">Function</h4><p id="rds_06_0038__p33831530">This API is used to delete tags in batches.</p>
|
|
<ul id="rds_06_0038__ul12259155218373"><li id="rds_06_0038__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_06_0038__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_06_0038__section18965813"><h4 class="sectiontitle">URI</h4><ul id="rds_06_0038__ul13194498"><li id="rds_06_0038__li41603465301">URI format<p id="rds_06_0038__p11160246123012"><a name="rds_06_0038__li41603465301"></a><a name="li41603465301"></a>POST https://{<em id="rds_06_0038__i11252164981618">Endpoint</em>}/v3/{project_id}/instances/{instance_id}/tags/action</p>
|
|
</li></ul>
|
|
<ul id="rds_06_0038__ul55999443"><li id="rds_06_0038__li21405046">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_06_0038__table65777232" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="rds_06_0038__row46529701"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.1.1.2.4.1.1"><p id="rds_06_0038__p10809459"><strong id="rds_06_0038__b84819153233">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.1.1.2.4.1.2"><p id="rds_06_0038__p3150961"><strong id="rds_06_0038__b08702015152312">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.1.1.2.4.1.3"><p id="rds_06_0038__p53901255"><strong id="rds_06_0038__b1161410160235">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_06_0038__row3925534"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="rds_06_0038__p49532829">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="rds_06_0038__p52736237">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="rds_06_0038__p43776822">Specifies the project ID of a tenant in a region.</p>
|
|
<p id="rds_06_0038__p186761044260">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_06_0038__row19780235152911"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.1.1.2.4.1.1 "><p id="rds_06_0038__p41557789155220">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.1.1.2.4.1.2 "><p id="rds_06_0038__p10737742155220">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.1.1.2.4.1.3 "><p id="rds_06_0038__p64450739155220">Specifies the DB instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_06_0038__section36474591"><h4 class="sectiontitle">Request</h4><ul id="rds_06_0038__ul1677317341210"><li id="rds_06_0038__li1830813567439">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rds_06_0038__table6426756154514" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="rds_06_0038__row142645664510"><th align="left" class="cellrowborder" valign="top" width="22.772277227722775%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="rds_06_0038__p17490046"><strong id="rds_06_0038__b96741627172313">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.792079207920793%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="rds_06_0038__p7407659"><strong id="rds_06_0038__b11348122882311">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.861386138613863%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="rds_06_0038__p63149496"><strong id="rds_06_0038__b218392915235">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="42.57425742574257%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="rds_06_0038__p14835533"><strong id="rds_06_0038__b5572030142313">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_06_0038__row4802428172710"><td class="cellrowborder" valign="top" width="22.772277227722775%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="rds_06_0038__p88021228182717">action</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.792079207920793%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="rds_06_0038__p1980232832715">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.861386138613863%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="rds_06_0038__p78021328152711">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.57425742574257%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="rds_06_0038__p158021928112712">Specifies the operation identifier (case sensitive), which is <strong id="rds_06_0038__b1973193114239">delete</strong> during the deletion operation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_06_0038__row34264566458"><td class="cellrowborder" valign="top" width="22.772277227722775%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="rds_06_0038__p1965465321213">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.792079207920793%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="rds_06_0038__p60181840">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.861386138613863%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="rds_06_0038__p46861368136">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.57425742574257%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="rds_06_0038__p185214553212">Specifies the tag list.</p>
|
|
<p id="rds_06_0038__p13622524588">For details, see <a href="#rds_06_0038__table9331195513220">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="rds_06_0038__table9331195513220"></a><a name="table9331195513220"></a><table cellpadding="4" cellspacing="0" summary="" id="rds_06_0038__table9331195513220" frame="border" border="1" rules="all"><caption><b>Table 3 </b>tags field data structure description</caption><thead align="left"><tr id="rds_06_0038__row1233225516327"><th align="left" class="cellrowborder" valign="top" width="22.772277227722775%" id="mcps1.3.3.2.1.2.2.5.1.1"><p id="rds_06_0038__p13321055143210"><strong id="rds_06_0038__b1907162513245">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.792079207920793%" id="mcps1.3.3.2.1.2.2.5.1.2"><p id="rds_06_0038__p233215511328"><strong id="rds_06_0038__b14713152619241">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.861386138613863%" id="mcps1.3.3.2.1.2.2.5.1.3"><p id="rds_06_0038__p14332655113212"><strong id="rds_06_0038__b1374222718246">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="42.57425742574257%" id="mcps1.3.3.2.1.2.2.5.1.4"><p id="rds_06_0038__p15332055113219"><strong id="rds_06_0038__b4612162822418">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rds_06_0038__row1433205523210"><td class="cellrowborder" valign="top" width="22.772277227722775%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="rds_06_0038__p163321755133220">key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.792079207920793%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="rds_06_0038__p3332105563215">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.861386138613863%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="rds_06_0038__p1433215593211">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.57425742574257%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="rds_06_0038__p22481240194513">Specifies the tag key, which contains a maximum of 127 Unicode characters.</p>
|
|
<p id="rds_06_0038__p19248114017455">The key cannot be left blank or an empty string.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rds_06_0038__row103322555324"><td class="cellrowborder" valign="top" width="22.772277227722775%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="rds_06_0038__p67321750123411">value</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.792079207920793%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="rds_06_0038__p53329558326">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.861386138613863%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="rds_06_0038__p6332855193216">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.57425742574257%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="rds_06_0038__p51141559152111">Specifies the tag value, which contains a maximum of 255 Unicode characters.</p>
|
|
<p id="rds_06_0038__p3618112192218">Deletion remarks:</p>
|
|
<ul id="rds_06_0038__ul1284313288226"><li id="rds_06_0038__li13965183042217">If <span class="parmname" id="rds_06_0038__parmname14238462528"><b>value</b></span> is not empty, delete tags by <span class="parmname" id="rds_06_0038__parmname1227613185219"><b>key</b></span>/<span class="parmname" id="rds_06_0038__parmname9794151515521"><b>value</b></span>.</li><li id="rds_06_0038__li19843728182217">If <span class="parmname" id="rds_06_0038__parmname10821184521"><b>value</b></span> is empty, delete tags by <span class="parmname" id="rds_06_0038__parmname098518172527"><b>key</b></span>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="rds_06_0038__ul0573141214517"><li id="rds_06_0038__li4411135064210">Example<p id="rds_06_0038__p1454414211213"><a name="rds_06_0038__li4411135064210"></a><a name="li4411135064210"></a>POST https://rds.eu-de.otc.t-systems.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/tags/action</p>
|
|
</li></ul>
|
|
<ul id="rds_06_0038__ul197315202514"><li id="rds_06_0038__li273118201854">Request example<pre class="codeblock" id="rds_06_0038__codeblock117316206512">{
|
|
"action": "delete",
|
|
"tags": [{
|
|
"key": "key1"
|
|
}, {
|
|
"key": "key2",
|
|
"value": "value2"
|
|
}]
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_06_0038__section59835867"><h4 class="sectiontitle">Response</h4><ul id="rds_06_0038__ul396612717394"><li id="rds_06_0038__li49661427193912">Normal Response<p id="rds_06_0038__p824011811104"><a name="rds_06_0038__li49661427193912"></a><a name="li49661427193912"></a>None</p>
|
|
</li><li id="rds_06_0038__li8200143916396">Abnormal Response<p id="rds_06_0038__p29415884"><a name="rds_06_0038__li8200143916396"></a><a name="li8200143916396"></a>For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="rds_06_0038__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="rds_06_0038__en-us_topic_0032347778_ul7858132212142"><li id="rds_06_0038__en-us_topic_0032347778_li58581622171411">Normal<p id="rds_06_0038__en-us_topic_0032347778_p1040982941020"><a name="rds_06_0038__en-us_topic_0032347778_li58581622171411"></a><a name="en-us_topic_0032347778_li58581622171411"></a>200</p>
|
|
</li><li id="rds_06_0038__en-us_topic_0032347778_li11583183218149">Abnormal<p id="rds_06_0038__en-us_topic_0032347778_p0723374409"><a name="rds_06_0038__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_06_0038__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="rds_06_0038__en-us_topic_0032347778_p19357163913406">For details, see <a href="en-us_topic_0032488241.html">Error Codes</a>.</p>
|
|
</div>
|
|
<p id="rds_06_0038__p8060118"></p>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rds_06_0036.html">Tag Management</a></div>
|
|
</div>
|
|
</div>
|
|
|