forked from docs/doc-exports
zhengxiu
8f6b8d3664
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: zhengxiu <zhengxiu@huawei.com> Co-committed-by: zhengxiu <zhengxiu@huawei.com>
153 lines
12 KiB
HTML
153 lines
12 KiB
HTML
<a name="RetryUpgradeTask"></a><a name="RetryUpgradeTask"></a>
|
|
|
|
<h1 class="topictitle1">Retrying a Failed Upgrade Task</h1>
|
|
<div id="body1708331107508"><div class="section" id="RetryUpgradeTask__section254018389167"><h4 class="sectiontitle">Function</h4><p id="RetryUpgradeTask__p8540133821614">The upgrade may fail due to network problems. In this case, you can call this API to retry.</p>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section65401538131610"><h4 class="sectiontitle">Calling Method</h4><p id="RetryUpgradeTask__p1654014389164">For details, see <a href="css_03_0077.html">Calling APIs</a>.</p>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section654113812166"><h4 class="sectiontitle">URI</h4><p id="RetryUpgradeTask__p4541113810163">PUT /v1.0/{project_id}/clusters/{cluster_id}/upgrade/{action_id}/retry</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="RetryUpgradeTask__table11541123871613" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="RetryUpgradeTask__row454143801614"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="RetryUpgradeTask__p1854218386169">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="RetryUpgradeTask__p1854213811165">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="RetryUpgradeTask__p1854233851617">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="RetryUpgradeTask__p17542123819160">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="RetryUpgradeTask__row15541938171617"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="RetryUpgradeTask__p6542103815164">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="RetryUpgradeTask__p15421638171616">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="RetryUpgradeTask__p6542838171618">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="RetryUpgradeTask__p154313851617"><strong id="RetryUpgradeTask__b5543153891611">Definition</strong>:</p>
|
|
<p id="RetryUpgradeTask__p19543123871615">Project ID. For details about how to obtain the project ID and name, see <a href="css_03_0071.html">Obtaining the Project ID and Name</a>.</p>
|
|
<p id="RetryUpgradeTask__p1554333820161"><strong id="RetryUpgradeTask__b254343851614">Constraints</strong>:</p>
|
|
<p id="RetryUpgradeTask__p354303815167">N/A</p>
|
|
<p id="RetryUpgradeTask__p20543193812163"><strong id="RetryUpgradeTask__b10543123891612">Value range</strong>:</p>
|
|
<p id="RetryUpgradeTask__p17543113841610">Project ID of the account.</p>
|
|
<p id="RetryUpgradeTask__p1054403831613"><strong id="RetryUpgradeTask__b10544153861616">Default value</strong>:</p>
|
|
<p id="RetryUpgradeTask__p6544738121611">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="RetryUpgradeTask__row15416384168"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="RetryUpgradeTask__p754433814169">cluster_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="RetryUpgradeTask__p5544163811613">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="RetryUpgradeTask__p145441738151616">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="RetryUpgradeTask__p135441438121619"><strong id="RetryUpgradeTask__b18544153819166">Definition</strong>:</p>
|
|
<p id="RetryUpgradeTask__p205441738191618">ID of the cluster to retry upgrade. For details about how to obtain the cluster ID, see <a href="css_03_0101.html">Obtaining the Cluster ID</a>.</p>
|
|
<p id="RetryUpgradeTask__p11544193811166"><strong id="RetryUpgradeTask__b1954523821614">Constraints</strong>:</p>
|
|
<p id="RetryUpgradeTask__p1454553811611">N/A</p>
|
|
<p id="RetryUpgradeTask__p55453384161"><strong id="RetryUpgradeTask__b12545838181611">Value range</strong>:</p>
|
|
<p id="RetryUpgradeTask__p175451938171611">Cluster ID.</p>
|
|
<p id="RetryUpgradeTask__p054520384163"><strong id="RetryUpgradeTask__b554533817162">Default value</strong>:</p>
|
|
<p id="RetryUpgradeTask__p654563814168">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="RetryUpgradeTask__row14541193819162"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="RetryUpgradeTask__p254543831612">action_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="RetryUpgradeTask__p185456385166">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="RetryUpgradeTask__p115451938101618">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="RetryUpgradeTask__p4546438191612"><strong id="RetryUpgradeTask__b1546193871617">Definition</strong>:</p>
|
|
<p id="RetryUpgradeTask__p18546338151620">ID of the task to be retried.</p>
|
|
<p id="RetryUpgradeTask__p18546153871617"><strong id="RetryUpgradeTask__b9546143816165">Constraints</strong>:</p>
|
|
<p id="RetryUpgradeTask__p554693810162">N/A</p>
|
|
<p id="RetryUpgradeTask__p1154623810164"><strong id="RetryUpgradeTask__b1546938101613">Value range</strong>:</p>
|
|
<p id="RetryUpgradeTask__p45465388163">N/A</p>
|
|
<p id="RetryUpgradeTask__p1854613384168"><strong id="RetryUpgradeTask__b145462038161617">Default value</strong>:</p>
|
|
<p id="RetryUpgradeTask__p1154623831619">N/A</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="RetryUpgradeTask__table1354783816160" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Query Parameters</caption><thead align="left"><tr id="RetryUpgradeTask__row15547193820160"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="RetryUpgradeTask__p155475380163">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="RetryUpgradeTask__p13547338171618">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="RetryUpgradeTask__p154715385161">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="RetryUpgradeTask__p85471938191620">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="RetryUpgradeTask__row1354716389166"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="RetryUpgradeTask__p17547153811166">retry_mode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="RetryUpgradeTask__p7548173812167">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="RetryUpgradeTask__p4548103819160">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="RetryUpgradeTask__p8548838121612"><strong id="RetryUpgradeTask__b17548338181612">Definition</strong>:</p>
|
|
<p id="RetryUpgradeTask__p1254883818166">If this parameter is not left blank, the task will be terminated.</p>
|
|
<p id="RetryUpgradeTask__p554863871620"><strong id="RetryUpgradeTask__b18548113811163">Constraints</strong>:</p>
|
|
<p id="RetryUpgradeTask__p1654883810162">Currently, its value can only be <strong id="RetryUpgradeTask__b5548123811618">abort</strong>.</p>
|
|
<p id="RetryUpgradeTask__p135481238201614"><strong id="RetryUpgradeTask__b13548938171611">Value range</strong>:</p>
|
|
<p id="RetryUpgradeTask__p1754843841610">abort: Abort the task.</p>
|
|
<p id="RetryUpgradeTask__p1354913387163"><strong id="RetryUpgradeTask__b1454910382164">Default value</strong>:</p>
|
|
<p id="RetryUpgradeTask__p1254920381166">N/A</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section1554917382165"><h4 class="sectiontitle">Request Parameters</h4><p id="RetryUpgradeTask__p5549193815163">None</p>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section11549133891615"><h4 class="sectiontitle">Response Parameters</h4><p id="RetryUpgradeTask__p1549143816163"><strong id="RetryUpgradeTask__b15491138151611">Status code: 200</strong></p>
|
|
<p id="RetryUpgradeTask__p9549183821616">Request succeeded.</p>
|
|
<p id="RetryUpgradeTask__p75492038151618">None</p>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section65492383161"><h4 class="sectiontitle">Example Requests</h4><ul id="RetryUpgradeTask__ul19550438131613"><li id="RetryUpgradeTask__li155501738141614"><p id="RetryUpgradeTask__p8550113816160"><a name="RetryUpgradeTask__li155501738141614"></a><a name="li155501738141614"></a>Example of an upgrade task retry request.</p>
|
|
<pre class="screen" id="RetryUpgradeTask__screen655016386169">PUT https://{Endpoint}/v1.0/{project_id}/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/upgrade/bcdb711c-a7f0-4007-b8ee-9f13c05f8326/retry</pre>
|
|
</li><li id="RetryUpgradeTask__li18550173841615"><p id="RetryUpgradeTask__p3550123861610"><a name="RetryUpgradeTask__li18550173841615"></a><a name="li18550173841615"></a>Example of an upgrade task termination request.</p>
|
|
<pre class="screen" id="RetryUpgradeTask__screen7550238121613">PUT https://{Endpoint}/v1.0/{project_id}/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/upgrade/bcdb711c-a7f0-4007-b8ee-9f13c05f8326/retry?retry_mode=abort</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section5550538141619"><h4 class="sectiontitle">Example Responses</h4><p id="RetryUpgradeTask__p755013881619">None</p>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section16777387168"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="RetryUpgradeTask__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="RetryUpgradeTask__row1756413813169"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="RetryUpgradeTask__p13677163811164">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="RetryUpgradeTask__p13677838151616">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="RetryUpgradeTask__row1956493810169"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="RetryUpgradeTask__p1267753801619">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="RetryUpgradeTask__p16775385163">Request succeeded.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="RetryUpgradeTask__row17564938141611"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="RetryUpgradeTask__p36775384165">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="RetryUpgradeTask__p13677193891618">Invalid request.</p>
|
|
<p id="RetryUpgradeTask__p8677163891616">The client should not repeat the request without modifications.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="RetryUpgradeTask__row16564238101615"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="RetryUpgradeTask__p12678173821618">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="RetryUpgradeTask__p11678133851616">Request rejected.</p>
|
|
<p id="RetryUpgradeTask__p1767823881611">The server has received the request and understood it, but the server refuses to respond to it. The client should not repeat the request without modifications.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="RetryUpgradeTask__section196781038121614"><h4 class="sectiontitle">Error Codes</h4><p id="RetryUpgradeTask__p867883814163">See <a href="css_03_0076.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="cluster_management.html">Cluster Management</a></div>
|
|
</div>
|
|
</div>
|
|
|