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>
139 lines
12 KiB
HTML
139 lines
12 KiB
HTML
<a name="en-us_topic_0079467622"></a><a name="en-us_topic_0079467622"></a>
|
|
|
|
<h1 class="topictitle1">Deleting Permissions of an Agency on a Domain</h1>
|
|
<div id="body1507708722960"><div class="section" id="en-us_topic_0079467622__s6f06ea3136194d5980c38c9e94e76e43"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0079467622__p142831240121410">This API is used to delete permissions of an agency on a domain.</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0079467622__sde73940d763d4ed4b4d1566baadf9d85"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0079467622__ua44b37d4c7c84ad5b9abfe384f943295"><li id="en-us_topic_0079467622__lc6b0622cedb1492bb0c72b1437579522">URI format<p id="en-us_topic_0079467622__a8ea02d5af0c44d8390342f56326e3ddc"><a name="en-us_topic_0079467622__lc6b0622cedb1492bb0c72b1437579522"></a><a name="lc6b0622cedb1492bb0c72b1437579522"></a>DELETE /v3.0/OS-AGENCY/domains/{domain_id}/agencies/{agency_id}/roles/{role_id}</p>
|
|
</li></ul>
|
|
<ul id="en-us_topic_0079467622__ucd1940ab8cef42e1beba70e2b01ce609"><li id="en-us_topic_0079467622__lf982cd871f654da4b1a54b042bd83d26">URI parameters
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0079467622__t277db3937ec44018ae523cc5da8818d8" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0079467622__rb4e7210075f145ac84669dc503689294"><th align="left" class="cellrowborder" valign="top" width="18.360000000000003%" id="mcps1.3.2.3.1.1.1.5.1.1"><p id="en-us_topic_0079467622__ad371ce458f1244ea8c7458487dc8af55"><strong id="en-us_topic_0079467622__a173ae121cc9e48328ca613e72f2a1504">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.48%" id="mcps1.3.2.3.1.1.1.5.1.2"><p id="en-us_topic_0079467622__aa463e4b491154da0b1dc5f62f8608ccf"><strong id="en-us_topic_0079467622__b842352706161940">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.86%" id="mcps1.3.2.3.1.1.1.5.1.3"><p id="en-us_topic_0079467622__a2ac8ad8d4ac94d91a5b44e16e110491e"><strong id="en-us_topic_0079467622__b842352706143526">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="44.3%" id="mcps1.3.2.3.1.1.1.5.1.4"><p id="en-us_topic_0079467622__a1c9e46cc774349958fb38337961ce374"><strong id="en-us_topic_0079467622__b20601766145329">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0079467622__rec49bc11993744319f9a4ad52b184cf5"><td class="cellrowborder" valign="top" width="18.360000000000003%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="en-us_topic_0079467622__aa05127e1e7bc44de8c35c1b0e0682bfe">domain_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.48%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="en-us_topic_0079467622__ad93d14c9f4024916b03099716217cf93">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="en-us_topic_0079467622__a368b531a10f341fab3642f36a78e5d59">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.3%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="en-us_topic_0079467622__abf4c3ff71b7d4097a42ad181082acf68">ID of the current domain.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0079467622__rf8fbe4fd025142daadab1f5f2592fdbc"><td class="cellrowborder" valign="top" width="18.360000000000003%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="en-us_topic_0079467622__a3017b564242c447aa5a7f5f49aba1b8d">agency_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.48%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="en-us_topic_0079467622__aec63f5510722406480484e1015bfbe2e">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="en-us_topic_0079467622__ac0e14d37c0cd470f8200076785f8d39e">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.3%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="en-us_topic_0079467622__a64096589e0dc4ca0b740ecf464431b6a">ID of an agency.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0079467622__r1bbd85e74bc24ef98727452e474dc208"><td class="cellrowborder" valign="top" width="18.360000000000003%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="en-us_topic_0079467622__af9bd81b465a54565b6ded7b7b84899e6">role_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.48%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="en-us_topic_0079467622__a8c27c166011e4696a65e46daaac74f58">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="en-us_topic_0079467622__a56a5abedea034ac8b9ede5b938c784df">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.3%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="en-us_topic_0079467622__abf1501bee8d4416e8d987e5c121c434a">ID of a role.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0079467622__s7c597b2b51204de7923233e29aeb797b"><h4 class="sectiontitle">Request Parameters</h4><ul id="en-us_topic_0079467622__u1e403d534ebe45bf89c1d3e965effc31"><li id="en-us_topic_0079467622__l3962c15bad6347a3972943d66ba1f15f">Parameters in the request header
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0079467622__tc0fa7c1a50904b1f89d17044cd5c7a69" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0079467622__r5c7ba6eda36a4b26892f6d4780a4b508"><th align="left" class="cellrowborder" valign="top" width="19.36%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="en-us_topic_0079467622__ad460645e55244613b94da7e13ec04d03"><strong id="en-us_topic_0079467622__b60153559144451">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.26%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="en-us_topic_0079467622__a6e13910b05c24dd2bea36eff98ef7839"><strong id="en-us_topic_0079467622__b1730877278">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.93%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="en-us_topic_0079467622__afa6d24c1310e471795557934ef86fe8e"><strong id="en-us_topic_0079467622__b742002974">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="44.45%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="en-us_topic_0079467622__a41880dbeb61d48aa88c6e6908721f525"><strong id="en-us_topic_0079467622__b1671339121">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0079467622__r9d91939c095344fe8e42ab6cfc3db6c1"><td class="cellrowborder" valign="top" width="19.36%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="en-us_topic_0079467622__a381351d3e33f4051b3f3cf5533cdcdbc">Content-Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.26%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="en-us_topic_0079467622__a0be7cea5e82549eb8e7c0f934aa5e988">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.93%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="en-us_topic_0079467622__a4f0b0fa7ffb14c368580ad35ea5eb785">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.45%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="en-us_topic_0079467622__ad5ceecf431b34d40ba3dc9df81ec800c">Fill <strong id="en-us_topic_0079467622__b842352706161331">application/json;charset=utf8</strong> in this field.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0079467622__ra0471ded40a146fd952f8037548cf080"><td class="cellrowborder" valign="top" width="19.36%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="en-us_topic_0079467622__a3295a62ea2304089b03307c76e466c6f">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.26%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="en-us_topic_0079467622__a3d71cbe3689240fba41d597cc7f85e6d">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.93%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="en-us_topic_0079467622__a9648d928937441a581b1923660597eb6">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.45%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="en-us_topic_0079467622__a1602030331024f6d9061c82cfaca200a">Authenticated token with the <strong id="en-us_topic_0079467622__b750798910387">Security Administrator</strong> permission.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="en-us_topic_0079467622__u2d7ce26564ca4e599a26b07997820b55"><li id="en-us_topic_0079467622__l56e70911a33c4280bee3ec04b6305527">Example request<pre class="screen" id="en-us_topic_0079467622__sd4e447b19aac4757a2926a6b4962da08"><em id="en-us_topic_0079467622__i46469028111210">curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X DELETE https://</em><em id="en-us_topic_0079467622__i12619765111210">sample.domain.com</em><em id="en-us_topic_0079467622__i32947714111226">/v3<em id="en-us_topic_0079467622__i528751412550">.0/OS-AGENCY</em>/domains/<em id="en-us_topic_0079467622__en-us_topic_0059029106_i83131161557">b32d99a7778d4fd9aa5bc616c3dc4e5f</em>/agencies/37f90258b820472bbc8a0f4f0bfd720d/roles/0f3a2d418ed747fa8be46e92757be9ff</em></pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0079467622__s2efeb64f5f17479ea6c3fdef5593e8fb"><h4 class="sectiontitle">Response Parameters</h4><ul id="en-us_topic_0079467622__u8eebcf4e6b4d4576ad2f87e2f9f8525b"><li id="en-us_topic_0079467622__l6c042fa0816245989f89cb3728cdac3b">Example response (request failed)<pre class="screen" id="en-us_topic_0079467622__sead4e8ec7abe4586a5ba2e246ac65ffc">{
|
|
"error" : {
|
|
"message" : "Could not find role: 0f3a2d418ed747fa8be46e92757be9ddff",
|
|
"code" : 404,
|
|
"title" : "Not Found"
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0079467622__s52a4cdf70d764312a274df0668ad16ed"><h4 class="sectiontitle"><strong id="en-us_topic_0079467622__b842352706183230">Status Codes</strong></h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0079467622__t753d29820c3540d1875d3053d76c7761" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0079467622__rb216d4f58d924585aafa54d9f3553979"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.1"><p id="en-us_topic_0079467622__ac6ea5ba6898e4abf82dba0bcaad485e1"><strong id="en-us_topic_0079467622__b43497138144451">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_0079467622__a27c63c2f8ed44e078a958278afca10e9"><strong id="en-us_topic_0079467622__b1678542920">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0079467622__r3deb47eb460f4bc187d2d8dad503c9ee"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0079467622__a88cdd4bd37104bea9011f934aa8198fe">204</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0079467622__a09e586f6495549379e030d8a67f1b10d">The request is successful.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0079467622__rca43722291a5474f94edc848c4b5b82e"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0079467622__ac6d9bade3f2a4bb48da870d9b00c29be">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0079467622__a9784d8d7b0c847f499be0cc720d8bd85">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0079467622__r0c7454cf24b948779d051733b586207c"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0079467622__a7e5d8761d5424ba7baf7e5909e84a741">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0079467622__a7a4e7387b62a4287af199c5982a96e75">Access denied.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0079467622__r2ea8b8c32c53479f90c5b002ca7049cb"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0079467622__ae1a980fa5bb94fe5aca5c22890fc5402">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0079467622__a12695efccfa848ed8418e32abd45bd1c">The requested resource cannot be found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0079467622__r8734af361e7c4823be67924868676c22"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="en-us_topic_0079467622__a7786f144832e457c9819e26de4a4c791">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="en-us_topic_0079467622__afdafb2c6d31b41d8a27d33b897e5569d">Internal server error.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0079467612.html">Agency Management</a></div>
|
|
</div>
|
|
</div>
|
|
|