doc-exports/docs/swr/api-ref/swr_02_0074.html
Dong, Qiu Jian f5c28c856a SWR API update 20241012
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>
2024-10-18 07:19:46 +00:00

245 lines
18 KiB
HTML

<a name="swr_02_0074"></a><a name="swr_02_0074"></a>
<h1 class="topictitle1">Obtaining the List of Accounts Used for Image Sharing</h1>
<div id="body1536217343735"><div class="section" id="swr_02_0074__section14905762191056"><h4 class="sectiontitle">Function</h4><p id="swr_02_0074__p38546794191926">Obtain the list of accounts used for image sharing.</p>
</div>
<div class="section" id="swr_02_0074__section10482810165331"><h4 class="sectiontitle">URI</h4><p id="swr_02_0074__p36111642203811">GET /v2/manage/namespaces/{<em id="swr_02_0074__i5257192933218">namespace</em>}/repositories/{<em id="swr_02_0074__i1486010326321">repository</em>}/access-domains</p>
<p id="swr_02_0074__p567781411386">For details about parameters, see <a href="#swr_02_0074__table11843162810214">Table 1</a>.</p>
<div class="tablenoborder"><a name="swr_02_0074__table11843162810214"></a><a name="table11843162810214"></a><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0074__table11843162810214" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="swr_02_0074__row20843172818213"><th align="left" class="cellrowborder" valign="top" width="18.4%" id="mcps1.3.2.4.2.5.1.1"><p id="swr_02_0074__p3843528621">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.469999999999999%" id="mcps1.3.2.4.2.5.1.2"><p id="swr_02_0074__p198988313226">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.74%" id="mcps1.3.2.4.2.5.1.3"><p id="swr_02_0074__p128986316221">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.39%" id="mcps1.3.2.4.2.5.1.4"><p id="swr_02_0074__p1584342811211">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0074__row1084316281925"><td class="cellrowborder" valign="top" width="18.4%" headers="mcps1.3.2.4.2.5.1.1 "><p id="swr_02_0074__p6843228526">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="14.469999999999999%" headers="mcps1.3.2.4.2.5.1.2 "><p id="swr_02_0074__p10898431122213">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.74%" headers="mcps1.3.2.4.2.5.1.3 "><p id="swr_02_0074__p289883118229">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.39%" headers="mcps1.3.2.4.2.5.1.4 "><p id="swr_02_0074__p85037015469">Organization name. An organization name contains 1 to 64 characters. It must start with a lowercase letter and end 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_0074__row1319321944420"><td class="cellrowborder" valign="top" width="18.4%" headers="mcps1.3.2.4.2.5.1.1 "><p id="swr_02_0074__p919315194441">repository</p>
</td>
<td class="cellrowborder" valign="top" width="14.469999999999999%" headers="mcps1.3.2.4.2.5.1.2 "><p id="swr_02_0074__p98981331172211">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.74%" headers="mcps1.3.2.4.2.5.1.3 "><p id="swr_02_0074__p1189833112228">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.39%" headers="mcps1.3.2.4.2.5.1.4 "><p id="swr_02_0074__p13193201924411">Image repository name</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0074__section3270966102931"><h4 class="sectiontitle">Request</h4><ul id="swr_02_0074__ul57641153239"><li id="swr_02_0074__li376411510236">Request parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0074__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="swr_02_0074__row19503135221817"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="swr_02_0074__p1350625261819">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_0074__p105071252121810">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_0074__p105081052101815">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_0074__p1350955219188">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0074__row18503115218184"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="swr_02_0074__p155111521184">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_0074__p351225215182">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_0074__p75132052171813">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_0074__p15514175221813">Message body type (format). The value can be <strong id="swr_02_0074__b103420910372225">application/json</strong> or <strong id="swr_02_0074__b59591143172225">charset=utf-8 application/json</strong>.</p>
<p id="swr_02_0074__p8515145231820">The default value is <strong id="swr_02_0074__b61313809271411">application/json</strong>.</p>
</td>
</tr>
<tr id="swr_02_0074__row12503135291820"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="swr_02_0074__p3516052171810">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_0074__p751785213185">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_0074__p2051835271812">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_0074__p3519135231820">User token.</p>
<p id="swr_02_0074__p252116528185">The token can be obtained by calling an IAM API. The value of <strong id="swr_02_0074__b171897585271421">X-Subject-Token</strong> in the response header is the user token.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="swr_02_0074__li1278941712231">Example request<pre class="screen" id="swr_02_0074__screen1486125172318">GET https://{Endpoint}/v2/manage/namespaces/<em id="swr_02_0074__i12317484236">group</em>/repositories/<em id="swr_02_0074__i848845010233">busybox</em>/access-domains</pre>
</li></ul>
</div>
<div class="note" id="swr_02_0074__note1052431917212"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="swr_02_0074__p1452410197212">By default, 100 records will be returned.</p>
</div></div>
<div class="section" id="swr_02_0074__section1262713444552"><h4 class="sectiontitle">Response</h4><ul id="swr_02_0074__ul1751292296"><li id="swr_02_0074__li15119952911">Response parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0074__table34001413863" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response body parameter description</caption><thead align="left"><tr id="swr_02_0074__row17400171319612"><th align="left" class="cellrowborder" valign="top" width="24.64%" id="mcps1.3.5.2.1.1.2.4.1.1"><p id="swr_02_0074__p1840015139619">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.22%" id="mcps1.3.5.2.1.1.2.4.1.2"><p id="swr_02_0074__p24002135620">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.13999999999999%" id="mcps1.3.5.2.1.1.2.4.1.3"><p id="swr_02_0074__p174008131163">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0074__row11400113668"><td class="cellrowborder" valign="top" width="24.64%" headers="mcps1.3.5.2.1.1.2.4.1.1 "><p id="swr_02_0074__p1482131117588"><em id="swr_02_0074__i1250010016224">[Array element]</em></p>
</td>
<td class="cellrowborder" valign="top" width="24.22%" headers="mcps1.3.5.2.1.1.2.4.1.2 "><p id="swr_02_0074__p88201811175811">Array of <a href="#swr_02_0074__table45446245174724">objects</a></p>
</td>
<td class="cellrowborder" valign="top" width="51.13999999999999%" headers="mcps1.3.5.2.1.1.2.4.1.3 "><p id="swr_02_0074__p181911115588">Shared accounts.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="swr_02_0074__table45446245174724"></a><a name="table45446245174724"></a><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0074__table45446245174724" frame="border" border="1" rules="all"><caption><b>Table 4 </b><em id="swr_02_0074__i87667238236">[Array element]</em> parameter description</caption><thead align="left"><tr id="swr_02_0074__row1412623174724"><th align="left" class="cellrowborder" valign="top" width="34.616538346165385%" id="mcps1.3.5.2.1.2.2.4.1.1"><p id="swr_02_0074__p47313663174724">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="30.76692330766923%" id="mcps1.3.5.2.1.2.2.4.1.2"><p id="swr_02_0074__p7201512174724">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="34.616538346165385%" id="mcps1.3.5.2.1.2.2.4.1.3"><p id="swr_02_0074__p4480706174724">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0074__row23391130131913"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p43401630141910">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p203401530111912">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p20340730191918">Organization name.</p>
</td>
</tr>
<tr id="swr_02_0074__row697982791918"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p10980112717192">repository</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p20980132718193">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p14980192714197">Image repository name.</p>
</td>
</tr>
<tr id="swr_02_0074__row17668249354"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p4111525165410">access_domain</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p360215315712">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p206025311878">Name of the account used for image sharing.</p>
</td>
</tr>
<tr id="swr_02_0074__row176816213207"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p1568212212204">permit</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p1568252172015">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p1968202192013">Permission.</p>
</td>
</tr>
<tr id="swr_02_0074__row411720412429"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p820345065419">deadline</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p103631149164219">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p33651491427">Expiration time.</p>
</td>
</tr>
<tr id="swr_02_0074__row19747155313423"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p9463481556">description</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p65137412431">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p05141147434">Description.</p>
</td>
</tr>
<tr id="swr_02_0074__row27392900174724"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p18944193920576">creator_id</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p460211311279">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p368285415720">Creator ID.</p>
</td>
</tr>
<tr id="swr_02_0074__row12917712114013"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p15603531879">creator_name</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p1760318310710">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p136038314714">Name of the creator.</p>
</td>
</tr>
<tr id="swr_02_0074__row24091911193911"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p13603531378">created</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p204545431021">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p760315313710">Time when an image was 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 the GMT time.</p>
</td>
</tr>
<tr id="swr_02_0074__row10790853193918"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p14603631778">updated</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p1788465012216">String</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p1360316317716">Time when an image was 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 the GMT time.</p>
</td>
</tr>
<tr id="swr_02_0074__row1627112185506"><td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="swr_02_0074__p427119188502">status</p>
</td>
<td class="cellrowborder" valign="top" width="30.76692330766923%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="swr_02_0074__p142711318125017">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="34.616538346165385%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="swr_02_0074__p1780013411299">Status. <strong id="swr_02_0074__b1979075220434">true</strong>: valid; <strong id="swr_02_0074__b1179185210435">false</strong>: expired</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="swr_02_0074__li11875111014296">Example response<pre class="screen" id="swr_02_0074__screen573455471">[
{
"namespace": "group",
"repository": "busybox",
"access_domain": "swr",
"permit": "read",
"deadline": "2021-10-01T16:00:00Z",
"description": "description",
"creator_id": "fb3f175c1fd146ab8cdae3272be6107b",
"creator_name": "group",
"created": "2021-06-10T08:14:42.56632Z",
"updated": "2021-06-10T08:14:42.566325Z",
"status": true
}
]</pre>
</li></ul>
</div>
<div class="section" id="swr_02_0074__section5365169104253"><h4 class="sectiontitle">Status Code</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0074__table1984564864716" frame="border" border="1" rules="all"><thead align="left"><tr id="swr_02_0074__row1984554824718"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.6.2.1.3.1.1"><p id="swr_02_0074__p4846548124714">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.6.2.1.3.1.2"><p id="swr_02_0074__p984612486479">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0074__row1484619482477"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.1 "><p id="swr_02_0074__p88461948154710">200</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.2 "><p id="swr_02_0074__p13846748154710">The list of image sharing accounts is returned successfully.</p>
</td>
</tr>
<tr id="swr_02_0074__row98468489472"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.1 "><p id="swr_02_0074__p14846134812476">400</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.2 "><p id="swr_02_0074__p08461448114716">Request error. Error information is returned.</p>
</td>
</tr>
<tr id="swr_02_0074__row141518196387"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.1 "><p id="swr_02_0074__p10415101913816">401</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.2 "><p id="swr_02_0074__p16415121953810">Authentication failed.</p>
</td>
</tr>
<tr id="swr_02_0074__row16846248114719"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.1 "><p id="swr_02_0074__p2846248184714">500</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.2.1.3.1.2 "><p id="swr_02_0074__p5846154810474">Internal error. Error information is returned.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0074__section134071631161117"><h4 class="sectiontitle">Error Codes</h4><p id="swr_02_0074__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_0000001470804877.html">Shared Account Management</a></div>
</div>
</div>