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>
94 lines
7.4 KiB
HTML
94 lines
7.4 KiB
HTML
<a name="iam_02_0063"></a><a name="iam_02_0063"></a>
|
|
|
|
<h1 class="topictitle1">Deleting a User Token</h1>
|
|
<div id="body1559182165062"><div class="section" id="iam_02_0063__s2f7665a32abf4492987e6dd3617bcb21"><h4 class="sectiontitle">Function</h4><p id="iam_02_0063__affc0cd1844644279ac4dd958af66b459">This API is used to delete a token no matter whether the token has expired or not.</p>
|
|
</div>
|
|
<div class="section" id="iam_02_0063__s1c0fd353ed38459c8baeab25cc3c62d2"><h4 class="sectiontitle">URI</h4><p id="iam_02_0063__p47072595171737">DELETE /v3/auth/tokens</p>
|
|
</div>
|
|
<div class="section" id="iam_02_0063__s27bb6347561e424096c86cfc3d036e9e"><h4 class="sectiontitle">Request Parameters</h4><ul id="iam_02_0063__u6f48fb0c8ad9498dad047c260e363a64"><li id="iam_02_0063__l19a56023fd914b7dbfe3816275474144">Parameters in the request header
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_02_0063__t14a8c0fedd2149129bd965b2a4d51c90" frame="border" border="1" rules="all"><thead align="left"><tr id="iam_02_0063__rc0444c4b152b43768b629e845d90495e"><th align="left" class="cellrowborder" valign="top" width="19.038096190380962%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="iam_02_0063__a293da93d33fc404ea05b069800a7eb13">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.578242175782425%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="iam_02_0063__ac06ad3b3b5174f3ebd57a1661506970a">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.75832416758324%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="iam_02_0063__a924a03bda76a46648797189b78bdd715">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="46.62533746625338%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="iam_02_0063__ab17a839c16b94f1e83ff3a3f8ef3b308">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="iam_02_0063__r6f5a057d2e2a48b6b1a71318684ba8b5"><td class="cellrowborder" valign="top" width="19.038096190380962%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="iam_02_0063__a927ddf565a2f45c0840a6e4ef3eab536">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.578242175782425%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="iam_02_0063__a4edeb0b0c00144319701c1460d210ea8">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.75832416758324%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="iam_02_0063__a17c7fa87e9a54833a6064feb297b5e55">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.62533746625338%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="iam_02_0063__p1821614196437">Obtained token.</p>
|
|
<ul id="iam_02_0063__ul1963814299291"><li id="iam_02_0063__li176391829162917">To delete your own token, specify your token. There are no special requirements on the permissions that your token must have.</li><li id="iam_02_0063__li11639192962916">To delete the token of another user under the same domain, use a token that has permissions of the <strong id="iam_02_0063__b1524464910379">Security Administrator</strong> policy.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0063__r4ebaddfb83fe4bffa462094cc2834cf2"><td class="cellrowborder" valign="top" width="19.038096190380962%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="iam_02_0063__ae9df07c230354205b9c3cb76f08eadb4">X-Subject-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.578242175782425%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="iam_02_0063__a1100e03a09864240abecdff29c388bf8">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.75832416758324%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="iam_02_0063__a667fee7780224b0d9e78b40c59beaccf">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.62533746625338%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="iam_02_0063__a3e67d6bcffd14d9cbbe0fbad423e13de">Token to be deleted.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="iam_02_0063__l8e4285d4fa9a436db2f75be29fe6c522">Example request<pre class="screen" id="iam_02_0063__s4e1093936ad24a10a794355debb4aa19"><em id="iam_02_0063__i159431711132820">curl -i -k -H "X-Auth-Token:$token" -H "X-Subject-Token:$token" -X DELETE https://sample.domain.com/v3/auth/tokens</em></pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="iam_02_0063__section2098793814412"><h4 class="sectiontitle">Response Parameters</h4><p id="iam_02_0063__p17332104074411">None</p>
|
|
</div>
|
|
<div class="section" id="iam_02_0063__s5f49b0a31dfd4c0ba72af9d16199f092"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="iam_02_0063__en-us_topic_0031136109_table25927028" frame="border" border="1" rules="all"><thead align="left"><tr id="iam_02_0063__en-us_topic_0031136109_row10578662"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.1"><p id="iam_02_0063__en-us_topic_0031136109_p51565323">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.2.1.3.1.2"><p id="iam_02_0063__en-us_topic_0031136109_p16041657">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="iam_02_0063__en-us_topic_0031136109_row43909159"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="iam_02_0063__ac58be25dfe6c4aaf9db2b9a3d7fbabca">204</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="iam_02_0063__a6e2de6a7a37947b5aef6f82b48011a03">The request is successful.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0063__r7fc6a01de7944676924285967a1e5bc8"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="iam_02_0063__ae582169a40d14518b8b1c9e774696af6">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="iam_02_0063__a01d650708f044356a0e8711abade8518">The server failed to process the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0063__en-us_topic_0031136109_row41000636"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="iam_02_0063__aa1436dc96eeb4ecba5f1a6cf55c4e96d">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="iam_02_0063__a3c42a75c98a04c7b9efffdbcd6a0442b">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0063__rbe3685e5aeff47eb990a671b5857c0c7"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="iam_02_0063__a3147c9b90baa43c8ad749a408a6d9b20">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="iam_02_0063__ae8403ffe26014f779b51914498b2335b">Access denied.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0063__re1fee93942c94c99adf7dd268d6bc21c"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="iam_02_0063__a9b3726f2a0fd4e9c99679f1f64a01170">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="iam_02_0063__a6fff1dadf47d4a6fb59c6e4274ffd613">The requested resource cannot be found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="iam_02_0063__rd595ecff1f1047e9bd258da07fd41c0a"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.1 "><p id="iam_02_0063__a1ab42a838d1c473f967bbd05e9634618">503</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.2.1.3.1.2 "><p id="iam_02_0063__aedeaace596704f93813419fae71746d7">Service unavailable.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0057845626.html">Token Management</a></div>
|
|
</div>
|
|
</div>
|
|
|