Files
doc-exports/docs/dws/api-ref/dws_02_0048.html
luhuayi fd5ee5dcd8 DWS API 20250722 version
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: luhuayi <luhuayi@huawei.com>
Co-committed-by: luhuayi <luhuayi@huawei.com>
2025-07-30 14:29:39 +00:00

192 lines
15 KiB
HTML

<a name="EN-US_TOPIC_0000002395330901"></a><a name="EN-US_TOPIC_0000002395330901"></a>
<h1 class="topictitle1">Deleting Tags in Batches</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000002395330901__section16821123192915"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000002395330901__p28215232292">This API is used to delete tags from a cluster in batches.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002395330901__section14821323182917"><h4 class="sectiontitle">URI</h4><pre class="screen" id="EN-US_TOPIC_0000002395330901__screen1044618013317">POST /v1.0/{project_id}/clusters/{cluster_id}/tags/batch-delete</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002395330901__table2082232352914" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002395330901__row14821112362911"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="EN-US_TOPIC_0000002395330901__p11822192352913"><strong id="EN-US_TOPIC_0000002395330901__b4946354542450">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="EN-US_TOPIC_0000002395330901__p9822102302918">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="EN-US_TOPIC_0000002395330901__p10822102342911">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="EN-US_TOPIC_0000002395330901__p128221923102911">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002395330901__row8821172342911"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002395330901__p17822102352916">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002395330901__p682252312294">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002395330901__p17822023132918">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002395330901__p1682212382912"><strong id="EN-US_TOPIC_0000002395330901__b143365883342542">Definition</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p188229233294">Project ID. To obtain the value, see <a href="dws_02_0011.html">Obtaining a Project ID</a>.</p>
<p id="EN-US_TOPIC_0000002395330901__p282262314295"><strong id="EN-US_TOPIC_0000002395330901__b22661414842853">Constraints</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p882216232293">N/A</p>
<p id="EN-US_TOPIC_0000002395330901__p10822723132913"><strong id="EN-US_TOPIC_0000002395330901__b17356845842523">Range</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p1782212230298">N/A</p>
<p id="EN-US_TOPIC_0000002395330901__p14822132313299"><strong id="EN-US_TOPIC_0000002395330901__b212468802542859">Default Value</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p2822152342917">N/A</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row12821223182916"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002395330901__p9822122310295">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002395330901__p28223235298">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002395330901__p282322312293">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002395330901__p182392352915"><strong id="EN-US_TOPIC_0000002395330901__b109225607042542">Definition</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p10823723142913">Cluster ID. To obtain the value, see <a href="dws_02_00068.html">Obtaining the Cluster ID</a>.</p>
<p id="EN-US_TOPIC_0000002395330901__p208231623122910"><strong id="EN-US_TOPIC_0000002395330901__b180737265742853">Constraints</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p12823132318296">N/A</p>
<p id="EN-US_TOPIC_0000002395330901__p9823182372911"><strong id="EN-US_TOPIC_0000002395330901__b50726510042523">Range</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p1782342322912">N/A</p>
<p id="EN-US_TOPIC_0000002395330901__p682317239295"><strong id="EN-US_TOPIC_0000002395330901__b158259893842859">Default Value</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p178231123162914">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002395330901__section10823132314298"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002395330901__en-us_topic_0000002341147714_en-us_topic_0000002374844677_request_BatchDeleteResourceTags" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002395330901__row14823122310294"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="EN-US_TOPIC_0000002395330901__p38231023142916"><strong id="EN-US_TOPIC_0000002395330901__b77399717842450">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="EN-US_TOPIC_0000002395330901__p1482352322918">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="EN-US_TOPIC_0000002395330901__p108241323152916">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="EN-US_TOPIC_0000002395330901__p1882412332916">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002395330901__row682342322916"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0000002395330901__p1824122352914">tags</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0000002395330901__p188249234296">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0000002395330901__p982482312295">Array of <a href="#EN-US_TOPIC_0000002395330901__en-us_topic_0000002341147714_en-us_topic_0000002374844677_request_BatchDeleteResourceTag">BatchDeleteResourceTag</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0000002395330901__p1782482311297"><strong id="EN-US_TOPIC_0000002395330901__b10483060142542">Definition</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p138241323192915">Tag list.</p>
<p id="EN-US_TOPIC_0000002395330901__p2082412319290"><strong id="EN-US_TOPIC_0000002395330901__b43429965742853">Constraints</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p182462312293">N/A</p>
<p id="EN-US_TOPIC_0000002395330901__p19824132311291"><strong id="EN-US_TOPIC_0000002395330901__b142295452842523">Range</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p168242233296">N/A</p>
<p id="EN-US_TOPIC_0000002395330901__p282417233298"><strong id="EN-US_TOPIC_0000002395330901__b200933515742859">Default Value</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p682472311297">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000002395330901__en-us_topic_0000002341147714_en-us_topic_0000002374844677_request_BatchDeleteResourceTag"></a><a name="en-us_topic_0000002341147714_en-us_topic_0000002374844677_request_BatchDeleteResourceTag"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002395330901__en-us_topic_0000002341147714_en-us_topic_0000002374844677_request_BatchDeleteResourceTag" frame="border" border="1" rules="all"><caption><b>Table 3 </b>BatchDeleteResourceTag</caption><thead align="left"><tr id="EN-US_TOPIC_0000002395330901__row15824112311297"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="EN-US_TOPIC_0000002395330901__p1182522312293"><strong id="EN-US_TOPIC_0000002395330901__b102432438942450">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="EN-US_TOPIC_0000002395330901__p13825112392918">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="EN-US_TOPIC_0000002395330901__p082532342919">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="EN-US_TOPIC_0000002395330901__p10825142392918">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002395330901__row5824142315297"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002395330901__p7825142314292">key</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002395330901__p14825102312290">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002395330901__p68251223102910">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002395330901__p68255237296"><strong id="EN-US_TOPIC_0000002395330901__b101787186642542">Definition</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p782582322919">Tag key.</p>
<p id="EN-US_TOPIC_0000002395330901__p282572311296"><strong id="EN-US_TOPIC_0000002395330901__b79079643942523">Range</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p17825112316296">N/A</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row1582411238293"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002395330901__p128251023132916">value</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002395330901__p2082518232295">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002395330901__p282532372918">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002395330901__p7825623132920"><strong id="EN-US_TOPIC_0000002395330901__b22143307942542">Definition</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p1825623102913">Tag value.</p>
<p id="EN-US_TOPIC_0000002395330901__p98251423122919"><strong id="EN-US_TOPIC_0000002395330901__b168585576542523">Range</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p14825423162916">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002395330901__section48262235291"><h4 class="sectiontitle">Response Parameters</h4><p id="EN-US_TOPIC_0000002395330901__p1182618236291"><strong id="EN-US_TOPIC_0000002395330901__b61656827142532">Status code: 200</strong></p>
<p id="EN-US_TOPIC_0000002395330901__p1682652313295">Tags are deleted in batches.</p>
<p id="EN-US_TOPIC_0000002395330901__p12826132312920">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002395330901__section1482632362911"><h4 class="sectiontitle">Example Request</h4><p id="EN-US_TOPIC_0000002395330901__p1082612238294">Delete tags whose key is <strong id="EN-US_TOPIC_0000002395330901__b21401697339">key</strong> and value is <strong id="EN-US_TOPIC_0000002395330901__b414018911334">value</strong> in batches.</p>
<pre class="screen" id="EN-US_TOPIC_0000002395330901__screen68261523122916">POST https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/b5c45780-1006-49e3-b2d5-b3229975bbc7/tags/batch-delete
{
"tags" : [ {
"key" : "key",
"value" : "value"
} ]
}</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000002395330901__section198261623162914"><h4 class="sectiontitle">Example Responses</h4><p id="EN-US_TOPIC_0000002395330901__p58261523132914">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002395330901__section16935152382916"><h4 class="sectiontitle">Status Code</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002395330901__en-us_topic_0000002341147714_en-us_topic_0000002374844677_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0000002395330901__row11832142319292"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="EN-US_TOPIC_0000002395330901__p109357233296">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="EN-US_TOPIC_0000002395330901__p79354238296">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002395330901__row1832223142918"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002395330901__p11935823112917">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002395330901__p693572317293">Tags are deleted in batches.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row1883216233293"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002395330901__p209358231296">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002395330901__p193517238297">Request error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row18832192312294"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002395330901__p393592302919">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002395330901__p9935152352915">Authorization failed.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row38321723162914"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002395330901__p493562314292">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002395330901__p8935523172911">No operation permission.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row4832523202917"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002395330901__p19351423162918">404</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002395330901__p1693518233297">No resources found.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row19832923122920"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002395330901__p18935112319297">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002395330901__p79351123172919">Internal service error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002395330901__row1832132310299"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002395330901__p119351523172914">503</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002395330901__p4935102312912">Service unavailable.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_02_0045.html">Tag Management</a></div>
</div>
</div>