forked from docs/doc-exports
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>
102 lines
8.2 KiB
HTML
102 lines
8.2 KiB
HTML
<a name="EN-US_TOPIC_0020091553"></a><a name="EN-US_TOPIC_0020091553"></a>
|
|
|
|
<h1 class="topictitle1">Deleting a Tag (Native OpenStack API)</h1>
|
|
<div id="body20084682"><div class="section" id="EN-US_TOPIC_0020091553__section18389930"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0020091553__p16246551">This API is used to delete a custom tag from a private image.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0020091553__section31291646"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0020091553__p24749807">DELETE /v2/images/{image_id}/tags/{tag}</p>
|
|
<div class="p" id="EN-US_TOPIC_0020091553__p462583917320"><a href="#EN-US_TOPIC_0020091553__table25869170205722">Table 1</a> lists the parameters in the URI.
|
|
<div class="tablenoborder"><a name="EN-US_TOPIC_0020091553__table25869170205722"></a><a name="table25869170205722"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020091553__table25869170205722" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0020091553__row8391193205722"><th align="left" class="cellrowborder" valign="top" width="21.43%" id="mcps1.3.2.3.2.2.5.1.1"><p id="EN-US_TOPIC_0020091553__p8598055205722"><strong id="EN-US_TOPIC_0020091553__b45514793161911">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="29.509999999999998%" id="mcps1.3.2.3.2.2.5.1.2"><p id="EN-US_TOPIC_0020091553__p25353829205722"><strong id="EN-US_TOPIC_0020091553__b26302767161914">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.23%" id="mcps1.3.2.3.2.2.5.1.3"><p id="EN-US_TOPIC_0020091553__p40394235205722">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="30.830000000000002%" id="mcps1.3.2.3.2.2.5.1.4"><p id="EN-US_TOPIC_0020091553__p50707602205722">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0020091553__row13675089205722"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0020091553__p33940449205722">image_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="29.509999999999998%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0020091553__p64821866205722">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.23%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0020091553__p16079763205722">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.830000000000002%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0020091553__p27392388205722">Specifies the image ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0020091553__row45204903205722"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0020091553__p37718552205722">tag</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="29.509999999999998%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0020091553__p35303910205722">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.23%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0020091553__p41044472205722">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.830000000000002%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0020091553__p36267959205722">Specifies the image tag.</p>
|
|
<p id="EN-US_TOPIC_0020091553__p15777461117">The tag can contain only digits, letters, underscores (_), and hyphens (-).</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0020091553__section13189358"><h4 class="sectiontitle">Request</h4><p id="EN-US_TOPIC_0020091553__p16941348155118">Request parameters</p>
|
|
<p id="EN-US_TOPIC_0020091553__p54151926173319">None</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0020091553__section129416012416"><h4 class="sectiontitle">Example Request</h4><p id="EN-US_TOPIC_0020091553__p871516310511">Deleting an image tag</p>
|
|
<pre class="screen" id="EN-US_TOPIC_0020091553__screen5332457416">DELETE https://{Endpoint}/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/tags/aaaa</pre>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0020091553__section51595365"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0020091553__ul211231493517"><li id="EN-US_TOPIC_0020091553__li533102933319">Response parameters<p id="EN-US_TOPIC_0020091553__p318563311330"><a name="EN-US_TOPIC_0020091553__li533102933319"></a><a name="li533102933319"></a>None</p>
|
|
</li><li id="EN-US_TOPIC_0020091553__li5112121410354">Example response<pre class="codeblock" id="EN-US_TOPIC_0020091553__codeblock930279617373">STATUS CODE 204</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0020091553__section61705107"><h4 class="sectiontitle">Returned Values</h4><ul id="EN-US_TOPIC_0020091553__ul28278595"><li id="EN-US_TOPIC_0020091553__li53180767">Normal<p id="EN-US_TOPIC_0020091553__p8864859"><a name="EN-US_TOPIC_0020091553__li53180767"></a><a name="li53180767"></a>204</p>
|
|
</li><li id="EN-US_TOPIC_0020091553__li12674872">Abnormal
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020091553__table2557613417418" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0020091553__row2726860617418"><th align="left" class="cellrowborder" valign="top" width="46.54%" id="mcps1.3.6.2.2.1.1.3.1.1"><p id="EN-US_TOPIC_0020091553__p6127347417418">Returned Value</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.459999999999994%" id="mcps1.3.6.2.2.1.1.3.1.2"><p id="EN-US_TOPIC_0020091553__p6420439117418"><strong id="EN-US_TOPIC_0020091553__b58806940161930">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0020091553__row3317320517418"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091553__p267505917418">400 Bad Request</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091553__p1535319317418">Request error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0020091553__row396101317418"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091553__p5240662717418">401 Unauthorized</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091553__p1707839817418">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0020091553__row1948785517418"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091553__p3501244017418">403 Forbidden</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091553__p1743536117418">You do not have the rights to perform the operation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0020091553__row66661301191255"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091553__p26317130191257">404 Not Found</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091553__p51312824191257">The requested resource was not found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0020091553__row2270052117418"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091553__p2680288517418">500 Internal Server Error</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091553__p2355010217418">Internal service error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0020091553__row1062433417418"><td class="cellrowborder" valign="top" width="46.54%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020091553__p5526474517418">503 Service Unavailable</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.459999999999994%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020091553__p4725937317418">The service is unavailable.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0122410335.html">Image Tagging (Native OpenStack APIs)</a></div>
|
|
</div>
|
|
</div>
|
|
|