forked from docs/doc-exports
Chen, Junjie
5e34f6ce26
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Chen, Junjie <chenjunjie@huawei.com> Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>
135 lines
10 KiB
HTML
135 lines
10 KiB
HTML
<a name="dcs-api-0312021"></a><a name="dcs-api-0312021"></a>
|
|
|
|
<h1 class="topictitle1">Restoring a DCS Instance</h1>
|
|
<div id="body1500349379433"><div class="section" id="dcs-api-0312021__section17787161851016"><h4 class="sectiontitle">Function</h4><p id="dcs-api-0312021__p61151091696">This API is used to restore a specified DCS instance.</p>
|
|
<div class="note" id="dcs-api-0312021__note979571410307"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dcs-api-0312021__p109623444015">Only master/standby and cluster DCS instances can be backed up and restored, while single-node instances cannot.</p>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312021__section10627123311133"><h4 class="sectiontitle">URI</h4><p id="dcs-api-0312021__p10356042663">POST /v1.0/{project_id}/instances/{instance_id}/restores</p>
|
|
<div class="p" id="dcs-api-0312021__p939123033811"><a href="#dcs-api-0312021__table1899262913382">Table 1</a> describes the parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312021__table1899262913382"></a><a name="table1899262913382"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312021__table1899262913382" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312021__row1599115293389"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.1"><p id="dcs-api-0312021__p15991152913819">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.2"><p id="dcs-api-0312021__p129916298387">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.3"><p id="dcs-api-0312021__p13991142913384">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.4"><p id="dcs-api-0312021__p1991329193814">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312021__row11992929163813"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312021__p159911329153817">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312021__p18992192943819">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312021__p9992172933814">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312021__p20992829103811">Project ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312021__row17992929193810"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312021__p1899282919384">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312021__p15992229153810">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312021__p199921129133818">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312021__p199212910384">DCS instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312021__section17412144620133"><h4 class="sectiontitle">Request</h4><p class="msonormal" id="dcs-api-0312021__p036841715408"><strong id="dcs-api-0312021__b147569354109">Request parameters</strong></p>
|
|
<div class="msonormal" id="dcs-api-0312021__p9769133510383"><a href="#dcs-api-0312021__table153111335113816">Table 2</a> describes the request parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312021__table153111335113816"></a><a name="table153111335113816"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312021__table153111335113816" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312021__row73117359383"><th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.3.3.2.2.5.1.1"><p id="dcs-api-0312021__p1031043517387">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.16161616161616%" id="mcps1.3.3.3.2.2.5.1.2"><p id="dcs-api-0312021__p19310113593814">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.18181818181818%" id="mcps1.3.3.3.2.2.5.1.3"><p id="dcs-api-0312021__p93101035183813">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.45454545454545%" id="mcps1.3.3.3.2.2.5.1.4"><p id="dcs-api-0312021__p173101235153817">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312021__row1631133513386"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312021__p1476162018711">remark</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312021__p44761620072">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.18181818181818%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312021__p194761220279">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.45454545454545%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312021__p047619201376">Description of DCS instance restoration</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312021__row1231173523817"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.3.2.2.5.1.1 "><p id="dcs-api-0312021__p1047692020713">backup_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.3.3.2.2.5.1.2 "><p id="dcs-api-0312021__p54767201077">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.18181818181818%" headers="mcps1.3.3.3.2.2.5.1.3 "><p id="dcs-api-0312021__p3476132013716">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.45454545454545%" headers="mcps1.3.3.3.2.2.5.1.4 "><p id="dcs-api-0312021__p04761220579">ID of the backup record</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<p id="dcs-api-0312021__p18178425164011"><strong id="dcs-api-0312021__b82552429107">Example request</strong></p>
|
|
<pre class="screen" id="dcs-api-0312021__screen79231314141120">POST https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/restores</pre>
|
|
<div class="p" id="dcs-api-0312021__p20420191115118"><pre class="screen" id="dcs-api-0312021__screen13274335164015">{
|
|
"remark":"restore instance",
|
|
"<span style="color:#222222;">backup_id</span>":"8ba256cb-e5ac-44f6-a3da-c03d8f0e5029"
|
|
}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312021__section1417213312142"><h4 class="sectiontitle">Response</h4><p class="msonormal" id="dcs-api-0312021__p193854910404"><strong id="dcs-api-0312021__b157281948131011">Response parameters</strong></p>
|
|
<div class="msonormal" id="dcs-api-0312021__p1799214576389"><a href="#dcs-api-0312021__table1861319576383">Table 3</a> describes the response parameter.
|
|
<div class="tablenoborder"><a name="dcs-api-0312021__table1861319576383"></a><a name="table1861319576383"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312021__table1861319576383" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312021__row1961225712388"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.2.4.1.1"><p id="dcs-api-0312021__p136126577389">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12%" id="mcps1.3.4.3.2.2.4.1.2"><p id="dcs-api-0312021__p76121757113816">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="63%" id="mcps1.3.4.3.2.2.4.1.3"><p id="dcs-api-0312021__p26121157123820">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312021__row166121557203812"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="dcs-api-0312021__p2679426285">restore_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="dcs-api-0312021__p12679192617817">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="dcs-api-0312021__p1767952618810">ID of the restoration record</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="msonormal" id="dcs-api-0312021__p279219520416"><strong id="dcs-api-0312021__b1827014553106">Example response</strong><pre class="screen" id="dcs-api-0312021__screen18861710144112">{
|
|
"restore_id": "a6155972-800c-4170-a479-3231e907d2f6"
|
|
}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312021__section4860101417132"><h4 class="sectiontitle">Status Code</h4><p id="dcs-api-0312021__p586081451311"><a href="#dcs-api-0312021__table486141410130">Table 4</a> describes the status code of successful operations. For details about other status codes, see <a href="dcs-api-0312043.html#dcs-api-0312043__table5210141351517">Table 1</a>.</p>
|
|
|
|
<div class="tablenoborder"><a name="dcs-api-0312021__table486141410130"></a><a name="table486141410130"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312021__table486141410130" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Status code</caption><thead align="left"><tr id="dcs-api-0312021__row18616141139"><th align="left" class="cellrowborder" valign="top" width="15.98%" id="mcps1.3.5.3.2.3.1.1"><p id="dcs-api-0312021__p1986191418133">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="84.02%" id="mcps1.3.5.3.2.3.1.2"><p id="dcs-api-0312021__p18861111415138">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312021__row786131451312"><td class="cellrowborder" valign="top" width="15.98%" headers="mcps1.3.5.3.2.3.1.1 "><p id="dcs-api-0312021__p6861114181311">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="84.02%" headers="mcps1.3.5.3.2.3.1.2 "><p id="dcs-api-0312021__p48619143136">Restoration task created successfully.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dcs-api-0514005.html">Backup and Restoration APIs</a></div>
|
|
</div>
|
|
</div>
|
|
|