doc-exports/docs/iam/api-ref/iam_10_0012.html
Wei, Hongmin 80f18fd272 IAM API 2.6 Version
Reviewed-by: Kabai, Zoltán Gábor <zoltan-gabor.kabai@t-systems.com>
Co-authored-by: Wei, Hongmin <weihongmin1@huawei.com>
Co-committed-by: Wei, Hongmin <weihongmin1@huawei.com>
2023-08-03 03:34:59 +00:00

120 lines
9.9 KiB
HTML

<a name="iam_10_0012"></a><a name="iam_10_0012"></a>
<h1 class="topictitle1">Checking Whether a User Group Has Specified Permissions for All Projects</h1>
<div id="body32001227"><div class="section" id="iam_10_0012__en-us_topic_0289135719_section1710519546497"><h4 class="sectiontitle">Function</h4><p id="iam_10_0012__en-us_topic_0289135719_p199701225195415">This API is provided for the administrator to check whether a user group has specified permissions for all projects.</p>
</div>
<div class="section" id="iam_10_0012__en-us_topic_0289135719_section1010805419491"><h4 class="sectiontitle">URI</h4><p id="iam_10_0012__en-us_topic_0289135719_p317115542492">HEAD /v3/OS-INHERIT/domains/{domain_id}/groups/{group_id}/roles/{role_id}/inherited_to_projects</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_10_0012__en-us_topic_0289135719_table12108554184918" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="iam_10_0012__en-us_topic_0289135719_row1417145416498"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="iam_10_0012__en-us_topic_0289135719_p2171165418493">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="iam_10_0012__en-us_topic_0289135719_p191725545495">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="iam_10_0012__en-us_topic_0289135719_p131721454174919">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="iam_10_0012__en-us_topic_0289135719_p10172954114919">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="iam_10_0012__en-us_topic_0289135719_row151721854114915"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p4172754154913">domain_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p17172195418492">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="iam_10_0012__en-us_topic_0289135719_p1417245418491">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="iam_10_0012__en-us_topic_0289135719_p14172185494915">Domain ID. For details about how to obtain the ID, see <a href="en-us_topic_0057845624.html">Obtaining User, Account, User Group, Project, and Agency Information</a>.</p>
</td>
</tr>
<tr id="iam_10_0012__en-us_topic_0289135719_row31728545499"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p1217216545497">group_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p0172154124915">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="iam_10_0012__en-us_topic_0289135719_p161726548494">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="iam_10_0012__en-us_topic_0289135719_p17172175415499">User group ID. For details about how to obtain a user group ID, see <a href="en-us_topic_0057845624.html">Obtaining User, Account, User Group, Project, and Agency Information</a>.</p>
</td>
</tr>
<tr id="iam_10_0012__en-us_topic_0289135719_row1717218546491"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p10172185484915">role_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p1917275414917">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="iam_10_0012__en-us_topic_0289135719_p817245419497">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="iam_10_0012__en-us_topic_0289135719_p117295415492">Permission ID. For details about how to obtain a permission ID, see <a href="en-us_topic_0057845591.html">Querying a Role List</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="iam_10_0012__en-us_topic_0289135719_section212013546494"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_10_0012__en-us_topic_0289135719_table17120554164913" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the request header</caption><thead align="left"><tr id="iam_10_0012__en-us_topic_0289135719_row317214547499"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="iam_10_0012__en-us_topic_0289135719_p317295434911">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="iam_10_0012__en-us_topic_0289135719_p1717265424917">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="iam_10_0012__en-us_topic_0289135719_p217205412497">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="iam_10_0012__en-us_topic_0289135719_p15172165415498">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="iam_10_0012__en-us_topic_0289135719_row151723545499"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p1217216545494">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p161723547491">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="iam_10_0012__en-us_topic_0289135719_p9172125412491">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="iam_10_0012__en-us_topic_0289135719_p1646215138496">Token with <strong id="iam_10_0012__en-us_topic_0289135719_b57393393526">Security Administrator</strong> permissions.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="iam_10_0012__en-us_topic_0289135719_section14123105414494"><h4 class="sectiontitle">Response Parameters</h4><p id="iam_10_0012__en-us_topic_0289135719_p1017245410491">None</p>
</div>
<div class="section" id="iam_10_0012__en-us_topic_0289135719_section131235544498"><h4 class="sectiontitle">Example Request</h4><p id="iam_10_0012__en-us_topic_0289135719_p276405651912">Request for checking whether a user group has specified permissions for all projects</p>
<pre class="screen" id="iam_10_0012__en-us_topic_0289135719_screen9203181311113">HEAD https://<span id="iam_10_0012__en-us_topic_0289135719_text715321191316"></span>sample.domain.com/v3/OS-INHERIT/domains/{domain_id}/groups/{group_id}/roles/{role_id}/inherited_to_projects</pre>
</div>
<div class="section" id="iam_10_0012__en-us_topic_0289135719_section121232549497"><h4 class="sectiontitle">Example Response</h4><p id="iam_10_0012__en-us_topic_0289135719_p121721754144912">None</p>
</div>
<div class="section" id="iam_10_0012__en-us_topic_0289135719_section112415434918"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_10_0012__en-us_topic_0289135719_table71242054154910" frame="border" border="1" rules="all"><thead align="left"><tr id="iam_10_0012__en-us_topic_0289135719_row0172454194913"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="iam_10_0012__en-us_topic_0289135719_p6172155417495">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="iam_10_0012__en-us_topic_0289135719_p111727540491">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="iam_10_0012__en-us_topic_0289135719_row1172185416491"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p17172254154914">204</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p71721454174916">The request is successful.</p>
</td>
</tr>
<tr id="iam_10_0012__en-us_topic_0289135719_row1517225454919"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p61721254144917">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p7172754104916">Authentication failed.</p>
</td>
</tr>
<tr id="iam_10_0012__en-us_topic_0289135719_row1817265417499"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p1017285404919">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p3172115404915">Access denied.</p>
</td>
</tr>
<tr id="iam_10_0012__en-us_topic_0289135719_row5172554184914"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_10_0012__en-us_topic_0289135719_p121721054124917">404</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_10_0012__en-us_topic_0289135719_p131721454184917">The server could not find the requested page.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="iam_10_0012__en-us_topic_0289135719_section131279543492"><h4 class="sectiontitle">Error Codes</h4><p id="iam_10_0012__en-us_topic_0289135719_p61728542493">For details, see <a href="iam_02_0006.html#iam_02_0006">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0057845579.html">Permission Management</a></div>
</div>
</div>