forked from docs/doc-exports
Dong, Qiu Jian
f5c28c856a
Reviewed-by: Eotvos, Oliver <oliver.eotvos@t-systems.com> Co-authored-by: Dong, Qiu Jian <qiujiandong1@huawei.com> Co-committed-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
379 lines
30 KiB
HTML
379 lines
30 KiB
HTML
<a name="swr_02_0035"></a><a name="swr_02_0035"></a>
|
||
|
||
<h1 class="topictitle1">Querying the List of Image Repository Tags</h1>
|
||
<div id="body1531798197437"><div class="section" id="swr_02_0035__section14905762191056"><h4 class="sectiontitle">Function</h4><p id="swr_02_0035__p38546794191926">Query all image tags of an image repository.</p>
|
||
</div>
|
||
<div class="section" id="swr_02_0035__section10482810165331"><h4 class="sectiontitle">URI</h4><p id="swr_02_0035__p59581150181416">GET /v2/manage/namespaces/{namespace}/repos/{repository}/tags?offset={offset}&limit={limit}&order_column={order_column}&order_type={order_type}&tag={tag}</p>
|
||
<p id="swr_02_0035__p567781411386">For details about parameters, see <a href="#swr_02_0035__table11843162810214">Table 1</a>.</p>
|
||
|
||
<div class="tablenoborder"><a name="swr_02_0035__table11843162810214"></a><a name="table11843162810214"></a><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0035__table11843162810214" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="swr_02_0035__row20843172818213"><th align="left" class="cellrowborder" valign="top" width="15.61%" id="mcps1.3.2.4.2.5.1.1"><p id="swr_02_0035__p3843528621">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="11.93%" id="mcps1.3.2.4.2.5.1.2"><p id="swr_02_0035__p1450315424313">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="17.22%" id="mcps1.3.2.4.2.5.1.3"><p id="swr_02_0035__p15022419437">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="55.24%" id="mcps1.3.2.4.2.5.1.4"><p id="swr_02_0035__p1584342811211">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="swr_02_0035__row1084316281925"><td class="cellrowborder" valign="top" width="15.61%" headers="mcps1.3.2.4.2.5.1.1 "><p id="swr_02_0035__p6843228526">namespace</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="11.93%" headers="mcps1.3.2.4.2.5.1.2 "><p id="swr_02_0035__p10507114164313">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="17.22%" headers="mcps1.3.2.4.2.5.1.3 "><p id="swr_02_0035__p105058419438">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="55.24%" headers="mcps1.3.2.4.2.5.1.4 "><p id="swr_02_0035__p85037015469">Organization name</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row1319321944420"><td class="cellrowborder" valign="top" width="15.61%" headers="mcps1.3.2.4.2.5.1.1 "><p id="swr_02_0035__p919315194441">repository</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="11.93%" headers="mcps1.3.2.4.2.5.1.2 "><p id="swr_02_0035__p15466162817454">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="17.22%" headers="mcps1.3.2.4.2.5.1.3 "><p id="swr_02_0035__p546292854514">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="55.24%" headers="mcps1.3.2.4.2.5.1.4 "><p id="swr_02_0035__p13193201924411">Image repository name.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0035__table117492059151717" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Query parameters</caption><thead align="left"><tr id="swr_02_0035__row1274845915170"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.5.2.5.1.1"><p id="swr_02_0035__p1574965919178">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.5.2.5.1.2"><p id="swr_02_0035__p375065916176">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.5.2.5.1.3"><p id="swr_02_0035__p27501959191717">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.5.2.5.1.4"><p id="swr_02_0035__p775155917178">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="swr_02_0035__row374825931714"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.1 "><p id="swr_02_0035__p175125911717">limit</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.2 "><p id="swr_02_0035__p47511597173">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.3 "><p id="swr_02_0035__p9752145916177">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.5.2.5.1.4 "><p id="swr_02_0035__p1475213597178">Number of returned records. Parameters <strong id="swr_02_0035__b15152227073122">offset</strong> and <strong id="swr_02_0035__b38791840173122">limit</strong> should always be used together. If this parameter is not specified, all records will be returned by default.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row1874816593170"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.1 "><p id="swr_02_0035__p175318591171">offset</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.2 "><p id="swr_02_0035__p075365961718">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.3 "><p id="swr_02_0035__p77538594175">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.5.2.5.1.4 "><p id="swr_02_0035__p7861419121710">Start index. The value can be <strong id="swr_02_0035__b175771723207">0</strong> or a positive integer multiple of the <strong id="swr_02_0035__b65781720205">limit</strong> value. If this parameter is not specified, all records will be returned by default.</p>
|
||
<p id="swr_02_0035__p18754125971713">Parameters <strong id="swr_02_0035__b112202567573122">offset</strong> and <strong id="swr_02_0035__b40431804073122">limit</strong> should always be used together.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row374815591176"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.1 "><p id="swr_02_0035__p8754115951717">order_column</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.2 "><p id="swr_02_0035__p1675555916179">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.3 "><p id="swr_02_0035__p12755135915179">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.5.2.5.1.4 "><p id="swr_02_0035__p875625912170">Sorting by column. You can set this parameter to <strong id="swr_02_0035__b97404961373249">updated_at</strong> (sorting by update time). Parameters <strong id="swr_02_0035__b73838215173218">order_column</strong> and <strong id="swr_02_0035__b172918443073218">order_type</strong> should always be used together.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row1774820593179"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.1 "><p id="swr_02_0035__p475695910176">order_type</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.2 "><p id="swr_02_0035__p17582591178">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.3 "><p id="swr_02_0035__p1175845911177">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.5.2.5.1.4 "><p id="swr_02_0035__p375955981717">Sorting type. You can set this parameter to <strong id="swr_02_0035__b32822715274115">desc</strong> (descending sort) or <strong id="swr_02_0035__b132698332274115">asc</strong> (ascending sort). Parameters <strong id="swr_02_0035__b25219786573218">order_column</strong> and <strong id="swr_02_0035__b8046857373218">order_type</strong> should always be used together.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row8748195931711"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.1 "><p id="swr_02_0035__p147607599176">tag</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.2 "><p id="swr_02_0035__p37601759111710">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.3 "><p id="swr_02_0035__p13760959111719">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.5.2.5.1.4 "><p id="swr_02_0035__p176155961713">Image tag name.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row3748155931712"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.1 "><p id="swr_02_0035__p67611659151715">filter</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.2 "><p id="swr_02_0035__p1761125981714">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.5.2.5.1.3 "><p id="swr_02_0035__p37622593176">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.5.2.5.1.4 "><p id="swr_02_0035__p127627596178">Set this parameter to <strong id="swr_02_0035__b1378732816451">offset</strong>::{<em id="swr_02_0035__i1978711285459">offset</em>}|<strong id="swr_02_0035__b9789162811459">limit</strong>::{<em id="swr_02_0035__i379012811459">limit</em>}|<strong id="swr_02_0035__b107911328154519">order_column</strong>::{<em id="swr_02_0035__i37921283451">order_column</em>}|<strong id="swr_02_0035__b1379219287451">order_type</strong>::{<em id="swr_02_0035__i10792142874514">order_type</em>}|<strong id="swr_02_0035__b1479314280457">tag</strong>::{<em id="swr_02_0035__i379320284453">tag</em>}. <strong id="swr_02_0035__b67947285452">limit</strong> indicates the number of returned records. <strong id="swr_02_0035__b6794128174514">offset</strong> indicates the start index. Parameters <strong id="swr_02_0035__b479502844514">offset</strong> and <strong id="swr_02_0035__b2795182834511">limit</strong> should always be used together. <strong id="swr_02_0035__b8547204094512">order_column</strong> indicates sorting by column, which can be <strong id="swr_02_0035__b1354804010452">updated_at</strong> (sorting by update time). <strong id="swr_02_0035__b654944094518">order_type</strong> indicates the sorting type, which can be <strong id="swr_02_0035__b185491400452">desc</strong> (descending order) or <strong id="swr_02_0035__b054918402454">asc</strong> (ascending order). <strong id="swr_02_0035__b1455034017454">tag</strong> indicates the image tag name.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="swr_02_0035__section3270966102931"><h4 class="sectiontitle">Request</h4><ul id="swr_02_0035__ul19491754135111"><li id="swr_02_0035__li1649165475113">Request parameters
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0035__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request header parameters</caption><thead align="left"><tr id="swr_02_0035__row19764155914176"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="swr_02_0035__p147659597172">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="swr_02_0035__p147651359201718">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="swr_02_0035__p976505941713">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="swr_02_0035__p15766105912179">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="swr_02_0035__row1676410597178"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="swr_02_0035__p5766359151714">Content-Type</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="swr_02_0035__p276775981713">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="swr_02_0035__p5767259111714">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="swr_02_0035__p1276885912173">Message body type (format). The value can be <strong id="swr_02_0035__b18045801007100">application/json</strong> or <strong id="swr_02_0035__b15718073427100">charset=utf-8 application/json</strong>.</p>
|
||
<p id="swr_02_0035__p1176855981717">The default value is <strong id="swr_02_0035__b13898641187145">application/json</strong>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row9764125941711"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="swr_02_0035__p27692059131716">X-Auth-Token</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="swr_02_0035__p576912597178">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="swr_02_0035__p177045971712">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="swr_02_0035__p18770155915175">User token.</p>
|
||
<p id="swr_02_0035__p377115599178">The token can be obtained by calling an IAM API. The value of <strong id="swr_02_0035__b179120525071415">X-Subject-Token</strong> in the response header is the user token.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li><li id="swr_02_0035__li119781157185116">Example request<pre class="screen" id="swr_02_0035__screen6161162310529">GET https://{Endpoint}/v2/manage/namespaces/<em id="swr_02_0035__i149214412134">group</em>/repos/<em id="swr_02_0035__i12988239171315">busybox</em>/tags</pre>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="swr_02_0035__section1262713444552"><h4 class="sectiontitle">Response</h4><ul id="swr_02_0035__ul112361746191317"><li id="swr_02_0035__li10236184671313">Response parameters<p id="swr_02_0035__p1577265951715"><a name="swr_02_0035__li10236184671313"></a><a name="li10236184671313"></a>Status code: 200</p>
|
||
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0035__ResponseHeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response header parameters</caption><thead align="left"><tr id="swr_02_0035__row777345971717"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="swr_02_0035__p1477405919174">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="swr_02_0035__p1774359141711">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="swr_02_0035__p777520594177">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="swr_02_0035__row0773959151718"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="swr_02_0035__p167751259181715">Content-Range</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="swr_02_0035__p187761759191719">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="swr_02_0035__p577610596178"><em id="swr_02_0035__i18753152174710">Offset</em> (Start index) – <em id="swr_02_0035__i775332114717">Count</em> (Number of records on the current page)/<em id="swr_02_0035__i1675315216474">Total</em> (Total number of records)</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0035__response_ListRepositoryTagsDetailsResp" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="swr_02_0035__row27771659191711"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="swr_02_0035__p1777815591175">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.4.1.2"><p id="swr_02_0035__p1377925920177">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.2.1.3.2.4.1.3"><p id="swr_02_0035__p167799597172">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="swr_02_0035__row1377710597174"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="swr_02_0035__p1477917599174">[<em id="swr_02_0035__i13567333174715">Array</em>]</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="swr_02_0035__p1278065931716">Array of <a href="swr_02_0035.html">ShowReposTagResp</a> objects</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="swr_02_0035__p27801759111714">Image tags.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0035__table45446245174724" frame="border" border="1" rules="all"><caption><b>Table 6 </b><em id="swr_02_0035__i3162172125919">[Array element]</em> parameters description</caption><thead align="left"><tr id="swr_02_0035__row1412623174724"><th align="left" class="cellrowborder" valign="top" width="34.616538346165385%" id="mcps1.3.4.2.1.4.2.4.1.1"><p id="swr_02_0035__p47313663174724">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="30.76692330766923%" id="mcps1.3.4.2.1.4.2.4.1.2"><p id="swr_02_0035__p7201512174724">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="34.616538346165385%" id="mcps1.3.4.2.1.4.2.4.1.3"><p id="swr_02_0035__p4480706174724">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="swr_02_0035__row23391130131913"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p43401630141910">id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p1224112114332">Integer</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p20340730191918">ID</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row697982791918"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p10980112717192">repo_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p20980132718193">Integer</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p14980192714197">Repository ID.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row17668249354"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p3602231570">Tag</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p360215315712">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p206025311878">Image tag name.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row176816213207"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p1568212212204">image_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p1568252172015">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p1968202192013">Image ID.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row2590104211156"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p1592204251517">manifest</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p95921422152">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p145923427155">Image manifest.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row411720412429"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p8361449104214">digest</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p103631149164219">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p33651491427">SHA value of an image.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row19747155313423"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p55111044437">schema</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p65137412431">Integer</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p05141147434">Docker protocol version. The version can be <strong id="swr_02_0035__b740155745519">1</strong> or <strong id="swr_02_0035__b341175713559">2</strong>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row27392900174724"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p66029311173">path</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p460211311279">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p9603163112712">External image pull address. The format is {<em id="swr_02_0035__i710418835719">Repository address</em>}/{<em id="swr_02_0035__i1743691115719">Namespace name</em>}/{<em id="swr_02_0035__i14586131410579">Repository name</em>}:{<em id="swr_02_0035__i2979201665717">Tag name</em>}.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row207081451715"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p1701714191712">internal_path</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p470314161716">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p07051481718">Internal image pull address. The format is {<em id="swr_02_0035__i0372143615714">Repository address</em>}/{<em id="swr_02_0035__i6731439105713">Namespace name</em>}/{<em id="swr_02_0035__i1757719423572">Repository name</em>}:{<em id="swr_02_0035__i3810194465713">Tag name</em>}.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row12917712114013"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p15603531879">size</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p1760318310710">Integer</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p9251151612913">Image size.</p>
|
||
<p id="swr_02_0035__p147199108918">Value range: 0 to 9223372036854775807</p>
|
||
<p id="swr_02_0035__p136038314714">Unit: byte</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row6189161112289"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p519041132810">is_trusted</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p1119014117288">Boolean</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p13191811182818">By default, the value is <strong id="swr_02_0035__b17706183718379">false</strong>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row24091911193911"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p13603531378">created</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p660333115711">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p760315313710">Time when an image is created. It is the UTC standard time. You need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead of GMT.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row10790853193918"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p14603631778">updated</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p3603203112717">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p1360316317716">Time when an image is updated. It is the UTC standard time. You need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead of GMT.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row1627112185506"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p427119188502">deleted</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p142711318125017">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p1327116186505">Time when an image was deleted.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row142152733215"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p1721162713220">domain_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p20211227193216">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p7213275320">Account ID.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row1522627203220"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="swr_02_0035__p1622327153220">tag_type</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="swr_02_0035__p622227143219">Integer</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="swr_02_0035__p162262711323">0: manifest. 1: manifest list.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li><li id="swr_02_0035__li92874821317">Example response<pre class="screen" id="swr_02_0035__screen573455471">[
|
||
{
|
||
"id": 0,
|
||
"repo_id": 0,
|
||
"Tag": "latest",
|
||
"image_id": "741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6",
|
||
"manifest": "{\"schemaVersion\":2,\"mediaType\":\"application/vnd.docker.distribution.manifest.v2+json\",\"config\":{\"mediaType\":\"application/vnd.docker.container.image.v1+json\",\"size\":1862,\"digest\":\"sha256:741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6\"},\"layers\":[{\"mediaType\":\"application/vnd.docker.image.rootfs.diff.tar.gzip\",\"size\":1292800,\"digest\":\"sha256:8ac8bfaff55af948c796026ee867448c5b5b5d9dd3549f4006d9759b25d4a893\"},{\"mediaType\":\"application/vnd.docker.image.rootfs.diff.tar.gzip\",\"size\":10240,\"digest\":\"sha256:77ddbf3a9fe11e81761a0f9df43a28e3e6f29bbb53c0c8cf71cd7efa69729aed\"}]}",
|
||
"digest": "sha256:57b605845a6367c34bfb6ea6477f16852f59aa1861a2b51d10ab77ae0a1dc9c3",
|
||
"schema": 2,
|
||
"path": "{Repository address}/group/busybox:latest",
|
||
"internal_path": "10.125.0.198:20202/namespace/busybox:latest",
|
||
"size": 1304902,
|
||
"is_trusted": false,
|
||
"created": "2018-07-06T06:18:55Z",
|
||
"updated": "2018-07-06T06:18:55Z",
|
||
"deleted": null,
|
||
"domain_id": "0503dda878000fed0f75c0096d70a960",
|
||
"tag_type": 0
|
||
}
|
||
]</pre>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="swr_02_0035__section5365169104253"><h4 class="sectiontitle">Status Code</h4>
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0035__table1984564864716" frame="border" border="1" rules="all"><thead align="left"><tr id="swr_02_0035__row1984554824718"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.1"><p id="swr_02_0035__p4846548124714">Status Code</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.2"><p id="swr_02_0035__p984612486479">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="swr_02_0035__row1484619482477"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0035__p88461948154710">200</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0035__p13846748154710">All tags in the image repository are successfully queried.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row98468489472"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0035__p14846134812476">400</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0035__p08461448114716">Request error. Error information is returned.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row631310443579"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0035__p12314164419574">401</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0035__p93141244155715">Authentication failed.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row9846114818471"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0035__p188468486471">404</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0035__p11846134819473">The repository does not exist.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="swr_02_0035__row16846248114719"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0035__p2846248184714">500</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0035__p5846154810474">Internal error. Error information is returned.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="swr_02_0035__section134071631161117"><h4 class="sectiontitle">Error Codes</h4><p id="swr_02_0035__p15408431161114">For details, see <a href="swr_02_0024.html">Error Codes</a>.</p>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0000001420688458.html">Image Tag Management</a></div>
|
||
</div>
|
||
</div>
|
||
|