forked from docs/doc-exports
Zaoxu, Li
bcdc2ecfaa
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com> Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com> Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
143 lines
11 KiB
HTML
143 lines
11 KiB
HTML
<a name="deh_05_0902"></a><a name="deh_05_0902"></a>
|
|
|
|
<h1 class="topictitle1">Deleting Tags from a DeH in Batches</h1>
|
|
<div id="body1539074167587"><div class="section" id="deh_05_0902__section54478915181842"><h4 class="sectiontitle">Function</h4><ul id="deh_05_0902__ul246771516486"><li id="deh_05_0902__li946771511489">This API is used to delete tags from a specified DeH in batches.</li></ul>
|
|
<ul id="deh_05_0902__ul319691018485"><li id="deh_05_0902__li1519613108481">Tag Management Service (TMS) uses this API to batch delete tags from a DeH.</li></ul>
|
|
</div>
|
|
<div class="section" id="deh_05_0902__section141154519480"><h4 class="sectiontitle"><strong id="deh_05_0902__b16822038154019">Constraint</strong></h4><p id="deh_05_0902__p1732131124414">A DeH allows a maximum of 10 tags.</p>
|
|
</div>
|
|
<div class="section" id="deh_05_0902__en-us_topic_0057972838_section58912114"><h4 class="sectiontitle">URI</h4><p id="deh_05_0902__en-us_topic_0057972838_p17816132418199">POST /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags/action</p>
|
|
<p id="deh_05_0902__p16459111417348"><a href="#deh_05_0902__table1127422643418">Table 1</a> describes the parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="deh_05_0902__table1127422643418"></a><a name="table1127422643418"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_05_0902__table1127422643418" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters description</caption><thead align="left"><tr id="deh_05_0902__row182751926113412"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.4.2.5.1.1"><p id="deh_05_0902__p64521444164912"><strong id="deh_05_0902__b168603350425">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.4.2.5.1.2"><p id="deh_05_0902__p16452114494915"><strong id="deh_05_0902__b73121437124216">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.4.2.5.1.3"><p id="deh_05_0902__p0442111410352"><strong id="deh_05_0902__b1325738174210">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.4.2.5.1.4"><p id="deh_05_0902__p94521344104916"><strong id="deh_05_0902__b142451439154210">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_05_0902__row13275132613342"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="deh_05_0902__p14452174415495">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.2 "><p id="deh_05_0902__p134521443499">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.3 "><p id="deh_05_0902__p16444111412354">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.4 "><p id="deh_05_0902__p10452244104914">Specifies the project ID.</p>
|
|
<p id="deh_05_0902__p7376194915119">For details about how to obtain the project ID, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328009.html" target="_blank" rel="noopener noreferrer">Obtaining Required Information</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_05_0902__row127542610346"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="deh_05_0902__p3452144416495">dedicated_host_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.2 "><p id="deh_05_0902__p6452124416491">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.3 "><p id="deh_05_0902__p1644721483520">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.4 "><p id="deh_05_0902__p1945284419497">Specifies the DeH ID.</p>
|
|
<p id="deh_05_0902__p858154817367">You can obtain the value from the DeH console or using the API in <a href="deh_02_0020.html">Querying DeHs</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="deh_05_0902__en-us_topic_0057972838_section60446980"><h4 class="sectiontitle">Request</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="deh_05_0902__table20863747154411" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="deh_05_0902__row38631347154420"><th align="left" class="cellrowborder" valign="top" width="19.86%" id="mcps1.3.4.2.2.5.1.1"><p id="deh_05_0902__p7986125974415"><strong id="deh_05_0902__b1232355411421">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.32%" id="mcps1.3.4.2.2.5.1.2"><p id="deh_05_0902__p20986205964413"><strong id="deh_05_0902__b726790746">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.6%" id="mcps1.3.4.2.2.5.1.3"><p id="deh_05_0902__p1498619591448"><strong id="deh_05_0902__b1729388445">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="42.22%" id="mcps1.3.4.2.2.5.1.4"><p id="deh_05_0902__p8987459144417"><strong id="deh_05_0902__b19788185714220">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_05_0902__row8863147164414"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.2.5.1.1 "><p id="deh_05_0902__p16987195910447">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.32%" headers="mcps1.3.4.2.2.5.1.2 "><p id="deh_05_0902__p13987105913442">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.6%" headers="mcps1.3.4.2.2.5.1.3 "><p id="deh_05_0902__p3987165964411">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.22%" headers="mcps1.3.4.2.2.5.1.4 "><p id="deh_05_0902__p12987105915448">Specifies the tag list.</p>
|
|
<p id="deh_05_0902__p11881124512421">For details, see <a href="#deh_05_0902__table147261636184517">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_05_0902__row178631547194416"><td class="cellrowborder" valign="top" width="19.86%" headers="mcps1.3.4.2.2.5.1.1 "><p id="deh_05_0902__p1987859154412">action</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.32%" headers="mcps1.3.4.2.2.5.1.2 "><p id="deh_05_0902__p16987959144415">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.6%" headers="mcps1.3.4.2.2.5.1.3 "><p id="deh_05_0902__p169871259124414">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.22%" headers="mcps1.3.4.2.2.5.1.4 "><p id="deh_05_0902__p29871859174415">Specifies the operation. Only lowercase letters are supported. For example, <strong id="deh_05_0902__b3224118132215">delete</strong> indicates the deletion operation.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="deh_05_0902__table147261636184517"></a><a name="table147261636184517"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_05_0902__table147261636184517" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="deh_05_0902__b17660159382">tag</strong> field description</caption><thead align="left"><tr id="deh_05_0902__row17727336114510"><th align="left" class="cellrowborder" valign="top" width="15.09%" id="mcps1.3.4.3.2.5.1.1"><p id="deh_05_0902__p4760131204615"><strong id="deh_05_0902__b1740813042218">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="14.91%" id="mcps1.3.4.3.2.5.1.2"><p id="deh_05_0902__p1576011214612"><strong id="deh_05_0902__b14316750">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.9%" id="mcps1.3.4.3.2.5.1.3"><p id="deh_05_0902__p3760191220463"><strong id="deh_05_0902__b1578381766">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="54.1%" id="mcps1.3.4.3.2.5.1.4"><p id="deh_05_0902__p8760101234613"><strong id="deh_05_0902__b11409311318">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_05_0902__row1472873624512"><td class="cellrowborder" valign="top" width="15.09%" headers="mcps1.3.4.3.2.5.1.1 "><p id="deh_05_0902__p10760812104613">key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.91%" headers="mcps1.3.4.3.2.5.1.2 "><p id="deh_05_0902__p157609126467">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="deh_05_0902__p1476131216461">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.1%" headers="mcps1.3.4.3.2.5.1.4 "><p id="deh_05_0902__p177614120465">Specifies the tag key.</p>
|
|
<ul id="deh_05_0902__ul5761101220463"><li id="deh_05_0902__li27610122468">It contains a maximum of 36 Unicode characters.</li><li id="deh_05_0902__li1276121294611">The value cannot be empty.</li><li id="deh_05_0902__li776141254619">It cannot contain the following ASCII characters: =*<>\|/,</li><li id="deh_05_0902__li5761191244612">It can contain letters, digits, hyphens (-), and underscores (_).</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_05_0902__row167281536174519"><td class="cellrowborder" valign="top" width="15.09%" headers="mcps1.3.4.3.2.5.1.1 "><p id="deh_05_0902__p9761111211461">value</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.91%" headers="mcps1.3.4.3.2.5.1.2 "><p id="deh_05_0902__p17611312114612">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="deh_05_0902__p18761112164613">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.1%" headers="mcps1.3.4.3.2.5.1.4 "><p id="deh_05_0902__p376161264611">Specifies the tag value.</p>
|
|
<ul id="deh_05_0902__ul976171264615"><li id="deh_05_0902__li17611812204616">It contains a maximum of 43 Unicode characters.</li><li id="deh_05_0902__li15761171284613">It cannot contain the following ASCII characters: =*<>\|/,</li><li id="deh_05_0902__li1761141210467">It can contain letters, digits, hyphens (-), and underscores (_).</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="deh_05_0902__section688202793719"><h4 class="sectiontitle">Response</h4><p id="deh_05_0902__p19221430133710">N/A</p>
|
|
</div>
|
|
<div class="section" id="deh_05_0902__section4539132133315"><h4 class="sectiontitle">Example Request</h4><div class="p" id="deh_05_0902__p47221115102712">Delete two tags from a DeH in a batch. The keys and corresponding values for these two tags are as follows: <strong id="deh_05_0902__b28883412119">key1</strong> and <strong id="deh_05_0902__b12888134110111">value1</strong>; <strong id="deh_05_0902__b1888144131110">key2</strong> and <strong id="deh_05_0902__b58881641181111">value2</strong><pre class="screen" id="deh_05_0902__screen4691348134111">POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags/action</pre>
|
|
<pre class="screen" id="deh_05_0902__screen1681161519385">{
|
|
"action": "delete",
|
|
"tags": [
|
|
{
|
|
"key": "key1",
|
|
"value": "value1"
|
|
},
|
|
{
|
|
"key": "key2",
|
|
"value": "value2"
|
|
}
|
|
]
|
|
}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="deh_05_0902__section16360154516337"><h4 class="sectiontitle">Example Response</h4><p id="deh_05_0902__p18181155383612">N/A</p>
|
|
</div>
|
|
<div class="section" id="deh_05_0902__section9992350"><h4 class="sectiontitle">Status Code</h4><p id="deh_05_0902__p5641212">See <a href="deh_02_0016.html">Status Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="deh_05_0900.html">DeH Tag Management</a></div>
|
|
</div>
|
|
</div>
|
|
|