1
0
forked from docs/doc-exports
doc-exports/docs/swr/api-ref/swr_02_0046.html
Dong, Qiu Jian 150bc2026a SWR API initial version reuploaded -20221102
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
Co-committed-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
2022-11-10 10:18:36 +00:00

164 lines
12 KiB
HTML

<a name="swr_02_0046"></a><a name="swr_02_0046"></a>
<h1 class="topictitle1">Creating Image Permissions</h1>
<div id="body1531798197461"><div class="section" id="swr_02_0046__se03aae4436e64394a95dc13b6f233898"><h4 class="sectiontitle">Function</h4><p id="swr_02_0046__a7005bd3228d34f8ea0fb7b75b17cfbb2">Grant permissions of an image to certain users so that they can manage, edit, and read the image.</p>
</div>
<div class="section" id="swr_02_0046__s476df674307e4b04b9545f9575dde042"><h4 class="sectiontitle">URI</h4><p id="swr_02_0046__p9609115118129">POST /v2/manage/namespaces/{<em id="swr_02_0046__i14875033863">namespace</em>}/repos/{<em id="swr_02_0046__i1898838568">repository</em>}/access</p>
<p id="swr_02_0046__p824535719488">For details about parameters, see <a href="#swr_02_0046__table73271639103420">Table 1</a>.</p>
<div class="tablenoborder"><a name="swr_02_0046__table73271639103420"></a><a name="table73271639103420"></a><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0046__table73271639103420" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="swr_02_0046__row53291539153419"><th align="left" class="cellrowborder" valign="top" width="17%" id="mcps1.3.2.4.2.5.1.1"><p id="swr_02_0046__p6331539113416">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.2.4.2.5.1.2"><p id="swr_02_0046__p1546521102411">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.2.4.2.5.1.3"><p id="swr_02_0046__p185461421102417">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54%" id="mcps1.3.2.4.2.5.1.4"><p id="swr_02_0046__p43347399345">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0046__row7335939103416"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.2.4.2.5.1.1 "><p id="swr_02_0046__p6843228526">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.2.4.2.5.1.2 "><p id="swr_02_0046__p45474214244">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.2.4.2.5.1.3 "><p id="swr_02_0046__p4547122132412">String</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.2.4.2.5.1.4 "><p id="swr_02_0046__p776511203467">Organization name.</p>
</td>
</tr>
<tr id="swr_02_0046__row107916202715"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.2.4.2.5.1.1 "><p id="swr_02_0046__p57616102710">repository</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.2.4.2.5.1.2 "><p id="swr_02_0046__p75471621102416">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.2.4.2.5.1.3 "><p id="swr_02_0046__p125471621152412">String</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.2.4.2.5.1.4 "><p id="swr_02_0046__p187161619273">Image name.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0046__s8246d3afdd6f44dc817ce0c3f2ac7d53"><h4 class="sectiontitle">Request</h4><ul id="swr_02_0046__ul16281193814915"><li id="swr_02_0046__li428153874914">Request parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0046__table34001413863" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameter description</caption><thead align="left"><tr id="swr_02_0046__row17400171319612"><th align="left" class="cellrowborder" valign="top" width="16.65833416658334%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="swr_02_0046__p1840015139619">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.768423157684234%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="swr_02_0046__p1410131010424">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.12838716128387%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="swr_02_0046__p24002135620">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.44485551444855%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="swr_02_0046__p174008131163">Description.</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0046__row11400113668"><td class="cellrowborder" valign="top" width="16.65833416658334%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="swr_02_0046__p1482131117588"><em id="swr_02_0046__i16401119182119">[Array element]</em></p>
</td>
<td class="cellrowborder" valign="top" width="15.768423157684234%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="swr_02_0046__p1210181034216">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.12838716128387%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="swr_02_0046__p88201811175811">Array of <a href="#swr_02_0046__table6912142367">objects</a></p>
</td>
<td class="cellrowborder" valign="top" width="51.44485551444855%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="swr_02_0046__p181911115588">User list</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="swr_02_0046__table6912142367"></a><a name="table6912142367"></a><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0046__table6912142367" frame="border" border="1" rules="all"><caption><b>Table 3 </b><em id="swr_02_0046__i17520173014289">[Array element]</em> parameters decription</caption><thead align="left"><tr id="swr_02_0046__row494101419361"><th align="left" class="cellrowborder" valign="top" width="17%" id="mcps1.3.3.2.1.2.2.5.1.1"><p id="swr_02_0046__p495214193611">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.2.1.2.2.5.1.2"><p id="swr_02_0046__p763819132514">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.3.2.1.2.2.5.1.3"><p id="swr_02_0046__p15638892255">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54%" id="mcps1.3.3.2.1.2.2.5.1.4"><p id="swr_02_0046__p1498214113618">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0046__row69961413365"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="swr_02_0046__p1110011416365">user_id</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="swr_02_0046__p186387916259">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="swr_02_0046__p1263818912520">String</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="swr_02_0046__p46175204712">User ID.</p>
</td>
</tr>
<tr id="swr_02_0046__row3105101418360"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="swr_02_0046__p3107314193615">user_name</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="swr_02_0046__p56389912515">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="swr_02_0046__p763816917251">String</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="swr_02_0046__p1761185234713">Username.</p>
</td>
</tr>
<tr id="swr_02_0046__row135101232143711"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="swr_02_0046__p35101132143714">auth</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="swr_02_0046__p9638791258">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="swr_02_0046__p18638189142515">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="swr_02_0046__p1751033214375">User permission that is configured.</p>
<ul id="swr_02_0046__ul654813144019"><li id="swr_02_0046__li115901316202">7: Manage</li><li id="swr_02_0046__li55991417708">3: Write</li><li id="swr_02_0046__li15482141406">1: Read</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="swr_02_0046__li99231240114912">Example request<pre class="screen" id="swr_02_0046__screen11181512125516">POST https://{Endpoint}/v2/manage/namespaces/<em id="swr_02_0046__i12551540155513">group</em>/repos/<em id="swr_02_0046__i12140195065510">busybox</em>/access</pre>
<p id="swr_02_0046__p201004451372">Body:</p>
<pre class="screen" id="swr_02_0046__screen11748172212473">[
{
"user_id": "fb3f175c1fd146ab8cdae3272be6107b",
"user_name": "user01",
"auth": 1
}
]</pre>
</li></ul>
</div>
<div class="section" id="swr_02_0046__sab9be5ce850743859bb238e072f8d1f2"><h4 class="sectiontitle">Response</h4><ul id="swr_02_0046__ul11656391015"><li id="swr_02_0046__li194756411106">Response parameters<p id="swr_02_0046__p370911481507"><a name="swr_02_0046__li194756411106"></a><a name="li194756411106"></a>N/A</p>
</li><li id="swr_02_0046__li129849446013">Example response<pre class="screen" id="swr_02_0046__screen148234561804">{}</pre>
</li></ul>
</div>
<div class="section" id="swr_02_0046__s336c1dbc7af446a1b3cc077ea3f82fc9"><h4 class="sectiontitle">Status Code</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0046__t33d02fa79e8443868a71c99f411610a5" frame="border" border="1" rules="all"><thead align="left"><tr id="swr_02_0046__r9eb80d64e8f34d0db940daa95fc929dd"><th align="left" class="cellrowborder" valign="top" width="16.439999999999998%" id="mcps1.3.5.2.1.3.1.1"><p id="swr_02_0046__a7e51ed73a71e4dc29d0dd4aae3016632">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="83.56%" id="mcps1.3.5.2.1.3.1.2"><p id="swr_02_0046__aa802d02e21c944f1863435a0d11c7ec1">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0046__r1cc0192c651444db882dde750b14be23"><td class="cellrowborder" valign="top" width="16.439999999999998%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0046__a6a3639a3cb154e17b95c5076c8036471">201</p>
</td>
<td class="cellrowborder" valign="top" width="83.56%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0046__ad54ae639e7f94380a87bfc10cc91a4f0">Creation successful.</p>
</td>
</tr>
<tr id="swr_02_0046__r0bd68000afe546dd9c7a8d3a05991a04"><td class="cellrowborder" valign="top" width="16.439999999999998%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0046__ad46ccdc6b7e04df3b6b5679f7606f434">400</p>
</td>
<td class="cellrowborder" valign="top" width="83.56%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0046__a1f2e8d58145d461781428d28f07a5351">Request error.</p>
</td>
</tr>
<tr id="swr_02_0046__row059261364320"><td class="cellrowborder" valign="top" width="16.439999999999998%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0046__p059261310438">401</p>
</td>
<td class="cellrowborder" valign="top" width="83.56%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0046__p759261314433">Authentication failed.</p>
</td>
</tr>
<tr id="swr_02_0046__row9547111612437"><td class="cellrowborder" valign="top" width="16.439999999999998%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0046__p19547131615432">404</p>
</td>
<td class="cellrowborder" valign="top" width="83.56%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0046__p16547416114315">The image does not exist.</p>
</td>
</tr>
<tr id="swr_02_0046__r19bdef782c164c93917f897241e521f8"><td class="cellrowborder" valign="top" width="16.439999999999998%" headers="mcps1.3.5.2.1.3.1.1 "><p id="swr_02_0046__a7da68e311c0f4267bacf3cbdb71d1ead">500</p>
</td>
<td class="cellrowborder" valign="top" width="83.56%" headers="mcps1.3.5.2.1.3.1.2 "><p id="swr_02_0046__aa6fd12cedd8841e29eeeca27c1bdea1a">Internal error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="swr_02_0011.html">API</a></div>
</div>
</div>