forked from docs/doc-exports
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: guoyanyan <guoyanyan3@huawei.com> Co-committed-by: guoyanyan <guoyanyan3@huawei.com>
110 lines
9.2 KiB
HTML
110 lines
9.2 KiB
HTML
<a name="EN-US_TOPIC_0102682864"></a><a name="EN-US_TOPIC_0102682864"></a>
|
|
|
|
<h1 class="topictitle1">Deleting an Image Tag</h1>
|
|
<div id="body1521538011494"><div class="section" id="EN-US_TOPIC_0102682864__section59308875183714"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0102682864__p39289584183714">This API is used to delete a specified tag from an image.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0102682864__section18061938183714"><h4 class="sectiontitle">Constraints</h4><ul id="EN-US_TOPIC_0102682864__ul53730901183714"><li id="EN-US_TOPIC_0102682864__li13816063183714">To be compatible with remaining tags, the system will not verify the character set and length of the keys and values in the query condition.</li><li id="EN-US_TOPIC_0102682864__li57235704183714">This API is a non-idempotent one. If the key to be deleted does not exist, status code 404 is returned.</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0102682864__section5580419183714"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0102682864__p54551515193111">DELETE /v2/{project_id}/images/{image_id}/tags/{key}</p>
|
|
<div class="p" id="EN-US_TOPIC_0102682864__p11857131815315"><a href="#EN-US_TOPIC_0102682864__table33665774183714">Table 1</a> lists the parameters in the URI.
|
|
<div class="tablenoborder"><a name="EN-US_TOPIC_0102682864__table33665774183714"></a><a name="table33665774183714"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0102682864__table33665774183714" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0102682864__row7288033183714"><th align="left" class="cellrowborder" valign="top" width="18.55814418558144%" id="mcps1.3.3.3.2.2.5.1.1"><p id="EN-US_TOPIC_0102682864__p53459792183714">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.58804119588041%" id="mcps1.3.3.3.2.2.5.1.2"><p id="EN-US_TOPIC_0102682864__p35275920183714">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="30.926907309269076%" id="mcps1.3.3.3.2.2.5.1.3"><p id="EN-US_TOPIC_0102682864__p38777289183714">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="30.926907309269076%" id="mcps1.3.3.3.2.2.5.1.4"><p id="EN-US_TOPIC_0102682864__p53952674183714">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0102682864__row8090435183714"><td class="cellrowborder" valign="top" width="18.55814418558144%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0102682864__p51345493183714">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.58804119588041%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0102682864__p65344255183714">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.926907309269076%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0102682864__p58393322183714">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.926907309269076%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0102682864__p32238654183714">Specifies the project ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0102682864__row21712430183714"><td class="cellrowborder" valign="top" width="18.55814418558144%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0102682864__p13876401183714">image_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.58804119588041%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0102682864__p50246705183714">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.926907309269076%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0102682864__p43451285183714">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.926907309269076%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0102682864__p29893190183714">Specifies the image ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0102682864__row603254183714"><td class="cellrowborder" valign="top" width="18.55814418558144%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0102682864__p48863620183714">key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.58804119588041%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0102682864__p65639187183714">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.926907309269076%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0102682864__p15173963183714">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.926907309269076%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0102682864__p21131475183714">Specifies the key of the tag to be deleted.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0102682864__section55965548183714"><h4 class="sectiontitle">Request</h4><ul id="EN-US_TOPIC_0102682864__ul3660132401513"><li id="EN-US_TOPIC_0102682864__li4549194817311">Request parameters<p id="EN-US_TOPIC_0102682864__p5910155583119"><a name="EN-US_TOPIC_0102682864__li4549194817311"></a><a name="li4549194817311"></a>None</p>
|
|
</li><li id="EN-US_TOPIC_0102682864__li15661172421519">Example request<pre class="codeblock" id="EN-US_TOPIC_0102682864__codeblock62062461111538">DELETE https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/key1</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0102682864__section37371032183714"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0102682864__ul8319153671515"><li id="EN-US_TOPIC_0102682864__li2295141123218">Response parameters<p id="EN-US_TOPIC_0102682864__p1057017573214"><a name="EN-US_TOPIC_0102682864__li2295141123218"></a><a name="li2295141123218"></a>None</p>
|
|
</li><li id="EN-US_TOPIC_0102682864__li63191836181513">Example response<pre class="codeblock" id="EN-US_TOPIC_0102682864__codeblock59966742163330">STATUS CODE 204</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0102682864__section64392887183714"><h4 class="sectiontitle">Returned Values</h4><ul id="EN-US_TOPIC_0102682864__ul48441386183714"><li id="EN-US_TOPIC_0102682864__li33319292183714">Normal<p id="EN-US_TOPIC_0102682864__p31438173183714"><a name="EN-US_TOPIC_0102682864__li33319292183714"></a><a name="li33319292183714"></a>204</p>
|
|
</li><li id="EN-US_TOPIC_0102682864__li14508102183714">Abnormal
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0102682864__table63464056183714" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0102682864__row63000527183714"><th align="left" class="cellrowborder" valign="top" width="46.46%" id="mcps1.3.6.2.2.1.1.3.1.1"><p id="EN-US_TOPIC_0102682864__p2769083183714">Returned Value</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.54%" id="mcps1.3.6.2.2.1.1.3.1.2"><p id="EN-US_TOPIC_0102682864__p22969204183714">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0102682864__row48566241183714"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0102682864__p41551467183714">400 Bad Request</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0102682864__p10225657183714">Request error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0102682864__row24922053183714"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0102682864__p5420437183714">401 Unauthorized</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0102682864__p36402270183714">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0102682864__row59184975183714"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0102682864__p29253631183714">403 Forbidden</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0102682864__p20733883183714">You do not have the rights to perform the operation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0102682864__row52387226183714"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0102682864__p15506900183714">404 Not Found</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0102682864__p48099407183714">The requested resource was not found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0102682864__row30241484183714"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0102682864__p33641163183714">500 Internal Server Error</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0102682864__p40579678183714">Internal service error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0102682864__row29672787183714"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0102682864__p54685536183714">503 Service Unavailable</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0102682864__p343413183714">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_0135481402.html">Image Tagging</a></div>
|
|
</div>
|
|
</div>
|
|
|