forked from docs/doc-exports
wangdengke2
823df869a9
Reviewed-by: Gladkov, Maksim <mgladkov@noreply.gitea.eco.tsi-dev.otc-service.com> Co-authored-by: wangdengke2 <wangdengke2@huawei.com> Co-committed-by: wangdengke2 <wangdengke2@huawei.com>
126 lines
13 KiB
HTML
126 lines
13 KiB
HTML
<a name="EN-US_TOPIC_0000002332909553"></a><a name="EN-US_TOPIC_0000002332909553"></a>
|
|
|
|
<h1 class="topictitle1">Retrying Shard Configuration (a V3 API)</h1>
|
|
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_section71971443122216"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p171207573245">This API is used to retry shard configuration.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_section5205164312213"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p13208743102219">Only shard configuration tasks in the <strong id="EN-US_TOPIC_0000002332909553__b75607241689">Failed</strong> state can be retried.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_section018620371764"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p43571414182418">PUT /v3/{project_id}/instances/{instance_id}/databases/{db_name}/migration/jobs/{job_id}/retry</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_table1126028" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row146686416415"><th align="left" class="cellrowborder" valign="top" width="19.607843137254903%" id="mcps1.3.3.3.2.5.1.1"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p7669164745"><strong id="EN-US_TOPIC_0000002332909553__b1508388561112746">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.607843137254903%" id="mcps1.3.3.3.2.5.1.2"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p0670144643"><strong id="EN-US_TOPIC_0000002332909553__b1815888172114019">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.76470588235294%" id="mcps1.3.3.3.2.5.1.3"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p1767016415420"><strong id="EN-US_TOPIC_0000002332909553__b882039127112928">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="49.01960784313725%" id="mcps1.3.3.3.2.5.1.4"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p0670847413"><strong id="EN-US_TOPIC_0000002332909553__b194013536331338">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row1466994547"><td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p56703414418">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p96711141345">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.76470588235294%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p116714411415">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.01960784313725%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p367117413420">Project ID of a tenant in a region</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row166691241344"><td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p2067211417414">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p186721144412">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.76470588235294%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p067215414410">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.01960784313725%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p467244643">Instance ID</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row8551322718"><td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p5551921878">db_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p25528213718">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.76470588235294%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p555282671">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.01960784313725%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p35521321273">Schema name</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row32061117143116"><td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p10206817153118">job_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.607843137254903%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p280972618319">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.76470588235294%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p1780902611319">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.01960784313725%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p580952618316">ID of the shard configuration task</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_section1703735142515"><h4 class="sectiontitle">Request<span id="EN-US_TOPIC_0000002332909553__ph12005348423752"> Parameters</span></h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row1030416437226"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p11308643112210"><strong id="EN-US_TOPIC_0000002332909553__b331306416112746">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.2"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p9310134319223"><strong id="EN-US_TOPIC_0000002332909553__b788936908112928">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p18313144332214"><strong id="EN-US_TOPIC_0000002332909553__b2045207502114019">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p1731614435223"><strong id="EN-US_TOPIC_0000002332909553__b202160168531338">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row11304174332210"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p18319184352220">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p183214430225">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p032464332211">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p109669374313">User token.</p>
|
|
<p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p163271343192215">You can obtain the token by calling the IAM API used to obtain a user token.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_section12296195852419"><h4 class="sectiontitle">Example Request</h4><div class="p" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p175211447116">Retrying shard configuration<pre class="screen" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_screen8878182161411">PUT https://ddm.eu-de.otc.t-systems.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/1f5c9fd6cd984056ba89c8c87cc03278in09/databases/ddm_db_test/migration/jobs/10501cd3-0c19-498b-9ba4-8935ed447542/retry</pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_section71865377618"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_ul141861137968"><li id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_li218617373612">Normal response
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_table518714374616" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response body parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row111871437563"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.6.2.1.1.2.4.1.1"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p151873371064"><strong id="EN-US_TOPIC_0000002332909553__b367167475112746">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.6.2.1.1.2.4.1.2"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p161871371162"><strong id="EN-US_TOPIC_0000002332909553__b1112969140114019">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.6.2.1.1.2.4.1.3"><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p1418716371861"><strong id="EN-US_TOPIC_0000002332909553__b117549269331338">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_row8187237362"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.2.1.1.2.4.1.1 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p1818793714610">job_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.6.2.1.1.2.4.1.2 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p171871337560">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.6.2.1.1.2.4.1.3 "><p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_p14897475383">ID of the task for retrying shard configuration</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_li1718716371610">Normal response example<pre class="screen" id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_screen91870371868">{
|
|
"job_id":"xxxxxxxx-5d7e-4e1a-aeb4-9b1e6d0a4999"
|
|
}</pre>
|
|
</li><li id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_li15551925175513">Abnormal response<p id="EN-US_TOPIC_0000002332909553__en-us_topic_0000002167894376_p8181342786"><a name="EN-US_TOPIC_0000002332909553__en-us_topic_0000002319831021_li15551925175513"></a><a name="en-us_topic_0000002319831021_li15551925175513"></a>For details, see <a href="ddm_api_01_0059.html">Abnormal Request Results</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000002332909553__section4778540915440"><h4 class="sectiontitle">Status Codes</h4><ul id="EN-US_TOPIC_0000002332909553__en-us_topic_0110967248_ul7858132212142"><li id="EN-US_TOPIC_0000002332909553__en-us_topic_0110967248_li58581622171411">Normal<p id="EN-US_TOPIC_0000002332909553__en-us_topic_0110967248_p1040982941020"><a name="EN-US_TOPIC_0000002332909553__en-us_topic_0110967248_li58581622171411"></a><a name="en-us_topic_0110967248_li58581622171411"></a>202</p>
|
|
</li><li id="EN-US_TOPIC_0000002332909553__en-us_topic_0110967248_li11583183218149">Abnormal<p id="EN-US_TOPIC_0000002332909553__p81763119262"><a name="EN-US_TOPIC_0000002332909553__en-us_topic_0110967248_li11583183218149"></a><a name="en-us_topic_0110967248_li11583183218149"></a>For details, see <a href="ddm_api_01_0060.html">Status Codes</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000002332909553__section67241224201212"><h4 class="sectiontitle">Error Codes</h4><p id="EN-US_TOPIC_0000002332909553__p137251024181213">For details, see <a href="ddm_api_01_0061.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="ddm_api_01_0027.html">Schemas</a></div>
|
|
</div>
|
|
</div>
|
|
|