Files
doc-exports/docs/swr/api-ref/swr_02_0045.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

215 lines
18 KiB
HTML

<a name="swr_02_0045"></a><a name="swr_02_0045"></a>
<h1 class="topictitle1">Querying Organization Permissions</h1>
<div id="body8662426"><div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section48222472818"><h4 class="sectiontitle">Description</h4><p id="swr_02_0045__en-us_topic_0000001185914352_p1282215471889">Query organization permissions.</p>
</div>
<div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section1582284718815"><h4 class="sectiontitle">Constraints</h4><p id="swr_02_0045__en-us_topic_0000001185914352_p1823047384">None</p>
</div>
<div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section7823134710819"><h4 class="sectiontitle">URI</h4><p id="swr_02_0045__en-us_topic_0000001185914352_p48231471783">GET /v2/manage/namespaces/{namespace}/access</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0045__en-us_topic_0000001185914352_table128258470814" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameter</caption><thead align="left"><tr id="swr_02_0045__en-us_topic_0000001185914352_row1282410477811"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="swr_02_0045__en-us_topic_0000001185914352_p1682515471819">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_0045__en-us_topic_0000001185914352_p1682512471816">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_0045__en-us_topic_0000001185914352_p782594718818">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_0045__en-us_topic_0000001185914352_p108258471186">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0045__en-us_topic_0000001185914352_row19824347982"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p1382615471389">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p128264474815">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p9826124719817">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="swr_02_0045__en-us_topic_0000001185914352_p1782613471984">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>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section382614713819"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0045__en-us_topic_0000001185914352_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="swr_02_0045__en-us_topic_0000001185914352_row8826647583"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="swr_02_0045__en-us_topic_0000001185914352_p782714717815">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_0045__en-us_topic_0000001185914352_p28277470813">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_0045__en-us_topic_0000001185914352_p158275471881">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_0045__en-us_topic_0000001185914352_p198272471186">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0045__en-us_topic_0000001185914352_row1682618471381"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p882714471816">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p882718471081">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p19827124719819">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="swr_02_0045__en-us_topic_0000001185914352_p182744719818">Message body type (format). The value can be <strong id="swr_02_0045__en-us_topic_0000001185914352_b154042411321">application/json</strong> or <strong id="swr_02_0045__en-us_topic_0000001185914352_b194041148321">charset=utf-8 application/json</strong>.</p>
<p id="swr_02_0045__en-us_topic_0000001185914352_p7827114717817">Default value: <strong id="swr_02_0045__en-us_topic_0000001185914352_b693019715324">application/json</strong></p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row682620478813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p682784711818">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_0045__en-us_topic_0000001185914352_p48271847289">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p198274477812">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="swr_02_0045__en-us_topic_0000001185914352_p108273478814">User token.</p>
<p id="swr_02_0045__en-us_topic_0000001185914352_p582704714816">The token can be obtained by calling an IAM API. The value of <strong id="swr_02_0045__en-us_topic_0000001185914352_b3946112063214">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_0045__en-us_topic_0000001185914352_section1827847683"><h4 class="sectiontitle">Response Parameters</h4><p id="swr_02_0045__en-us_topic_0000001185914352_p1682713473817"><strong id="swr_02_0045__en-us_topic_0000001185914352_b1244908412111033">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0045__en-us_topic_0000001185914352_response_ShowNamespaceAuthResp" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response body parameters</caption><thead align="left"><tr id="swr_02_0045__en-us_topic_0000001185914352_row168280474817"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.1"><p id="swr_02_0045__en-us_topic_0000001185914352_p98287471486">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_0045__en-us_topic_0000001185914352_p2828184718818">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.3.2.4.1.3"><p id="swr_02_0045__en-us_topic_0000001185914352_p128281347788">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0045__en-us_topic_0000001185914352_row982854715817"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p882813476815">id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p78289477817">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p982815477810">Permission ID.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row58281047687"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p1828347683">name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p118287473819">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p6828947287">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_0045__en-us_topic_0000001185914352_row16828047988"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p118291347784">creator_name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p128297471481">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p282974713813">Organization creator.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row182819473810"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p19829247588">self_auth</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p18295472811"><a href="#swr_02_0045__en-us_topic_0000001185914352_response_UserAuth">UserAuth</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p682910471886">Permissions of the current user.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row1882811471689"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p3829114711817">others_auths</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p1282910471189">Array of <a href="#swr_02_0045__en-us_topic_0000001185914352_response_UserAuth">UserAuth</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p138294473818">Permissions of other users.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="swr_02_0045__en-us_topic_0000001185914352_response_UserAuth"></a><a name="en-us_topic_0000001185914352_response_UserAuth"></a><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0045__en-us_topic_0000001185914352_response_UserAuth" frame="border" border="1" rules="all"><caption><b>Table 4 </b>UserAuth</caption><thead align="left"><tr id="swr_02_0045__en-us_topic_0000001185914352_row168291247789"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.4.2.4.1.1"><p id="swr_02_0045__en-us_topic_0000001185914352_p118301471889">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_0045__en-us_topic_0000001185914352_p98303471813">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_0045__en-us_topic_0000001185914352_p4830164710817">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0045__en-us_topic_0000001185914352_row9829194714820"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p14830124714817">user_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p14830947183">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p16830194715815">User ID. Obtain it from IAM.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row1482913471388"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p1483012471182">user_name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p283018477817">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p128301347981">Username. Obtain it from IAM.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row3829114713817"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p178309471380">auth</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p198302471983">Long</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="swr_02_0045__en-us_topic_0000001185914352_p88307470814">User permissions. <strong id="swr_02_0045__en-us_topic_0000001185914352_b20779103853511">7</strong>: manage. <strong id="swr_02_0045__en-us_topic_0000001185914352_b177933883515">3</strong>: edit. <strong id="swr_02_0045__en-us_topic_0000001185914352_b8779123815350">1</strong>: read.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section7830647283"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="swr_02_0045__en-us_topic_0000001185914352_screen78301347181">GET https://{endpoint}/v2/manage/namespaces/{namespace}/access</pre>
</div>
<div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section148300475814"><h4 class="sectiontitle">Example Response</h4><p id="swr_02_0045__en-us_topic_0000001185914352_p1083017475813"><strong id="swr_02_0045__en-us_topic_0000001185914352_b1701161290111033">Status code: 200</strong></p>
<p id="swr_02_0045__en-us_topic_0000001185914352_p183044713810">Query succeeded.</p>
<pre class="screen" id="swr_02_0045__en-us_topic_0000001185914352_screen11831947382">{
"id" : 1422,
"name" : "test",
"creator_name" : "user01",
"self_auth" : {
"user_id" : "3059e6b5562241fda3fa441cca6f228b",
"user_name" : "user",
"auth" : 7
},
"others_auths" : [ {
"user_id" : "fb3f175c1fd146ab8cdae3272be6107b",
"user_name" : "user01",
"auth" : 7
} ]
}</pre>
</div>
<div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section15831847288"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="swr_02_0045__en-us_topic_0000001185914352_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="swr_02_0045__en-us_topic_0000001185914352_row1883113471812"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="swr_02_0045__en-us_topic_0000001185914352_p9832134717810">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_0045__en-us_topic_0000001185914352_p128321347982">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="swr_02_0045__en-us_topic_0000001185914352_row108311747280"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p158326475816">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p483213473815">Query succeeded.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row18831747785"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p148321847289">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p983210471285">Request error.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row683118479815"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p20832847985">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p148321447885">Authentication failed.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row683113479811"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p2083214720815">404</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p17832144714818">Organization not found.</p>
</td>
</tr>
<tr id="swr_02_0045__en-us_topic_0000001185914352_row9831174718811"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="swr_02_0045__en-us_topic_0000001185914352_p1283294716812">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="swr_02_0045__en-us_topic_0000001185914352_p5832144713810">Internal error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="swr_02_0045__en-us_topic_0000001185914352_section15832447589"><h4 class="sectiontitle">Error Codes</h4><p id="swr_02_0045__en-us_topic_0000001185914352_p4832164716819">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_0090.html">Organization Permission Management</a></div>
</div>
</div>