doc-exports/docs/dws/api-ref/dws_02_0054.html
Lu, Huayi 3d88b677fd DWS API 830.201 version
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-10 13:18:08 +00:00

129 lines
16 KiB
HTML

<a name="EN-US_TOPIC_0000001186151628"></a><a name="EN-US_TOPIC_0000001186151628"></a>
<h1 class="topictitle1">Resetting a Password</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_s7aa3de1b44f14c0487bab690bb5702d6"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_af45ba7dd71a6422c9a39c39b44dbd8a8">This API is used to reset the password of cluster administrator.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_s9db56e76e7694a5cbfd993c7d1db0606"><h4 class="sectiontitle">URI</h4><ul id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_u4cf609fc053741998eedd89cf45caf2c"><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_l2b8b579a356f4f1f8118dc22b4a322e5">URI format<pre class="screen" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_screen17156164716589">POST /v1.0/{project_id}/clusters/{cluster_id}/reset-password</pre>
</li><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_l04279980b92848f4b97e6cdbfac33319">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_tb301b46821994ee6ae8cb5d508bfd564" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_r09f2cf7e302f4b1197b293cb5b91aa42"><th align="left" class="cellrowborder" valign="top" width="19.64%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ad24f94544e3448e588d569b4cf5d3df1"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b7190354133414">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="9.58%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a23ce55ff78b64009b06caaddea7be777"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b92531155133416">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.299999999999999%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_aa68a5c620b7741ebb873bc22f4abf72b"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b114191857251">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.48%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a5c07a285f796424888ea8c9b215ef172"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b1334420616258">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_rd49c40cc2e534fb38fc1ce2158dda6da"><td class="cellrowborder" valign="top" width="19.64%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_adf89366c8cdf490b91f7ab0b1aa4c9d7">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="9.58%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a03a216c626564f1eb88d9562a41ee374">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="14.299999999999999%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a9bf19da6d557419eb7768b4c0d4dc441">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.48%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_p1266145715419"><span id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_text10261133413315">Project ID</span>. For details about how to obtain the ID, see <a href="dws_02_0011.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_r3f1019a86e164120957b6c78183aed5c"><td class="cellrowborder" valign="top" width="19.64%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ac8206c593fb6478d90922a1317be1af3">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="9.58%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a723b9ebdf5d14520ac6db771eea07716">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="14.299999999999999%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a42225196447a466a8b27488e9f840018">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.48%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a3c9219ff8f544b6db2665fbab0057dab">ID of the cluster whose password is to be reset. For details about how to obtain the ID, see <a href="dws_02_00068.html">Obtaining the Cluster ID</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_sa64d5fde1cb94be29689b1aab5bc2bb2"><h4 class="sectiontitle">Request Message</h4><ul id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_u56175bf842bc4ad4955c9629175fdcf6"><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_le3efc5a2349b4c1084d325bac163560c">Request example<pre class="screen" id="EN-US_TOPIC_0000001186151628__screen212118301885">POST https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/reset-password
{
"new_password" : "NewPassword!"
}</pre>
</li></ul>
<ul id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_uf93db65bd61b4726a254602f9dca6091"><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_lae6e367885da4d8a9f688f856f1553fc">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_tc32f843a9ead4035a871c86d7a4846cf" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_rcf972ba57cb945bca28c72ec13f32fb4"><th align="left" class="cellrowborder" valign="top" width="20.36%" id="mcps1.3.3.3.1.1.2.5.1.1"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a04409112453b4054b07ce0e5d3fd7aac"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b0456948143518">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="9.94%" id="mcps1.3.3.3.1.1.2.5.1.2"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ac42ccdeeb5ca426cba55f7d3103a3e4d"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b1417814915357">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.03%" id="mcps1.3.3.3.1.1.2.5.1.3"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a3be50d1d99d643778bb995586c600e14"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b5883143252">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54.669999999999995%" id="mcps1.3.3.3.1.1.2.5.1.4"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a028e0ec2d58b47edb787e6e49333ec7f"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b3195015122513">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_recb12ef1d4f24c248e72fa202d02918c"><td class="cellrowborder" valign="top" width="20.36%" headers="mcps1.3.3.3.1.1.2.5.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_aa79b2667616f4f9f84a72005adac2a74">new_password</p>
</td>
<td class="cellrowborder" valign="top" width="9.94%" headers="mcps1.3.3.3.1.1.2.5.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a6219947762bf4127ad4313192186f4b0">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.03%" headers="mcps1.3.3.3.1.1.2.5.1.3 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a49c27493d4b44d74ae91d624f93bb313">String</p>
</td>
<td class="cellrowborder" valign="top" width="54.669999999999995%" headers="mcps1.3.3.3.1.1.2.5.1.4 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_p132101182611">New administrator password for logging in to a data warehouse cluster</p>
<p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_p1321101132611">A password must conform to the following rules:</p>
<ul id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ul73211311132615"><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li832111114268">Contains 12 to 32 characters.</li><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li632141116266">Cannot be the same as the username or the username written in reverse order.</li><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li14321101172615">Contains at least three types of the following:<ul id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ul63213118261"><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li432131110262">Lowercase letters</li><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li103211011192618">Uppercase letters</li><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li19321131120261">Digits</li><li id="EN-US_TOPIC_0000001186151628__li1599974111152">Special characters: ~!?,.:;-_'"(){}[]/&lt;&gt;@#%^&amp;*+|\=</li></ul>
</li></ul>
<ul id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ul144241437192613"><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li2424437152619">Cannot be the same as previous passwords.</li><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_li189123010402">Cannot be a weak password.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_saf8285fea2964e558a059d985c498559"><h4 class="sectiontitle">Response Message</h4><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_en-us_topic_0067625516_p070316818262">Example response</p>
<pre class="screen" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_sabffaf8806d04531be3a32b013bf56e3">status CODE 200</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_s318da95b204f47c4bef42e78b54a9089"><h4 class="sectiontitle">Status Code</h4><ul id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_u6b27dfff47284d9eb4526aa606fd904d"><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_lc3e480c720a44ace9824ad63cbfe527d">Normal<p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_afe8c3c6bf90a42eca6518dde64ab22ed"><a name="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_lc3e480c720a44ace9824ad63cbfe527d"></a><a name="en-us_topic_0000001145896585_lc3e480c720a44ace9824ad63cbfe527d"></a>200</p>
</li><li id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_la038d54e5c39431386902a311ea0a9bd">Exception
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_tfd7a877a4eed4992a077edb0bb8f7352" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Returned values</caption><thead align="left"><tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_red5a03b5306f46e0900cacc8c992c838"><th align="left" class="cellrowborder" valign="top" width="31.64%" id="mcps1.3.5.2.2.1.2.3.1.1"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a72e8066c2a994394ba0ece17bd467376"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b1077215316375">Returned Value</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="68.36%" id="mcps1.3.5.2.2.1.2.3.1.2"><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a2982bcdae3bb45f8b90b4baeef64cc05"><strong id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_b16494623132515">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_r5d0fed0ce30740a49f01318c52c42592"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.3.5.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ae37fb97120e94cbea677f88d0ab4edbd">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="68.36%" headers="mcps1.3.5.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ac2c1c94571004267a7297152e7edb7fc">Request error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_r45192eae966e4de885d09edc4b3eee3c"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.3.5.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_adfc757440c4849e09a2516b04e8a1d01">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="68.36%" headers="mcps1.3.5.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_af986420c033c45dea198eb80d6c07471">Authorization failed.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_r41d8f90f2d864d6b92339cf01794c677"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.3.5.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a24892b03923545f48aa72a00f90ac7d3">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="68.36%" headers="mcps1.3.5.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a6ac5aa0c4d654b33aa51c2193a5b6e83">No operation permission.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_rb2e58285b54e40058c475f72290b1e68"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.3.5.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a3a8f1a544d714b28b85c80856fe07ae5">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="68.36%" headers="mcps1.3.5.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a75dc6f72a9044650829d4fd51c48beb5">No resources found.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_r02aba20d19bc40bea95f3b9dc09780c1"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.3.5.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ade198c372ecb4b6786369a2cd1d0a5dc">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="68.36%" headers="mcps1.3.5.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_ad8ec7dfac3ae464f86a085852ac0db58">Internal service error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_r77f8af8054384d23bf198428f13a207b"><td class="cellrowborder" valign="top" width="31.64%" headers="mcps1.3.5.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a73100e054b9840dd80134200f3624a23">503 Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="68.36%" headers="mcps1.3.5.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001186151628__en-us_topic_0000001145896585_a7d16065e572f480a95470cafcc622e7b">The service is unavailable.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_02_0017.html">Cluster Management APIs</a></div>
</div>
</div>