forked from docs/doc-exports
qiujiandong1
73ffc816f4
Reviewed-by: Eotvos, Oliver <oliver.eotvos@t-systems.com> Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com> Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
137 lines
12 KiB
HTML
137 lines
12 KiB
HTML
<a name="swr_02_0036"></a><a name="swr_02_0036"></a>
|
|
|
|
<h1 class="topictitle1">Deleting an Image with a Specified Tag</h1>
|
|
<div id="body8662426"><div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section164689311572"><h4 class="sectiontitle">Description</h4><p id="swr_02_0036__en-us_topic_0000001231195471_p74691539573">Delete an image with a specified tag.</p>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section174691938576"><h4 class="sectiontitle">Constraints</h4><p id="swr_02_0036__en-us_topic_0000001231195471_p10470631574">None</p>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section44714319574"><h4 class="sectiontitle">URI</h4><p id="swr_02_0036__en-us_topic_0000001231195471_p4472143105710">DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/tags/{tag}</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0036__en-us_topic_0000001231195471_table2474436577" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="swr_02_0036__en-us_topic_0000001231195471_row5473153125716"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="swr_02_0036__en-us_topic_0000001231195471_p19474163125710">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="swr_02_0036__en-us_topic_0000001231195471_p134757311577">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="swr_02_0036__en-us_topic_0000001231195471_p74761375716">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="swr_02_0036__en-us_topic_0000001231195471_p1647618316572">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="swr_02_0036__en-us_topic_0000001231195471_row7473173165715"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p20477130573">namespace</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p24778385716">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="swr_02_0036__en-us_topic_0000001231195471_p174780311572">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="swr_02_0036__en-us_topic_0000001231195471_p44783335719">Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="swr_02_0036__en-us_topic_0000001231195471_row104732033574"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p19479193195715">repository</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p18479731573">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="swr_02_0036__en-us_topic_0000001231195471_p11480173175710">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="swr_02_0036__en-us_topic_0000001231195471_p1833713588245">Image repository name. Enter 1 to 128 characters. It must start and end with a lowercase letter or digit. Only lowercase letters, digits, periods (.), slashes (/), underscores (_), and hyphens (-) are allowed. Periods, slashes, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed. Replace a slash (/) with a dollar sign ($) before you send the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="swr_02_0036__en-us_topic_0000001231195471_row5473123135716"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p248013310575">tag</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p164811315718">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="swr_02_0036__en-us_topic_0000001231195471_p104817335716">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="swr_02_0036__en-us_topic_0000001231195471_p1648215375714">Image tag name.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section94822317571"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0036__en-us_topic_0000001231195471_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="swr_02_0036__en-us_topic_0000001231195471_row16483153185718"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="swr_02_0036__en-us_topic_0000001231195471_p19484231577">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.2"><p id="swr_02_0036__en-us_topic_0000001231195471_p104855313573">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="swr_02_0036__en-us_topic_0000001231195471_p248523185711">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="swr_02_0036__en-us_topic_0000001231195471_p44862365714">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="swr_02_0036__en-us_topic_0000001231195471_row24831836573"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p194861531573">Content-Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p0487535579">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="swr_02_0036__en-us_topic_0000001231195471_p1848710315577">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="swr_02_0036__en-us_topic_0000001231195471_p7487233570">Message body type (format). The value can be <strong id="swr_02_0036__en-us_topic_0000001231195471_b13599102815595">application/json</strong> or <strong id="swr_02_0036__en-us_topic_0000001231195471_b8599112815917">charset=utf-8 application/json</strong>.</p>
|
|
<p id="swr_02_0036__en-us_topic_0000001231195471_p17488433573">Default value: <strong id="swr_02_0036__en-us_topic_0000001231195471_b113671431155911">application/json</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="swr_02_0036__en-us_topic_0000001231195471_row94831432576"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p248812335717">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p548917317577">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="swr_02_0036__en-us_topic_0000001231195471_p04901934572">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="swr_02_0036__en-us_topic_0000001231195471_p8490332574">User token.</p>
|
|
<p id="swr_02_0036__en-us_topic_0000001231195471_p5492163145715">The token can be obtained through the IAM API used to obtain a user token. The value of <strong id="swr_02_0036__en-us_topic_0000001231195471_b1486264931714">X-Subject-Token</strong> in the response header is the user token.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section249233145719"><h4 class="sectiontitle">Response Parameters</h4><p id="swr_02_0036__en-us_topic_0000001231195471_p12493835577">None</p>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section749314318571"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="swr_02_0036__en-us_topic_0000001231195471_screen16494332574">DELETE https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/tags/{tag}</pre>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section649483115711"><h4 class="sectiontitle">Example Response</h4><p id="swr_02_0036__en-us_topic_0000001231195471_p1249513318576">None</p>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section1849514313572"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0036__en-us_topic_0000001231195471_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="swr_02_0036__en-us_topic_0000001231195471_row949623145714"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="swr_02_0036__en-us_topic_0000001231195471_p949943105718">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="swr_02_0036__en-us_topic_0000001231195471_p15500193125718">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="swr_02_0036__en-us_topic_0000001231195471_row164965365710"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p1850012311572">204</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p550113310577">Image with a specified tag deleted.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="swr_02_0036__en-us_topic_0000001231195471_row34961317574"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p75019375719">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p18502034572">Request error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="swr_02_0036__en-us_topic_0000001231195471_row12499123185714"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p05025315578">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p18503173155712">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="swr_02_0036__en-us_topic_0000001231195471_row049918313578"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p15041332573">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p3504133175712">The image repository or the image of the specified tag was not found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="swr_02_0036__en-us_topic_0000001231195471_row74991531576"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0036__en-us_topic_0000001231195471_p1650514310578">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0036__en-us_topic_0000001231195471_p450513175716">Internal error.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="swr_02_0036__en-us_topic_0000001231195471_section1350617312579"><h4 class="sectiontitle">Error Codes</h4><p id="swr_02_0036__en-us_topic_0000001231195471_p175079315713">For details, see <a href="ErrorCode.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="swr_02_0077.html">Image Tag Management</a></div>
|
|
</div>
|
|
</div>
|
|
|