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>
116 lines
10 KiB
HTML
116 lines
10 KiB
HTML
<a name="iam_02_0015"></a><a name="iam_02_0015"></a>
|
|
|
|
<h1 class="topictitle1">Deleting a Custom Policy</h1>
|
|
<div id="body8662426"><div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section8253854104110"><h4 class="sectiontitle">Function</h4><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p172541054104117">This API is provided for the administrator to delete a custom policy.</p>
|
|
<p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p32551354134116">The API can be called using both the global endpoint and region-specific endpoints.</p>
|
|
</div>
|
|
<div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section5256155417415"><h4 class="sectiontitle">URI</h4><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p12257195434110">DELETE /v3.0/OS-ROLE/roles/{role_id}</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_table9258125412417" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row16257154134115"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p22581654114120">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.2.3.2.5.1.2"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p125945418419">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p122601854184118">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.2.3.2.5.1.4"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p19261175417410">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row13257654104111"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p7261165418417">role_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.5.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1262205419416">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p426316548410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.2.3.2.5.1.4 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p162645546416">Custom policy ID. For details about how to obtain a custom policy ID, see <a href="iam_02_0011.html">Custom Policy ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section426415415414"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the request header</caption><thead align="left"><tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row426595420415"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p6267454144115">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p2026715414418">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.3.2.2.5.1.3"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1268154164117">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.2.5.1.4"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p12269754154111">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row1265105417412"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p127045413414">Content-Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p17271165419416">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.2.2.5.1.3 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p4271354114115">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.2.5.1.4 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p2272145415413">Fill <strong id="iam_02_0015__en-us_topic_0222393175_b1359718718400">application/json;charset=utf8</strong> in this field.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row7265454194118"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p127355494119">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1273145404110">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.2.2.5.1.3 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p5274254104118">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.2.5.1.4 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1527515474114">Token with <strong id="iam_02_0015__b106782819469">Security Administrator</strong> permissions.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section1027513548416"><h4 class="sectiontitle">Response Parameters</h4><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1427611548415">None</p>
|
|
</div>
|
|
<div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section10277175484115"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_screen5278115424119">DELETE https://<em id="iam_02_0015__i563814316249"></em>iam.eu-de.otc.t-systems.com/v3.0/OS-ROLE/roles/{role_id}</pre>
|
|
</div>
|
|
<div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section1027995464118"><h4 class="sectiontitle">Example Response</h4><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p14280125416411">None</p>
|
|
</div>
|
|
<div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section1428111548414"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_table287" frame="border" border="1" rules="all"><thead align="left"><tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row10282175413413"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1428435415418">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_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p22848541410">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row17283135454116"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p172856544418">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p828625424113">The custom policy is deleted successfully.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row7283175454111"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p12286115412413">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p2287454104117">The server failed to process the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row132833546415"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1128815494115">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p162888543412">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row1928316544412"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p11289165410416">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p15290135494119">Access denied.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_row1728310542410"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1529019542411">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1329155474114">Internal server error.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_section829219543416"><h4 class="sectiontitle">Error Codes</h4><p id="iam_02_0015__en-us_topic_0222393175_en-us_topic_0222037462_p1729275411415">None</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="iam_02_0010.html">Custom Policy Management</a></div>
|
|
</div>
|
|
</div>
|
|
|