doc-exports/docs/ims/api-ref/en-us_topic_0000001411399169.html
Hasko, Vladimir 0c7b91f4bd Initial import of IMS API
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-committed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
2022-10-05 08:51:25 +00:00

110 lines
9.7 KiB
HTML

<a name="EN-US_TOPIC_0000001411399169"></a><a name="EN-US_TOPIC_0000001411399169"></a>
<h1 class="topictitle1">Deleting an Image Tag</h1>
<div id="body1521538011494"><div class="section" id="EN-US_TOPIC_0000001411399169__section59308875183714"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001411399169__p39289584183714">This API is used to delete a specified tag from an image.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001411399169__section18061938183714"><h4 class="sectiontitle">Constraints</h4><ul id="EN-US_TOPIC_0000001411399169__ul53730901183714"><li id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__section5580419183714"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000001411399169__p54551515193111">DELETE /v2/{project_id}/images/{image_id}/tags/{key}</p>
<div class="p" id="EN-US_TOPIC_0000001411399169__p11857131815315"><a href="#EN-US_TOPIC_0000001411399169__table33665774183714">Table 1</a> lists the parameters in the URI.
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001411399169__table33665774183714"></a><a name="table33665774183714"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001411399169__table33665774183714" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__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_0000001411399169__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_0000001411399169__p53952674183714">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001411399169__row8090435183714"><td class="cellrowborder" valign="top" width="18.55814418558144%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__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_0000001411399169__p32238654183714">Specifies the project ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001411399169__row21712430183714"><td class="cellrowborder" valign="top" width="18.55814418558144%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__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_0000001411399169__p29893190183714">Specifies the image ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001411399169__row603254183714"><td class="cellrowborder" valign="top" width="18.55814418558144%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__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_0000001411399169__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_0000001411399169__section55965548183714"><h4 class="sectiontitle">Request</h4><ul id="EN-US_TOPIC_0000001411399169__ul3660132401513"><li id="EN-US_TOPIC_0000001411399169__li4549194817311">Request parameters<p id="EN-US_TOPIC_0000001411399169__p5910155583119"><a name="EN-US_TOPIC_0000001411399169__li4549194817311"></a><a name="li4549194817311"></a>None</p>
</li><li id="EN-US_TOPIC_0000001411399169__li15661172421519">Example request<pre class="codeblock" id="EN-US_TOPIC_0000001411399169__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_0000001411399169__section37371032183714"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0000001411399169__ul8319153671515"><li id="EN-US_TOPIC_0000001411399169__li2295141123218">Response parameters<p id="EN-US_TOPIC_0000001411399169__p1057017573214"><a name="EN-US_TOPIC_0000001411399169__li2295141123218"></a><a name="li2295141123218"></a>None</p>
</li><li id="EN-US_TOPIC_0000001411399169__li63191836181513">Example response<pre class="codeblock" id="EN-US_TOPIC_0000001411399169__codeblock59966742163330">STATUS CODE 204</pre>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001411399169__section64392887183714"><h4 class="sectiontitle">Returned Value</h4><ul id="EN-US_TOPIC_0000001411399169__ul48441386183714"><li id="EN-US_TOPIC_0000001411399169__li33319292183714">Normal<p id="EN-US_TOPIC_0000001411399169__p31438173183714"><a name="EN-US_TOPIC_0000001411399169__li33319292183714"></a><a name="li33319292183714"></a>204</p>
</li><li id="EN-US_TOPIC_0000001411399169__li14508102183714">Abnormal
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001411399169__table63464056183714" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__p22969204183714">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__p10225657183714">Request error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__p36402270183714">Authentication failed.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__p20733883183714">You do not have the rights to perform the operation.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__p48099407183714">The requested resource was not found.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__p40579678183714">Internal service error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001411399169__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_0000001411399169__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_0000001411399169__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_0000001411479477.html">Image Tagging</a></div>
</div>
</div>