Files
doc-exports/docs/swr/api-ref/swr_02_0057.html
qiujiandong1 73ffc816f4 SWR API 20250521 version
Reviewed-by: Eotvos, Oliver <oliver.eotvos@t-systems.com>
Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com>
Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
2025-10-29 10:18:41 +00:00

289 lines
25 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="swr_02_0057"></a><a name="swr_02_0057"></a>
<h1 class="topictitle1">Querying Image Retention Records</h1>
<div id="body8662426"><div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section77200550295"><h4 class="sectiontitle">Description</h4><p id="swr_02_0057__en-us_topic_0000001186074278_p10721115518298">Query image retention records.</p>
</div>
<div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section19721195517290"><h4 class="sectiontitle">Constraints</h4><p id="swr_02_0057__en-us_topic_0000001186074278_p87225554295">None</p>
</div>
<div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section57231355122919"><h4 class="sectiontitle">URI</h4><p id="swr_02_0057__en-us_topic_0000001186074278_p1972495552917">GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0057__en-us_topic_0000001186074278_table187263553290" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="swr_02_0057__en-us_topic_0000001186074278_row13725165516295"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="swr_02_0057__en-us_topic_0000001186074278_p67261155122911">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_0057__en-us_topic_0000001186074278_p472718553298">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_0057__en-us_topic_0000001186074278_p17281055192920">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_0057__en-us_topic_0000001186074278_p372813557298">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0057__en-us_topic_0000001186074278_row9725185518291"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p13729105510299">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p77291255132911">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p273035582917">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="swr_02_0057__en-us_topic_0000001186074278_p207301455152919">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_0057__en-us_topic_0000001186074278_row1072535511294"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1773125519293">repository</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p2732145511293">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p473335582914">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="swr_02_0057__en-us_topic_0000001186074278_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>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0057__en-us_topic_0000001186074278_table127351855102911" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Query parameters</caption><thead align="left"><tr id="swr_02_0057__en-us_topic_0000001186074278_row4734105512296"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="swr_02_0057__en-us_topic_0000001186074278_p1973545532914">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="swr_02_0057__en-us_topic_0000001186074278_p11736655172912">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="swr_02_0057__en-us_topic_0000001186074278_p17736135512298">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="swr_02_0057__en-us_topic_0000001186074278_p11737755112914">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0057__en-us_topic_0000001186074278_row1873420559293"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p6737185532912">limit</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p27381355162918">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p6738205522913">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="swr_02_0057__en-us_topic_0000001186074278_p67392550291">Number of returned records. Parameters <strong id="swr_02_0057__en-us_topic_0000001186074278_b19745383055957">offset</strong> and <strong id="swr_02_0057__en-us_topic_0000001186074278_b18145816545957">limit</strong> should always be used together.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row1473405552920"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p2740205522918">offset</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p674015557292">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p8741455102910">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="swr_02_0057__en-us_topic_0000001186074278_p15666419203012">Start index. The value must be <strong id="swr_02_0057__en-us_topic_0000001186074278_b188530025241640">0</strong> or a positive number.</p>
<p id="swr_02_0057__en-us_topic_0000001186074278_p127411755112910">Parameters <strong id="swr_02_0057__en-us_topic_0000001186074278_b14991716445957">offset</strong> and <strong id="swr_02_0057__en-us_topic_0000001186074278_b14300061155957">limit</strong> should always be used together.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row2734135552919"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p97428555293">filter</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p074355542918">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p27434552291">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="swr_02_0057__en-us_topic_0000001186074278_p874405517296">Set this parameter to <strong id="swr_02_0057__en-us_topic_0000001186074278_b650712326269">limit</strong>::{<em id="swr_02_0057__en-us_topic_0000001186074278_i150712328263">limit</em>}|<strong id="swr_02_0057__en-us_topic_0000001186074278_b1350893213265">offset</strong>::{<em id="swr_02_0057__en-us_topic_0000001186074278_i7508143262610">offset</em>}. <strong id="swr_02_0057__en-us_topic_0000001186074278_b14508332162613">limit</strong> indicates the number of returned records. <strong id="swr_02_0057__en-us_topic_0000001186074278_b750873262610">offset</strong> indicates the start index. Parameters <strong id="swr_02_0057__en-us_topic_0000001186074278_b13508183242610">offset</strong> and <strong id="swr_02_0057__en-us_topic_0000001186074278_b1750853282610">limit</strong> should always be used together.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section17744195512912"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0057__en-us_topic_0000001186074278_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request header parameters</caption><thead align="left"><tr id="swr_02_0057__en-us_topic_0000001186074278_row10745165582919"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="swr_02_0057__en-us_topic_0000001186074278_p174712558297">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_0057__en-us_topic_0000001186074278_p11747125582914">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_0057__en-us_topic_0000001186074278_p57481555202916">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_0057__en-us_topic_0000001186074278_p137481155142919">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0057__en-us_topic_0000001186074278_row147451855112916"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1874915518292">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p77498555297">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1750055162917">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="swr_02_0057__en-us_topic_0000001186074278_p9751135512294">Message body type (format). The value can be <strong id="swr_02_0057__en-us_topic_0000001186074278_b9407139638">application/json</strong> or <strong id="swr_02_0057__en-us_topic_0000001186074278_b1540729233">charset=utf-8 application/json</strong>.</p>
<p id="swr_02_0057__en-us_topic_0000001186074278_p475185512919">Default value: <strong id="swr_02_0057__en-us_topic_0000001186074278_b1576181215316">application/json</strong></p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row1974595532910"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p117521255172916">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_0057__en-us_topic_0000001186074278_p187521455152910">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p13753155516298">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="swr_02_0057__en-us_topic_0000001186074278_p13754145592916">User token.</p>
<p id="swr_02_0057__en-us_topic_0000001186074278_p8754955172915">The token can be obtained by calling the IAM API used to obtain a user token. The value of <strong id="swr_02_0057__en-us_topic_0000001186074278_b133069351811934">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_0057__en-us_topic_0000001186074278_section17551555299"><h4 class="sectiontitle">Response Parameters</h4><p id="swr_02_0057__en-us_topic_0000001186074278_p27561655162912"><strong id="swr_02_0057__en-us_topic_0000001186074278_b26482046111045">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0057__en-us_topic_0000001186074278_ResponseHeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response header parameter</caption><thead align="left"><tr id="swr_02_0057__en-us_topic_0000001186074278_row875655562918"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.5.3.2.4.1.1"><p id="swr_02_0057__en-us_topic_0000001186074278_p1375717556297">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.2"><p id="swr_02_0057__en-us_topic_0000001186074278_p1175825542913">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.3.2.4.1.3"><p id="swr_02_0057__en-us_topic_0000001186074278_p10758135518297">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0057__en-us_topic_0000001186074278_row147561455132916"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.5.3.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p5759555142917">Content-Range</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p187591655182914">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p19760115510293"><em id="swr_02_0057__en-us_topic_0000001186074278_i19298102312339">Offset</em> (Start index) <em id="swr_02_0057__en-us_topic_0000001186074278_i188181929143313">Count</em> (Number of records on the current page)/<em id="swr_02_0057__en-us_topic_0000001186074278_i193919341331">Total</em> (Total number of records)</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0057__en-us_topic_0000001186074278_response_RetentionHistory" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="swr_02_0057__en-us_topic_0000001186074278_row11760205518297"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.4.2.4.1.1"><p id="swr_02_0057__en-us_topic_0000001186074278_p1761135519299">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.4.2.4.1.2"><p id="swr_02_0057__en-us_topic_0000001186074278_p4762135512297">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.4.2.4.1.3"><p id="swr_02_0057__en-us_topic_0000001186074278_p10763855192915">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0057__en-us_topic_0000001186074278_row9760105516297"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1076325592920">retention_log</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p5763135510292">Array of <a href="#swr_02_0057__en-us_topic_0000001186074278_response_RetentionLog">RetentionLog</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1376485516295">Image retention log.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row276065519291"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1876415592911">total</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1776510557299">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p117651855142914">Total number.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="swr_02_0057__en-us_topic_0000001186074278_response_RetentionLog"></a><a name="en-us_topic_0000001186074278_response_RetentionLog"></a><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0057__en-us_topic_0000001186074278_response_RetentionLog" frame="border" border="1" rules="all"><caption><b>Table 6 </b>RetentionLog</caption><thead align="left"><tr id="swr_02_0057__en-us_topic_0000001186074278_row1976815542912"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.5.2.4.1.1"><p id="swr_02_0057__en-us_topic_0000001186074278_p47691155192913">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.5.2.4.1.2"><p id="swr_02_0057__en-us_topic_0000001186074278_p8770145519298">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.5.2.4.1.3"><p id="swr_02_0057__en-us_topic_0000001186074278_p97705554295">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0057__en-us_topic_0000001186074278_row87685554295"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p197715550296">created_at</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p7772255102917">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.5.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p0773175518293">Creation time.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row1376813555299"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p14773555102915">id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p207741155102919">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.5.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p0774165552911">ID</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row276825513298"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p2775165517295">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p777505518298">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.5.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p577525562920">Organization name.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row1476855582919"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p9776955102910">repo</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p16776555192916">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.5.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p077785510291">Image repository name.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row8768155142920"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p277715562913">retention_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p777895502910">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.5.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p57782055132913">Image retention policy ID.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row176810555297"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p20778105515293">rule_type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p9779195532917">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.5.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p18779115513293">Policy.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row1476885516292"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p778018551290">tag</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.5.2.4.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1078075510290">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.5.2.4.1.3 "><p id="swr_02_0057__en-us_topic_0000001186074278_p57811255122910">Image tag.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section15781125511291"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="swr_02_0057__en-us_topic_0000001186074278_screen478210558294">GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories</pre>
</div>
<div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section57831755152915"><h4 class="sectiontitle">Example Response</h4><p id="swr_02_0057__en-us_topic_0000001186074278_p1878311557297"><strong id="swr_02_0057__en-us_topic_0000001186074278_b878164768111045">Status code: 200</strong></p>
<p id="swr_02_0057__en-us_topic_0000001186074278_p13783135532912">Request succeeded.</p>
<pre class="screen" id="swr_02_0057__en-us_topic_0000001186074278_screen16784155162919">{
"retention_log" : [ {
"created_at" : "2020-04-17T08:01:09.658309Z",
"id" : 9088,
"namespace" : "hwstaff_l00283074",
"repo" : "experience_2048",
"retention_id" : 91,
"rule_type" : "{\"template\":\"tag_rule\",\"params\":{\"num\":\"7\"},\"tag_selectors\":[]}",
"tag" : "4"
} ],
"total" : 1
}</pre>
</div>
<div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section67901455202913"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0057__en-us_topic_0000001186074278_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="swr_02_0057__en-us_topic_0000001186074278_row27908559295"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="swr_02_0057__en-us_topic_0000001186074278_p17792185542919">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_0057__en-us_topic_0000001186074278_p12792855162917">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0057__en-us_topic_0000001186074278_row1791125582920"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p15793115512911">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p147944556291">Request succeeded.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row7791955172917"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p117941955172911">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p8795755192914">Request error.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row1679135592910"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1179595512297">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1796755132912">Authentication failed.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row3791175592916"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p679616554297">404</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p4797355152915">The organization or the repository was not found.</p>
</td>
</tr>
<tr id="swr_02_0057__en-us_topic_0000001186074278_row3791955192910"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0057__en-us_topic_0000001186074278_p3797115513296">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0057__en-us_topic_0000001186074278_p1579825515295">Internal error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0057__en-us_topic_0000001186074278_section479805532919"><h4 class="sectiontitle">Error Codes</h4><p id="swr_02_0057__en-us_topic_0000001186074278_p47991055132910">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_0094.html">Image Retention Policy Management</a></div>
</div>
</div>