doc-exports/docs/css/api-ref/RetryUpgradeTask.html
Zheng, Xiu 3fa966049f css api 20240704 version
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>
2024-07-22 17:01:37 +00:00

119 lines
8.8 KiB
HTML

<a name="RetryUpgradeTask"></a><a name="RetryUpgradeTask"></a>
<h1 class="topictitle1">Retrying a Failed Upgrade Task</h1>
<div id="body0000001926518557"><div class="section" id="RetryUpgradeTask__section743956154417"><h4 class="sectiontitle">Function</h4><p id="RetryUpgradeTask__p34305644417">The upgrade takes a long time and the upgrade may fail due to network problems. You can use this API to retry a task or terminate the impact of a task.</p>
</div>
<div class="section" id="RetryUpgradeTask__section10441256194413"><h4 class="sectiontitle">Calling Method</h4><p id="RetryUpgradeTask__p1645956124410">For details, see <a href="css_03_0137.html">Calling APIs</a>.</p>
</div>
<div class="section" id="RetryUpgradeTask__section104685614448"><h4 class="sectiontitle">URI</h4><p id="RetryUpgradeTask__p54785634415">PUT /v1.0/{project_id}/clusters/{cluster_id}/upgrade/{action_id}/retry</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="RetryUpgradeTask__table349125614444" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="RetryUpgradeTask__row54815566449"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="RetryUpgradeTask__p1650856164414">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="RetryUpgradeTask__p45095684415">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="RetryUpgradeTask__p1451656194418">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="RetryUpgradeTask__p1952056114411">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="RetryUpgradeTask__row648956184417"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="RetryUpgradeTask__p18531456174418">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="RetryUpgradeTask__p653195654418">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="RetryUpgradeTask__p13547566440">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="RetryUpgradeTask__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="RetryUpgradeTask__row94855612444"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="RetryUpgradeTask__p1057185684418">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="RetryUpgradeTask__p6585562448">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="RetryUpgradeTask__p95945664419">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="RetryUpgradeTask__p10601756184412">ID of the cluster to be retried.</p>
</td>
</tr>
<tr id="RetryUpgradeTask__row1548165654410"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="RetryUpgradeTask__p261105624415">action_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="RetryUpgradeTask__p76295634412">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="RetryUpgradeTask__p1663135664414">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="RetryUpgradeTask__p1631956114420">ID of the task to be retried.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="RetryUpgradeTask__table86511564441" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Query parameters</caption><thead align="left"><tr id="RetryUpgradeTask__row4641656184414"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="RetryUpgradeTask__p1966155617442">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="RetryUpgradeTask__p46713566442">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="RetryUpgradeTask__p16765616440">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="RetryUpgradeTask__p2068125615442">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="RetryUpgradeTask__row964195624419"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="RetryUpgradeTask__p18696560446">retry_mode</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="RetryUpgradeTask__p07075654420">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="RetryUpgradeTask__p10715568448">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="RetryUpgradeTask__p197111568446">If this parameter is not left blank, the impact of the task is terminated. Currently, only <strong id="RetryUpgradeTask__b17816928363">abort</strong> is supported.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="RetryUpgradeTask__section1172145617440"><h4 class="sectiontitle">Request Parameters</h4><p id="RetryUpgradeTask__p9731156194411">None</p>
</div>
<div class="section" id="RetryUpgradeTask__section16736563443"><h4 class="sectiontitle">Response Parameters</h4><p id="RetryUpgradeTask__p1874115634414">None</p>
</div>
<div class="section" id="RetryUpgradeTask__section1775756194417"><h4 class="sectiontitle">Request Example</h4><ul id="RetryUpgradeTask__ul15751756134411"><li id="RetryUpgradeTask__li157619563443">Example request for retrying an upgrade task.<pre class="screen" id="RetryUpgradeTask__screen976856144417">PUT /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/upgrade/bcdb711c-a7f0-4007-b8ee-9f13c05f8326/retry</pre>
</li><li id="RetryUpgradeTask__li97745634413">Example request for terminating an upgrade task.<pre class="screen" id="RetryUpgradeTask__screen18785564448">PUT /v1.0/6204a5bd270343b5885144cf9c8c158d/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__section4793566449"><h4 class="sectiontitle">Response Example</h4><p id="RetryUpgradeTask__p1279105610440">None</p>
</div>
<div class="section" id="RetryUpgradeTask__section1714813563444"><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__row1214910566445"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="RetryUpgradeTask__p171506561447">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__p131512056194414">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="RetryUpgradeTask__row18149175618442"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="RetryUpgradeTask__p19152165618442">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="RetryUpgradeTask__p615216565447">The request is processed.</p>
</td>
</tr>
<tr id="RetryUpgradeTask__row10149165619448"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="RetryUpgradeTask__p14155105615443">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="RetryUpgradeTask__p16156256114419">Invalid request. Modify the request directly and do not attempt to retry it.</p>
</td>
</tr>
<tr id="RetryUpgradeTask__row01505569449"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="RetryUpgradeTask__p415745654413">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="RetryUpgradeTask__p18157135674415">The request is rejected. The server has received and understood the request, but refused to respond to it. Modify the request directly and do not attempt to retry it.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="RetryUpgradeTask__section1615845644419"><h4 class="sectiontitle">Error Codes</h4><p id="RetryUpgradeTask__p181595564443">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>