doc-exports/docs/smn/api-ref/smn_api_56004.html
Zaoxu, Li 152a7d9381 SMN API DOC
Reviewed-by: Bobkova, Natalia <natalia.bobkova@t-systems.com>
Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com>
Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
2024-06-20 15:01:38 +00:00

74 lines
6.2 KiB
HTML

<a name="smn_api_56004"></a><a name="smn_api_56004"></a>
<h1 class="topictitle1">Deleting a Tag</h1>
<div id="body1523350913840"><div class="section" id="smn_api_56004__section7759134242010"><h4 class="sectiontitle">Description</h4><ul id="smn_api_56004__ul33304380203733"><li id="smn_api_56004__li51147505203733">API name<p id="smn_api_56004__p38624841203741"><a name="smn_api_56004__li51147505203733"></a><a name="li51147505203733"></a>DeleteResourceTag</p>
</li></ul>
<ul id="smn_api_56004__ul20998054203745"><li id="smn_api_56004__li46884910203750">Function<p id="smn_api_56004__p17963164211207"><a name="smn_api_56004__li46884910203750"></a><a name="li46884910203750"></a>The API is idempotent. When deleting a tag, the system does not check its character set. The tag key cannot be left blank or be an empty string. If the key of the tag to be deleted does not exist, 404 will be returned. </p>
</li></ul>
</div>
<div class="section" id="smn_api_56004__section97591842102016"><h4 class="sectiontitle">URI</h4><ul id="smn_api_56004__ul1396394262010"><li id="smn_api_56004__li696316427201">URI format<p id="smn_api_56004__p696394210205"><a name="smn_api_56004__li696316427201"></a><a name="li696316427201"></a>DELETE /v2/{project_id}/{resource_type}/{resource_id}/tags/{key}</p>
</li></ul>
<ul id="smn_api_56004__ul139632420206"><li id="smn_api_56004__li1496364219202">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="smn_api_56004__table7791104212204" frame="border" border="1" rules="all"><thead align="left"><tr id="smn_api_56004__row1796344252017"><th align="left" class="cellrowborder" valign="top" width="26.39%" id="mcps1.3.2.3.1.1.1.5.1.1"><p id="smn_api_56004__p79631442192013"><strong id="smn_api_56004__b842352706191030">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23.61%" id="mcps1.3.2.3.1.1.1.5.1.2"><p id="smn_api_56004__p10963442162017"><strong id="smn_api_56004__b593421527191713">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.830000000000002%" id="mcps1.3.2.3.1.1.1.5.1.3"><p id="smn_api_56004__p1963124212201"><strong id="smn_api_56004__b84235270619112">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="29.17%" id="mcps1.3.2.3.1.1.1.5.1.4"><p id="smn_api_56004__p196304213203"><strong id="smn_api_56004__b84235270619115">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="smn_api_56004__row19963842192019"><td class="cellrowborder" valign="top" width="26.39%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="smn_api_56004__p49631428205">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="23.61%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="smn_api_56004__p10963742172017">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20.830000000000002%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="smn_api_56004__p109639429204">String</p>
</td>
<td class="cellrowborder" valign="top" width="29.17%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="smn_api_56004__p11963154216205">Project ID</p>
<p id="smn_api_56004__p118812918506">See <a href="smn_api_66000.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="smn_api_56004__row20963154222018"><td class="cellrowborder" valign="top" width="26.39%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="smn_api_56004__p99531421797">resource_type</p>
</td>
<td class="cellrowborder" valign="top" width="23.61%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="smn_api_56004__p1495310421799">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20.830000000000002%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="smn_api_56004__p149531342296">String</p>
</td>
<td class="cellrowborder" valign="top" width="29.17%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="smn_api_56004__p52661238184213">Resource type</p>
<p id="smn_api_56004__p278251314214">Only <strong id="smn_api_56004__b4408162715408">smn_topic</strong> (topic) is supported.</p>
</td>
</tr>
<tr id="smn_api_56004__row1396310428206"><td class="cellrowborder" valign="top" width="26.39%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="smn_api_56004__p1363485413187">resource_id</p>
</td>
<td class="cellrowborder" valign="top" width="23.61%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="smn_api_56004__p463417547182">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20.830000000000002%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="smn_api_56004__p7634195417180">String</p>
</td>
<td class="cellrowborder" valign="top" width="29.17%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="smn_api_56004__p176341254201810">Resource ID</p>
<p id="smn_api_56004__p57491711103514">Obtain a resource ID:</p>
<ul id="smn_api_56004__ul111761720155610"><li id="smn_api_56004__smn_api_56002_li969342316131">Add <strong id="smn_api_56004__smn_api_56002_b1745003620">X-SMN-RESOURCEID-TYPE=name</strong> in the request header and set the resource ID to the topic name.</li><li id="smn_api_56004__smn_api_56002_li1669312233134">Call the <strong id="smn_api_56004__smn_api_56002_b84235270694340">GetResourceInstances</strong> API to obtain the resource ID.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="smn_api_56004__section882210424202"><h4 class="sectiontitle">Request</h4><ul id="smn_api_56004__ul15963942142015"><li id="smn_api_56004__li4963124202011">Example request<pre class="screen" id="smn_api_56004__screen15963174219202">DELETE https://{SMN_Endpoint}/v2/{project_id}/{resource_type}/{resource_id}/tags/{key}</pre>
</li></ul>
</div>
<div class="section" id="smn_api_56004__section7917112413357"><h4 class="sectiontitle">Response</h4><p id="smn_api_56004__p395581185014">None</p>
</div>
<div class="section" id="smn_api_56004__section8822184216209"><h4 class="sectiontitle">Returned Value</h4><p id="smn_api_56004__p144041524121813">See <a href="smn_api_63002.html">Returned Value</a>.</p>
</div>
<div class="section" id="smn_api_56004__section73211020122511"><h4 class="sectiontitle">Error Codes</h4><p id="smn_api_56004__p9759142919265">See <a href="smn_api_64000.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="smn_api_56000.html">Resource Tag Operations</a></div>
</div>
</div>