From 584d272a0ba95f3b6006345462feeabf0cbce56d Mon Sep 17 00:00:00 2001
From: weihongmin1 <weihongmin1@huawei.com>
Date: Fri, 23 Jan 2026 15:39:37 +0000
Subject: [PATCH] IAM API 0121 Version

Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
---
 docs/iam/api-ref/en-us_topic_0057845583.html | 45 +++++++++++++++-----
 1 file changed, 34 insertions(+), 11 deletions(-)

diff --git a/docs/iam/api-ref/en-us_topic_0057845583.html b/docs/iam/api-ref/en-us_topic_0057845583.html
index 4a82027a1..a2887986f 100644
--- a/docs/iam/api-ref/en-us_topic_0057845583.html
+++ b/docs/iam/api-ref/en-us_topic_0057845583.html
@@ -8,6 +8,29 @@
 </div></div>
 </div>
 <div class="section" id="en-us_topic_0057845583__s46d3616bd4c54e55ba97a528518a5890"><h4 class="sectiontitle">URI</h4><p id="en-us_topic_0057845583__a80e962a80e7749d3b159c2c7380021bf">POST /v3/auth/tokens</p>
+
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__en-us_topic_0221482385_table166116614206" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Query parameters</caption><thead align="left"><tr id="en-us_topic_0057845583__en-us_topic_0221482385_row26614618203"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="en-us_topic_0057845583__en-us_topic_0221482385_p1966196192018">Parameter</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.2.3.2.5.1.2"><p id="en-us_topic_0057845583__en-us_topic_0221482385_p1166119662017">Mandatory</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="en-us_topic_0057845583__en-us_topic_0221482385_p16662661205">Type</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.2.3.2.5.1.4"><p id="en-us_topic_0057845583__en-us_topic_0221482385_p1666211612204">Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0057845583__en-us_topic_0221482385_row26618652012"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="en-us_topic_0057845583__en-us_topic_0221482385_p1666214616202">nocatalog</p>
+</td>
+<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.5.1.2 "><p id="en-us_topic_0057845583__en-us_topic_0221482385_p116627618205">No</p>
+</td>
+<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="en-us_topic_0057845583__en-us_topic_0221482385_p146620672020">String</p>
+</td>
+<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.2.3.2.5.1.4 "><p id="en-us_topic_0057845583__en-us_topic_0221482385_p176621662202">If this parameter is set, no catalog information will be displayed in the response. Any non-empty string for this parameter will be interpreted as <strong id="en-us_topic_0057845583__b1995812465270">true</strong> and no catalog information will be displayed.</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
 </div>
 <div class="section" id="en-us_topic_0057845583__se7fe5cac0d544e119c49322cc1707eb6"><h4 class="sectiontitle">Request Parameters</h4><ul id="en-us_topic_0057845583__en-us_topic_0026585112_ul3226198"><li id="en-us_topic_0057845583__l7c4919f55ea849a9bb59e1454113085c">Parameters in the request header
 <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__t68c7bd10e66a4380a1e6cdc78ca95669" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0057845583__r584496594a404ce18918a40e6e57c2ec"><th align="left" class="cellrowborder" valign="top" width="17.818218178182182%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="en-us_topic_0057845583__ac3a989cc5d3a405889eabb47dee84b04">Parameter</p>
@@ -363,7 +386,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table025592415478" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in the response body</caption><thead align="left"><tr id="en-us_topic_0057845583__row8301112494715"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="en-us_topic_0057845583__p1030122417475">Parameter</p>
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table025592415478" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the response body</caption><thead align="left"><tr id="en-us_topic_0057845583__row8301112494715"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="en-us_topic_0057845583__p1030122417475">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="en-us_topic_0057845583__p19301172494718">Type</p>
 </th>
@@ -382,7 +405,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table14259024204717"></a><a name="table14259024204717"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table14259024204717" frame="border" border="1" rules="all"><caption><b>Table 2 </b>token</caption><thead align="left"><tr id="en-us_topic_0057845583__row930102474717"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="en-us_topic_0057845583__p10301324124718">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table14259024204717"></a><a name="table14259024204717"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table14259024204717" frame="border" border="1" rules="all"><caption><b>Table 3 </b>token</caption><thead align="left"><tr id="en-us_topic_0057845583__row930102474717"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="en-us_topic_0057845583__p10301324124718">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.4.1.2"><p id="en-us_topic_0057845583__p9301142424717">Type</p>
 </th>
@@ -502,7 +525,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table18263824174719"></a><a name="table18263824174719"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table18263824174719" frame="border" border="1" rules="all"><caption><b>Table 3 </b>token.catalog</caption><thead align="left"><tr id="en-us_topic_0057845583__row1030212454710"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.4.2.4.1.1"><p id="en-us_topic_0057845583__p6302142424716">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table18263824174719"></a><a name="table18263824174719"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table18263824174719" frame="border" border="1" rules="all"><caption><b>Table 4 </b>token.catalog</caption><thead align="left"><tr id="en-us_topic_0057845583__row1030212454710"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.4.2.4.1.1"><p id="en-us_topic_0057845583__p6302142424716">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.4.2.4.1.2"><p id="en-us_topic_0057845583__p43023241471">Type</p>
 </th>
@@ -542,7 +565,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table13263152454713"></a><a name="table13263152454713"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table13263152454713" frame="border" border="1" rules="all"><caption><b>Table 4 </b>token.catalog.endpoints</caption><thead align="left"><tr id="en-us_topic_0057845583__row530362434718"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.5.2.4.1.1"><p id="en-us_topic_0057845583__p12303102420473">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table13263152454713"></a><a name="table13263152454713"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table13263152454713" frame="border" border="1" rules="all"><caption><b>Table 5 </b>token.catalog.endpoints</caption><thead align="left"><tr id="en-us_topic_0057845583__row530362434718"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.5.2.4.1.1"><p id="en-us_topic_0057845583__p12303102420473">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.5.2.4.1.2"><p id="en-us_topic_0057845583__p12303924154712">Type</p>
 </th>
@@ -589,7 +612,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table52641724184711"></a><a name="table52641724184711"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table52641724184711" frame="border" border="1" rules="all"><caption><b>Table 5 </b>token.domain</caption><thead align="left"><tr id="en-us_topic_0057845583__row330322434714"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.6.2.4.1.1"><p id="en-us_topic_0057845583__p1430313242473">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table52641724184711"></a><a name="table52641724184711"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table52641724184711" frame="border" border="1" rules="all"><caption><b>Table 6 </b>token.domain</caption><thead align="left"><tr id="en-us_topic_0057845583__row330322434714"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.6.2.4.1.1"><p id="en-us_topic_0057845583__p1430313242473">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.6.2.4.1.2"><p id="en-us_topic_0057845583__p1030382404715">Type</p>
 </th>
@@ -615,7 +638,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table4265182419474"></a><a name="table4265182419474"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table4265182419474" frame="border" border="1" rules="all"><caption><b>Table 6 </b>token.project</caption><thead align="left"><tr id="en-us_topic_0057845583__row33032247470"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.7.2.4.1.1"><p id="en-us_topic_0057845583__p83031624154714">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table4265182419474"></a><a name="table4265182419474"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table4265182419474" frame="border" border="1" rules="all"><caption><b>Table 7 </b>token.project</caption><thead align="left"><tr id="en-us_topic_0057845583__row33032247470"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.7.2.4.1.1"><p id="en-us_topic_0057845583__p83031624154714">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.7.2.4.1.2"><p id="en-us_topic_0057845583__p230316242475">Type</p>
 </th>
@@ -648,7 +671,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table126517242479" frame="border" border="1" rules="all"><caption><b>Table 7 </b>token.project.domain</caption><thead align="left"><tr id="en-us_topic_0057845583__row133031924174716"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.8.2.4.1.1"><p id="en-us_topic_0057845583__p17303152434716">Parameter</p>
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table126517242479" frame="border" border="1" rules="all"><caption><b>Table 8 </b>token.project.domain</caption><thead align="left"><tr id="en-us_topic_0057845583__row133031924174716"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.8.2.4.1.1"><p id="en-us_topic_0057845583__p17303152434716">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.8.2.4.1.2"><p id="en-us_topic_0057845583__p153031824184718">Type</p>
 </th>
@@ -674,7 +697,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table1526632404711"></a><a name="table1526632404711"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table1526632404711" frame="border" border="1" rules="all"><caption><b>Table 8 </b>token.roles</caption><thead align="left"><tr id="en-us_topic_0057845583__row03041424134720"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.9.2.4.1.1"><p id="en-us_topic_0057845583__p1630411243471">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table1526632404711"></a><a name="table1526632404711"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table1526632404711" frame="border" border="1" rules="all"><caption><b>Table 9 </b>token.roles</caption><thead align="left"><tr id="en-us_topic_0057845583__row03041424134720"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.9.2.4.1.1"><p id="en-us_topic_0057845583__p1630411243471">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.9.2.4.1.2"><p id="en-us_topic_0057845583__p183041424204717">Type</p>
 </th>
@@ -700,7 +723,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table926722417478"></a><a name="table926722417478"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table926722417478" frame="border" border="1" rules="all"><caption><b>Table 9 </b>token.user</caption><thead align="left"><tr id="en-us_topic_0057845583__row123042245473"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.10.2.4.1.1"><p id="en-us_topic_0057845583__p20304172454713">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table926722417478"></a><a name="table926722417478"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table926722417478" frame="border" border="1" rules="all"><caption><b>Table 10 </b>token.user</caption><thead align="left"><tr id="en-us_topic_0057845583__row123042245473"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.10.2.4.1.1"><p id="en-us_topic_0057845583__p20304172454713">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.10.2.4.1.2"><p id="en-us_topic_0057845583__p1530482424712">Type</p>
 </th>
@@ -740,7 +763,7 @@
 </table>
 </div>
 
-<div class="tablenoborder"><a name="en-us_topic_0057845583__table202681724204710"></a><a name="table202681724204710"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table202681724204710" frame="border" border="1" rules="all"><caption><b>Table 10 </b>token.user.domain</caption><thead align="left"><tr id="en-us_topic_0057845583__row163041224124713"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.11.2.4.1.1"><p id="en-us_topic_0057845583__p1530416244474">Parameter</p>
+<div class="tablenoborder"><a name="en-us_topic_0057845583__table202681724204710"></a><a name="table202681724204710"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057845583__table202681724204710" frame="border" border="1" rules="all"><caption><b>Table 11 </b>token.user.domain</caption><thead align="left"><tr id="en-us_topic_0057845583__row163041224124713"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.11.2.4.1.1"><p id="en-us_topic_0057845583__p1530416244474">Parameter</p>
 </th>
 <th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.11.2.4.1.2"><p id="en-us_topic_0057845583__p230482494713">Type</p>
 </th>
@@ -765,7 +788,7 @@
 </tbody>
 </table>
 </div>
-</li><li id="en-us_topic_0057845583__lf3c28402a2ee4844bc99946ea67bf82d">Example response<div class="p" id="en-us_topic_0057845583__p01640289481"><a name="en-us_topic_0057845583__lf3c28402a2ee4844bc99946ea67bf82d"></a><a name="lf3c28402a2ee4844bc99946ea67bf82d"></a>The following is a sample request for obtaining a token for <strong id="en-us_topic_0057845583__b120321378">user A</strong>. The login password of the user is <strong id="en-us_topic_0057845583__b1209131242">**********</strong> and the domain name is <strong id="en-us_topic_0057845583__b1525316830">domain A</strong>. The scope of the token is <strong id="en-us_topic_0057845583__b2065719361">domain</strong>.<pre class="screen" id="en-us_topic_0057845583__screen0241121164815">Token information stored in the response header:
+</li><li id="en-us_topic_0057845583__lf3c28402a2ee4844bc99946ea67bf82d">Example response<div class="p" id="en-us_topic_0057845583__p01640289481"><a name="en-us_topic_0057845583__lf3c28402a2ee4844bc99946ea67bf82d"></a><a name="lf3c28402a2ee4844bc99946ea67bf82d"></a>The following is a sample request for obtaining a token for <strong id="en-us_topic_0057845583__b2084782396">user A</strong>. The login password of the user is <strong id="en-us_topic_0057845583__b1581073947">**********</strong> and the domain name is <strong id="en-us_topic_0057845583__b762935778">domain A</strong>. The scope of the token is <strong id="en-us_topic_0057845583__b1775867536">domain</strong>.<pre class="screen" id="en-us_topic_0057845583__screen0241121164815">Token information stored in the response header:
 X-Subject-Token:MIIDkgYJKoZIhvcNAQcCoIIDgzCCA38CAQExDTALBglghkgBZQMEAgEwgXXXXX...
 
 Token information stored in the response body: