forked from laiweijian4/doc-exports
Reviewed-by: Kacur, Michal <michal.kacur@t-systems.com> Co-authored-by: Zheng, Xiu <zhengxiu@huawei.com> Co-committed-by: Zheng, Xiu <zhengxiu@huawei.com>
120 lines
8.5 KiB
HTML
120 lines
8.5 KiB
HTML
<a name="ResetPassword"></a><a name="ResetPassword"></a>
|
|
|
|
<h1 class="topictitle1">Changing a Password</h1>
|
|
<div id="body0000001926672489"><div class="section" id="ResetPassword__section5288748579"><h4 class="sectiontitle">Function</h4><p id="ResetPassword__p32884412572">This API is used to change the password of a cluster.</p>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section42899415579"><h4 class="sectiontitle">Calling Method</h4><p id="ResetPassword__p132897415573">For details, see <a href="iam_01_0023.html">Calling APIs</a>.</p>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section92908475711"><h4 class="sectiontitle">URI</h4><p id="ResetPassword__p029018417570">POST /v1.0/{project_id}/clusters/{cluster_id}/password/reset</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ResetPassword__table829284115720" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="ResetPassword__row22914413579"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="ResetPassword__p129220495710">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="ResetPassword__p172937418576">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="ResetPassword__p329315415578">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="ResetPassword__p162938420575">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ResetPassword__row529144105710"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="ResetPassword__p229414445715">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="ResetPassword__p152942048572">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="ResetPassword__p929614185710">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="ResetPassword__p16114201416568">Project ID. For details about how to obtain a project ID, see <a href="css_03_0071.html">Obtaining a Project ID and Name</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ResetPassword__row029112475719"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="ResetPassword__p629754155711">cluster_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="ResetPassword__p17297114195711">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="ResetPassword__p4298449579">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="ResetPassword__p529816485719">ID of the cluster whose password you want to change.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section829874205714"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ResetPassword__request_ResetPasswordReq" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="ResetPassword__row102999465711"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="ResetPassword__p1730210410579">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.2"><p id="ResetPassword__p930315418574">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="ResetPassword__p930914475715">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="ResetPassword__p83095435715">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ResetPassword__row16299444578"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="ResetPassword__p163096417577">newpassword</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="ResetPassword__p83101645570">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="ResetPassword__p18310204185710">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="ResetPassword__p14310134195711">Password of the cluster user <strong id="ResetPassword__b161818471863">admin</strong> in security mode. This API is available only when <strong id="ResetPassword__b252715411065">authorityEnable</strong> is set to <strong id="ResetPassword__b52657154416">true</strong>.</p>
|
|
<ul id="ResetPassword__ul4310942576"><li id="ResetPassword__li631004175717">The value can contain 8 to 32 characters.</li><li id="ResetPassword__li231118495716">The value must contain at least 3 of the following character types: uppercase letters, lowercase letters, numbers, and special characters ~!@#$%&*()-_=|[{}];:,<.>/?</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section031110419576"><h4 class="sectiontitle">Response Parameters</h4><p id="ResetPassword__p4311243573">None</p>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section1731244165712"><h4 class="sectiontitle">Request Example</h4><p id="ResetPassword__p531314495718">Change the administrator password of the current cluster.</p>
|
|
<pre class="screen" id="ResetPassword__screen9313642574">POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/password/reset
|
|
|
|
{
|
|
"newpassword" : "xxxxxx"
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section4315154145710"><h4 class="sectiontitle">Response Example</h4><p id="ResetPassword__p3316154205711">None</p>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section735844175711"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ResetPassword__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="ResetPassword__row13591347572"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="ResetPassword__p1736084135712">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="ResetPassword__p1936017465717">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ResetPassword__row1435915455712"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ResetPassword__p1936213455710">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ResetPassword__p9362144135712">The request is processed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ResetPassword__row113590412575"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ResetPassword__p2362444575">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ResetPassword__p336354195714">Invalid request.</p>
|
|
<p id="ResetPassword__p1936311425715">Modify the request instead of retrying.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ResetPassword__row123595415571"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ResetPassword__p173631849575">409</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ResetPassword__p1036314135717">The request cannot be processed due to a conflict.</p>
|
|
<p id="ResetPassword__p63641343574">This status code indicates that the resource the client is attempting to create already exists, or that the update operation requested cannot be completed due to a conflict.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ResetPassword__row13599414577"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ResetPassword__p936413485714">412</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ResetPassword__p9365741574">The server did not satisfy one of the preconditions set by the requester in the request.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="ResetPassword__section13654495711"><h4 class="sectiontitle">Error Codes</h4><p id="ResetPassword__p13365164155712">For details, see <a href="css_03_0076.html">Error Code</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="css_03_0008.html">Cluster Management APIs</a></div>
|
|
</div>
|
|
</div>
|
|
|