forked from docs/doc-exports
zhangyue
3b5a58b1fe
Reviewed-by: gtema <artem.goncharov@gmail.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
122 lines
11 KiB
HTML
122 lines
11 KiB
HTML
<a name="en-us_topic_0057845632"></a><a name="en-us_topic_0057845632"></a>
|
|
|
|
<h1 class="topictitle1">Querying Whether a User Group Under a Domain Has Specific Permissions</h1>
|
|
<div id="body1492670576112"><div class="section" id="en-us_topic_0057845632__section495175389414"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0057845632__p89625527916">This API is used to query whether a specified user group under a domain has specific permissions. A role is a set of permissions and represents a group of actions.</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845632__section3019338085013"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0057845632__en-us_topic_0032920307_ul52733512"><li id="en-us_topic_0057845632__en-us_topic_0032920307_li4839561">URI format<p id="en-us_topic_0057845632__en-us_topic_0032920307_p43556055"><a name="en-us_topic_0057845632__en-us_topic_0032920307_li4839561"></a><a name="en-us_topic_0032920307_li4839561"></a>HEAD /v3/domains/{domain_id}/groups/{group_id}/roles/{role_id}</p>
|
|
</li><li id="en-us_topic_0057845632__li1205595994225">URI parameters
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845632__en-us_topic_0032920307_table36168141" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845632__en-us_topic_0032920307_row15662289"><th align="left" class="cellrowborder" valign="top" width="19.36%" id="mcps1.3.2.2.2.1.1.5.1.1"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p60685926"><strong id="en-us_topic_0057845632__b842352706113951">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.24%" id="mcps1.3.2.2.2.1.1.5.1.2"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p16612996"><strong id="en-us_topic_0057845632__b3635861814">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.580000000000002%" id="mcps1.3.2.2.2.1.1.5.1.3"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p3475410"><strong id="en-us_topic_0057845632__b842352706143526_1">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="43.82%" id="mcps1.3.2.2.2.1.1.5.1.4"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p13072760"><strong id="en-us_topic_0057845632__b20601766145329_1">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845632__en-us_topic_0032920307_row52260639"><td class="cellrowborder" valign="top" width="19.36%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p5253358">domain_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.24%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p22868878">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.580000000000002%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p40439847">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.82%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p54402144">ID of the domain to which a user group belongs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845632__en-us_topic_0032920307_row19857248"><td class="cellrowborder" valign="top" width="19.36%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p64933228">group_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.24%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p25100141">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.580000000000002%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p19845579">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.82%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p63988077">ID of a user group.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845632__row27198525143830"><td class="cellrowborder" valign="top" width="19.36%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="en-us_topic_0057845632__p43460141143830">role_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.24%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="en-us_topic_0057845632__p30610518143830">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.580000000000002%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="en-us_topic_0057845632__p63532892143830">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.82%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="en-us_topic_0057845632__p45890598143830">ID of a role.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845632__section1437107585444"><h4 class="sectiontitle">Request Parameters</h4><ul id="en-us_topic_0057845632__ul3118448103456"><li id="en-us_topic_0057845632__li46500394103456">Parameters in the request header
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845632__en-us_topic_0032920307_table21736211" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845632__en-us_topic_0032920307_row48433347"><th align="left" class="cellrowborder" valign="top" width="19.18808119188081%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p30787047"><strong id="en-us_topic_0057845632__a173ae121cc9e48328ca613e72f2a1504">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.02809719028097%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p10722842"><strong id="en-us_topic_0057845632__b1279710912816">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.558244175582445%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p63243911"><strong id="en-us_topic_0057845632__b842352706143526_3">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="44.225577442255776%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p22483156"><strong id="en-us_topic_0057845632__b20601766145329_3">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845632__en-us_topic_0032920307_row39604502"><td class="cellrowborder" valign="top" width="19.18808119188081%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p53848109">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.02809719028097%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p66729601">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.558244175582445%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p36388601">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.225577442255776%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="en-us_topic_0057845632__p3447931811261">Authenticated token with the <strong id="en-us_topic_0057845632__b750798910387">Security Administrator</strong> permission.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="en-us_topic_0057845632__ul20630048152059"><li id="en-us_topic_0057845632__li1696733152059">Example request<pre class="screen" id="en-us_topic_0057845632__screen34505036152059"><em id="en-us_topic_0057845632__i50053988152059">curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X HEAD https://10.22.44.158:31943/v3/domains/d54061ebcb5145dd814f8eb3fe9b7ac0/groups/47d79cabc2cf4c35b13493d919a5bb3d/roles/e62d9ba0d6a544cd878d9e8a4663f6e2</em></pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845632__section1597654991117"><h4 class="sectiontitle">Response Parameters</h4><p id="en-us_topic_0057845632__p39765494115">None</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057845632__section5556784894735"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845632__en-us_topic_0032920307_table25927028" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845632__en-us_topic_0032920307_row10578662"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.1"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p51565323"><strong id="en-us_topic_0057845632__b4643653491053">Status Code</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.2"><p id="en-us_topic_0057845632__en-us_topic_0032920307_p16041657"><strong id="en-us_topic_0057845632__b20601766145329_5">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057845632__en-us_topic_0032920307_row24305815"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p22613965">204</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p19791876">The request is successful.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845632__en-us_topic_0032920307_row43909159"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p66980994">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p56751409">The server failed to process the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845632__row460808479497"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845632__p120744399497">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845632__p385055099497">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845632__en-us_topic_0032920307_row41000636"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p32717189">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845632__en-us_topic_0032920307_p32846614">Access denied.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057845632__row5922032814523"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0057845632__p6322091114523">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0057845632__p2062019914523">The requested resource cannot be found.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</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>
|
|
|