doc-exports/docs/sfs/api-ref/sfs_02_0038.html
zhangyue 5d0d5cb580 SFS API DOC
Reviewed-by: Muller, Martin <martin.muller@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2023-05-01 07:32:40 +00:00

107 lines
8.1 KiB
HTML

<a name="sfs_02_0038"></a><a name="sfs_02_0038"></a>
<h1 class="topictitle1">Deleting a Tag from a Shared File System</h1>
<div id="body1521093540922"><div class="section" id="sfs_02_0038__section10684447163819"><h4 class="sectiontitle">Function</h4><p id="sfs_02_0038__p2245521945">This API is used to delete a tag from a specified shared file system.</p>
<div class="note" id="sfs_02_0038__note18624144184815"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="sfs_02_0038__p136241649480">If the key to be deleted does not exist in the shared file system, error 404 is returned after API calling.</p>
</div></div>
</div>
<div class="section" id="sfs_02_0038__section1665327514513"><h4 class="sectiontitle">URI</h4><ul id="sfs_02_0038__ul673803814513"><li id="sfs_02_0038__li6064234314513">DELETE /v2/{project_id}/sfs/{share_id}/tags/{key}</li><li id="sfs_02_0038__li891018114513">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0038__table22021759152019" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0038__row16139965152019"><th align="left" class="cellrowborder" valign="top" width="18.56%" id="mcps1.3.2.2.2.1.1.5.1.1"><p id="sfs_02_0038__p17124101410431">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.4%" id="mcps1.3.2.2.2.1.1.5.1.2"><p id="sfs_02_0038__p1612415146430">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.65%" id="mcps1.3.2.2.2.1.1.5.1.3"><p id="sfs_02_0038__p312416148432">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.39%" id="mcps1.3.2.2.2.1.1.5.1.4"><p id="sfs_02_0038__p3124181464318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_02_0038__row55089343152019"><td class="cellrowborder" valign="top" width="18.56%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_02_0038__p1781134044818">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="13.4%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_02_0038__p59952126152019">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="21.65%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_02_0038__p24284048152019">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.39%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_02_0038__p20850895152019">Specifies the project ID of the operator.</p>
</td>
</tr>
<tr id="sfs_02_0038__row3119103219486"><td class="cellrowborder" valign="top" width="18.56%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_02_0038__p1011933217487">share_id</p>
</td>
<td class="cellrowborder" valign="top" width="13.4%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_02_0038__p18120163210481">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="21.65%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_02_0038__p11120113294813">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.39%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_02_0038__p13120143211489">Specifies the ID of the shared file system.</p>
</td>
</tr>
<tr id="sfs_02_0038__row13326546105"><td class="cellrowborder" valign="top" width="18.56%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_02_0038__p2334145420105">key</p>
</td>
<td class="cellrowborder" valign="top" width="13.4%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_02_0038__p133425414102">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="21.65%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_02_0038__p1033414542104">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.39%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_02_0038__p1233495451016">Specifies the tag key. The value can contain a maximum of 36 characters. The key cannot be left blank and can only contain letters, digits, hyphens (-), and underscores (_).</p>
<div class="notice" id="sfs_02_0038__note828312918357"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="sfs_02_0038__p1128318923518">When calling this API to delete a tag, if the tag key contains special characters that are not directly resolved by the URL, the key needs to be escaped.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="sfs_02_0038__section5063604914513"><h4 class="sectiontitle">Request</h4><ul id="sfs_02_0038__ul787926514513"><li id="sfs_02_0038__li380452214513">Parameter description<p id="sfs_02_0038__p2376195911116"><a name="sfs_02_0038__li380452214513"></a><a name="li380452214513"></a>None</p>
</li><li id="sfs_02_0038__li3973086014513">Example request<p id="sfs_02_0038__p0375199111212"><a name="sfs_02_0038__li3973086014513"></a><a name="li3973086014513"></a>None</p>
</li></ul>
</div>
<div class="section" id="sfs_02_0038__section6408307814513"><h4 class="sectiontitle">Response</h4><ul id="sfs_02_0038__ul2334684914513"><li id="sfs_02_0038__li879505414513">Parameter description<p id="sfs_02_0038__ac213f604d5cf4e85a07dd78f95b5205b"><a name="sfs_02_0038__li879505414513"></a><a name="li879505414513"></a>None</p>
</li></ul>
<ul id="sfs_02_0038__ul3903357014513"><li id="sfs_02_0038__li1575781314513">Example response<p id="sfs_02_0038__p138241544115414"><a name="sfs_02_0038__li1575781314513"></a><a name="li1575781314513"></a>None</p>
</li></ul>
</div>
<div class="section" id="sfs_02_0038__section4959408514513"><h4 class="sectiontitle">Status Codes</h4><ul id="sfs_02_0038__ul5769798014513"><li id="sfs_02_0038__li4951977214513">Normal<p id="sfs_02_0038__p4302476614513"><a name="sfs_02_0038__li4951977214513"></a><a name="li4951977214513"></a>204</p>
</li><li id="sfs_02_0038__li5167858014513">Abnormal
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0038__table6245403714513" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0038__row1507735814513"><th align="left" class="cellrowborder" valign="top" width="43.43%" id="mcps1.3.5.2.2.1.1.3.1.1"><p id="sfs_02_0038__p1330652014513">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.57%" id="mcps1.3.5.2.2.1.1.3.1.2"><p id="sfs_02_0038__p408636314513">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_02_0038__row3477393214513"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0038__p6522508214513">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0038__p4874025614513">Invalid value.</p>
</td>
</tr>
<tr id="sfs_02_0038__row3600912414513"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0038__p3105792214513">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0038__p3266375714513">Authentication failed.</p>
</td>
</tr>
<tr id="sfs_02_0038__row2553835814513"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0038__p5534113514513">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0038__p5344692014513">Access to the requested page is forbidden.</p>
</td>
</tr>
<tr id="sfs_02_0038__row1126023214513"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0038__p3966357214513">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0038__p5863278914513">The requested resource was not found.</p>
</td>
</tr>
<tr id="sfs_02_0038__row1011562214513"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0038__p1405905414513">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0038__p6504160314513">The request is not completed because of a service error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="sfs_02_0036.html">Tag Management</a></div>
</div>
</div>