forked from docs/doc-exports
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>
327 lines
24 KiB
HTML
327 lines
24 KiB
HTML
<a name="dcs-api-0312022"></a><a name="dcs-api-0312022"></a>
|
|
|
|
<h1 class="topictitle1">Querying DCS Instance Backup Records</h1>
|
|
<div id="body1500349379436"><div class="section" id="dcs-api-0312022__section10329193461017"><h4 class="sectiontitle">Function</h4><p id="dcs-api-0312022__p14652163412920">This API is used to query the backup records of a specified DCS instance.</p>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312022__section10627123311133"><h4 class="sectiontitle">URI</h4><p id="dcs-api-0312022__p66477432917">GET /v1.0/{project_id}/instances/{instance_id}/backups?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}</p>
|
|
<div class="p" id="dcs-api-0312022__p939123033811"><a href="#dcs-api-0312022__table1899262913382">Table 1</a> describes the parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312022__table1899262913382"></a><a name="table1899262913382"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312022__table1899262913382" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312022__row1599115293389"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.3.2.2.5.1.1"><p id="dcs-api-0312022__p15991152913819">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.2.5.1.2"><p id="dcs-api-0312022__p129916298387">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.2.3.2.2.5.1.3"><p id="dcs-api-0312022__p13991142913384">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45%" id="mcps1.3.2.3.2.2.5.1.4"><p id="dcs-api-0312022__p1991329193814">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312022__row11992929163813"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312022__p1523414741010">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312022__p142349718103">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312022__p1323411714108">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312022__p102346716103">Project ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row313125212916"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312022__p1223415719101">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312022__p1923416720108">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312022__p62341677106">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312022__p1923487181015">DCS instance ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row615705910920"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312022__p52344791015">start</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312022__p13235475101">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312022__p62357791015">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312022__p023519761019">Start sequence number of the backup record that is to be queried. By default, this parameter is set to <strong id="dcs-api-0312022__b418831779">1</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row12603175214915"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312022__p723516711103">limit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312022__p1023514714106">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312022__p1223519711016">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312022__p323517191011">Number of backup records displayed on each page. The minimum value of this parameter is <strong id="dcs-api-0312022__b698477872">1</strong>. If this parameter is not set, 10 backup records are displayed on each page by default.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row199112521997"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312022__p423510710103"><span style="color:#222222;">beginTime</span></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312022__p22351572101">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312022__p323517712103">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312022__p023514711109">Start time of the period to be queried. Format: yyyyMMddHHmmss, for example, 20170718235959.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row12965536911"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dcs-api-0312022__p19235147111015"><span style="color:#222222;">endTime</span></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dcs-api-0312022__p1123511719102">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dcs-api-0312022__p1323577141014">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dcs-api-0312022__p1523514741020">End time of the period to be queried. Format: yyyyMMddHHmmss, for example, 20170718235959.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312022__section17412144620133"><h4 class="sectiontitle">Request</h4><p class="msonormal" id="dcs-api-0312022__p036841715408"><strong id="dcs-api-0312022__b13258185116115">Request parameters</strong></p>
|
|
<p id="dcs-api-0312022__p3991135811419">None</p>
|
|
<p id="dcs-api-0312022__p1037415181513"><strong id="dcs-api-0312022__b169913534115">Example request</strong></p>
|
|
<pre class="screen" id="dcs-api-0312022__screen155913010114">GET https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/backups?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}</pre>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312022__section1417213312142"><h4 class="sectiontitle">Response</h4><p class="msonormal" id="dcs-api-0312022__p193854910404"><strong id="dcs-api-0312022__b10223185961111">Response parameters</strong></p>
|
|
<div class="msonormal" id="dcs-api-0312022__p1799214576389"><a href="#dcs-api-0312022__table1861319576383">Table 2</a> describes the response parameters.
|
|
<div class="tablenoborder"><a name="dcs-api-0312022__table1861319576383"></a><a name="table1861319576383"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312022__table1861319576383" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="dcs-api-0312022__row1961225712388"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.2.4.1.1"><p id="dcs-api-0312022__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-0312022__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-0312022__p26121157123820">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312022__row166121557203812"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="dcs-api-0312022__p1694215159152">backup_record_response</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="dcs-api-0312022__p1394211511516">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="dcs-api-0312022__p994291518159">Array of the backup records. For details about backup_record_response, see <a href="#dcs-api-0312022__table82951233189">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row13767421219"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="dcs-api-0312022__p1237615425118">total_num</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="dcs-api-0312022__p4376042714">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="dcs-api-0312022__p113765421411">Number of obtained backup records.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dcs-api-0312022__table82951233189"></a><a name="table82951233189"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312022__table82951233189" frame="border" border="1" rules="all"><caption><b>Table 3 </b>backup_record_response parameter description</caption><thead align="left"><tr id="dcs-api-0312022__row1529552361817"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.4.2.4.1.1"><p id="dcs-api-0312022__p19295182361812">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12%" id="mcps1.3.4.4.2.4.1.2"><p id="dcs-api-0312022__p5295142341812">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="63%" id="mcps1.3.4.4.2.4.1.3"><p id="dcs-api-0312022__p17295182391816">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312022__row1129512317181"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p1353145413181">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p153119547184">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p1453195431814">Backup status. Options:</p>
|
|
<ul id="dcs-api-0312022__ul7204867542"><li id="dcs-api-0312022__li86752484489"><strong id="dcs-api-0312022__b128611546141815">waiting</strong>: DCS instance restoration is waiting to begin.</li><li id="dcs-api-0312022__li2681184884818"><strong id="dcs-api-0312022__b19181248181814">backuping</strong>: DCS instance backup is in progress.</li><li id="dcs-api-0312022__li5690114814483"><strong id="dcs-api-0312022__b20126174961816">succeed</strong>: DCS instance backup succeeded.</li><li id="dcs-api-0312022__li15695134864814"><strong id="dcs-api-0312022__b82725151816">failed</strong>: DCS instance backup failed.</li><li id="dcs-api-0312022__li10698548154819"><strong id="dcs-api-0312022__b14902105118186">expired</strong>: The backup file expires.</li><li id="dcs-api-0312022__li1670284815482"><strong id="dcs-api-0312022__b2979145221810">deleted</strong>: The backup file has been deleted manually. </li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row1329517231188"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p1553115413185">remark</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p7531195417183">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p19532854121812">Description of DCS instance backup</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row89511348141815"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p4532135411187">period</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p1853215544184">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p18532135414189">Time segment in which DCS instance backup was performed</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row3237649111810"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p17532175416181">progress</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p3532954171818">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p85325542188">Backup progress</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row639864912186"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p05323546184">size</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p1253219547187">Long</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p6532115419183">Size of the backup file. Unit: byte.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row177581437173119"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p3758123723116">instance_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p20759163719311">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p67591837173119">DCS instance ID</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row1858120491183"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p253215417181">backup_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p3532115471814">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p95321054161817">ID of the backup record</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row10758144910189"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p105321554191816">created_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p2532115419180">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p5532185417187">Time at which the backup task is created</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row8908349191817"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p12532115461819">updated_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p1853255431810">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p6532145417182">Time at which DCS instance backup is completed</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row89415477414"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p29421847114119">execution_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p694274712413">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p3942204734120">Time at which the backup starts.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row14234450101811"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p105331954101820">backup_type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p753365411815">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p195331354111818">Backup type. Options:</p>
|
|
<ul id="dcs-api-0312022__ul6533954131811"><li id="dcs-api-0312022__li2053315543187"><strong id="dcs-api-0312022__b1376692421019">manual</strong>: manual backup</li><li id="dcs-api-0312022__li353345491817"><strong id="dcs-api-0312022__b688010283104">auto</strong>: automatic backup</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row5539165051818"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p1353317547181">backup_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p11533105471820">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p553313540185">Name of the backup record</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row1729351953210"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p42951719133215">backup_format</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p5295119143218">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p14295171916328">Backup format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row12951323121812"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p115331954111810">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p19533105415189">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p5533185491810">Error code returned if DCS instance backup fails. For details about error codes, see <a href="#dcs-api-0312022__table1255361919491">Table 4</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row2060041023717"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="dcs-api-0312022__p1860121043718">is_support_restore</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.4.2.4.1.2 "><p id="dcs-api-0312022__p1479155312376">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.3.4.4.2.4.1.3 "><p id="dcs-api-0312022__p796540154715">An indicator of whether restoration is supported. Options: <strong id="dcs-api-0312022__b1932918451192">TRUE</strong> or <strong id="dcs-api-0312022__b1932917456918">FALSE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dcs-api-0312022__table1255361919491"></a><a name="table1255361919491"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312022__table1255361919491" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Error codes returned in case of a backup or restoration failure</caption><thead align="left"><tr id="dcs-api-0312022__row1755412199492"><th align="left" class="cellrowborder" valign="top" width="32%" id="mcps1.3.4.5.2.3.1.1"><p id="dcs-api-0312022__p2554171914492">Error Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="68%" id="mcps1.3.4.5.2.3.1.2"><p id="dcs-api-0312022__p14554121914917">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312022__row6554319154918"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p115547197491">dcs.08.0001</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p1155412195491">Failed to start the backup and restore tool.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row145541819124918"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p85541319184920">dcs.08.0002</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p1455401916493">Operation timed out.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row2554519114913"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p555401924915">dcs.08.0003</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p355417197494">Failed to delete bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row75548193491"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p25541319144917">dcs.08.0004</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p3554121974914">Failed to obtain AK/SK.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row1355415199491"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p12554111915490">dcs.08.0005</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p355421919494">Failed to create bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row18554719144912"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p1755581920499">dcs.08.0006</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p19555151914490">Failed to obtain backup file size.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row2555161914910"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p15555131994918">dcs.08.0007</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p2555319144916">Data synchronization failed during instance restoration.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dcs-api-0312022__row1111512213330"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.4.5.2.3.1.1 "><p id="dcs-api-0312022__p1811642113319">dcs.08.0008</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.4.5.2.3.1.2 "><p id="dcs-api-0312022__p011617219332">Automatic backup of the instance cannot start because the instance is running other jobs.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p class="msonormal" id="dcs-api-0312022__p279219520416"><strong id="dcs-api-0312022__b56612918123">Example response</strong></p>
|
|
<pre class="screen" id="dcs-api-0312022__screen4707640114017">{
|
|
"backup_record_response": [
|
|
{
|
|
"status": "succeed",
|
|
"remark": "001",
|
|
"period": null,
|
|
"progress": "100.00",
|
|
"size": 880232,
|
|
"instance_id": "5560df16-cebf-4473-95c4-d1b573c16e79",
|
|
"backup_id": "4631832a-14c6-45b0-a0b3-3abd8f591ad1",
|
|
"created_at": "2019-05-10T08:31:16.166Z",
|
|
"updated_at": "2019-05-10T08:32:30.546Z",
|
|
"execution_at": "2019-05-10T08:31:21.461Z",
|
|
"backup_type": "manual",
|
|
"backup_format": "AOF",
|
|
"backup_name": "backup_20190510163116",
|
|
"error_code": null,
|
|
"is_support_restore": "TRUE"
|
|
}
|
|
],
|
|
"total_num": 1
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="dcs-api-0312022__section4860101417132"><h4 class="sectiontitle">Status Code</h4><p id="dcs-api-0312022__p586081451311"><a href="#dcs-api-0312022__table486141410130">Table 5</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-0312022__table486141410130"></a><a name="table486141410130"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-api-0312022__table486141410130" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Status code</caption><thead align="left"><tr id="dcs-api-0312022__row18616141139"><th align="left" class="cellrowborder" valign="top" width="15.98%" id="mcps1.3.5.3.2.3.1.1"><p id="dcs-api-0312022__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-0312022__p18861111415138">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dcs-api-0312022__row786131451312"><td class="cellrowborder" valign="top" width="15.98%" headers="mcps1.3.5.3.2.3.1.1 "><p id="dcs-api-0312022__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-0312022__p48619143136">DCS instance backup records queried 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>
|
|
|