forked from docs/doc-exports
zhangyue
ccbf63b495
Reviewed-by: Muller, Martin <martin.muller@t-systems.com> Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
299 lines
24 KiB
HTML
299 lines
24 KiB
HTML
<a name="evs_04_2093"></a><a name="evs_04_2093"></a>
|
|
|
|
<h1 class="topictitle1">Creating an EVS Snapshot</h1>
|
|
<div id="body1521537033230"><div class="section" id="evs_04_2093__section17386310104128"><h4 class="sectiontitle">Function</h4><p id="evs_04_2093__p66113864104128">This API is used to create an EVS snapshot.</p>
|
|
</div>
|
|
<div class="section" id="evs_04_2093__section48475837104128"><h4 class="sectiontitle">URI</h4><ul id="evs_04_2093__ul34228737104128"><li id="evs_04_2093__li39623177104128">URI format<p id="evs_04_2093__p251210151111"><a name="evs_04_2093__li39623177104128"></a><a name="li39623177104128"></a>POST /v3/{project_id}/snapshots</p>
|
|
</li><li id="evs_04_2093__li55360764104128">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2093__table28484833104128" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2093__row60547305104128"><th align="left" class="cellrowborder" valign="top" width="28.57%" id="mcps1.3.2.2.2.1.1.4.1.1"><p id="evs_04_2093__p5384679104128">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="26.529999999999998%" id="mcps1.3.2.2.2.1.1.4.1.2"><p id="evs_04_2093__p33505894104128">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="44.9%" id="mcps1.3.2.2.2.1.1.4.1.3"><p id="evs_04_2093__p29622926104128">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_2093__row50646790104128"><td class="cellrowborder" valign="top" width="28.57%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="evs_04_2093__p8749302104128">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.2.2.2.1.1.4.1.2 "><p id="evs_04_2093__p37604871104128">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.2.2.2.1.1.4.1.3 "><p id="evs_04_2093__p26095712104128">Specifies the project ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_2093__section33377962104128"><h4 class="sectiontitle">Request</h4><ul id="evs_04_2093__evs_04_3056_ul9723142491119"><li id="evs_04_2093__evs_04_3056_li1672412249111">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2093__evs_04_3056_table1572462410119" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2093__evs_04_3056_row2724724141119"><th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="evs_04_2093__evs_04_3056_p20724132431116">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="evs_04_2093__evs_04_3056_p3724122431120">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="evs_04_2093__evs_04_3056_p15724192491114">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="49%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="evs_04_2093__evs_04_3056_p0724324121113">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_2093__evs_04_3056_row147241024121113"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="evs_04_2093__evs_04_3056_p187251024171111">snapshot</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="evs_04_2093__evs_04_3056_p67255248118">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="evs_04_2093__evs_04_3056_p127251724191119">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="evs_04_2093__evs_04_3056_p16725122411114">Specifies the information of the snapshot to be created. For details, see <a href="#evs_04_2093__evs_04_3056_li39126135104128">Parameters in the snapshot field</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="evs_04_2093__evs_04_3056_ul19260429104128"><li id="evs_04_2093__evs_04_3056_li39126135104128"><a name="evs_04_2093__evs_04_3056_li39126135104128"></a><a name="evs_04_3056_li39126135104128"></a>Parameters in the <strong id="evs_04_2093__evs_04_3056_b1241711282210">snapshot</strong> field
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2093__evs_04_3056_table16590896104128" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2093__evs_04_3056_row60389002104128"><th align="left" class="cellrowborder" valign="top" width="17.169999999999998%" id="mcps1.3.3.3.1.2.1.5.1.1"><p id="evs_04_2093__evs_04_3056_p59671014104128">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.15%" id="mcps1.3.3.3.1.2.1.5.1.2"><p id="evs_04_2093__evs_04_3056_p1513999104128">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.34%" id="mcps1.3.3.3.1.2.1.5.1.3"><p id="evs_04_2093__evs_04_3056_p55525100104128">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50.339999999999996%" id="mcps1.3.3.3.1.2.1.5.1.4"><p id="evs_04_2093__evs_04_3056_p1239270104128">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_2093__evs_04_3056_row12756475104128"><td class="cellrowborder" valign="top" width="17.169999999999998%" headers="mcps1.3.3.3.1.2.1.5.1.1 "><p id="evs_04_2093__evs_04_3056_p26641549104128">volume_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.1.2.1.5.1.2 "><p id="evs_04_2093__evs_04_3056_p10481847104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.34%" headers="mcps1.3.3.3.1.2.1.5.1.3 "><p id="evs_04_2093__evs_04_3056_p43723298104128">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.339999999999996%" headers="mcps1.3.3.3.1.2.1.5.1.4 "><p id="evs_04_2093__evs_04_3056_p51926262104128">Specifies the ID of the snapshot's source disk.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row64683174104128"><td class="cellrowborder" valign="top" width="17.169999999999998%" headers="mcps1.3.3.3.1.2.1.5.1.1 "><p id="evs_04_2093__evs_04_3056_p4845737104128">force</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.1.2.1.5.1.2 "><p id="evs_04_2093__evs_04_3056_p56960425104128">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.34%" headers="mcps1.3.3.3.1.2.1.5.1.3 "><p id="evs_04_2093__evs_04_3056_p50391693104128">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.339999999999996%" headers="mcps1.3.3.3.1.2.1.5.1.4 "><p id="evs_04_2093__evs_04_3056_p32530251113919">Specifies the flag for forcibly creating a snapshot. The default value is <strong id="evs_04_2093__evs_04_3056_b842352706181613">false</strong>.</p>
|
|
<ul id="evs_04_2093__evs_04_3056_ul60750582141455"><li id="evs_04_2093__evs_04_3056_li4878587141455">If this parameter is set to <strong id="evs_04_2093__evs_04_3056_b1283675572152242">false</strong> and the disk is in the <strong id="evs_04_2093__evs_04_3056_b842352706181628">attaching</strong> state, the snapshot cannot be forcibly created.</li><li id="evs_04_2093__evs_04_3056_li5444646714152">If this parameter is set to <strong id="evs_04_2093__evs_04_3056_b174167542715230">true</strong> and the disk is in the <strong id="evs_04_2093__evs_04_3056_b604695996">attaching</strong> state, the snapshot can be forcibly created.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row26995886104128"><td class="cellrowborder" valign="top" width="17.169999999999998%" headers="mcps1.3.3.3.1.2.1.5.1.1 "><p id="evs_04_2093__evs_04_3056_p39183164104128">metadata</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.1.2.1.5.1.2 "><p id="evs_04_2093__evs_04_3056_p19719755104128">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.34%" headers="mcps1.3.3.3.1.2.1.5.1.3 "><p id="evs_04_2093__evs_04_3056_p53796355104128">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.339999999999996%" headers="mcps1.3.3.3.1.2.1.5.1.4 "><p id="evs_04_2093__evs_04_3056_p62537483104128">Specifies the snapshot metadata.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row25966436104128"><td class="cellrowborder" valign="top" width="17.169999999999998%" headers="mcps1.3.3.3.1.2.1.5.1.1 "><p id="evs_04_2093__evs_04_3056_p22906600104128">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.1.2.1.5.1.2 "><p id="evs_04_2093__evs_04_3056_p43495312104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.34%" headers="mcps1.3.3.3.1.2.1.5.1.3 "><p id="evs_04_2093__evs_04_3056_p33459397104128">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.339999999999996%" headers="mcps1.3.3.3.1.2.1.5.1.4 "><p id="evs_04_2093__evs_04_3056_p25856622104128">Specifies the snapshot description. The value can be <strong id="evs_04_2093__evs_04_3056_b84235270618184">null</strong>. <span id="evs_04_2093__evs_04_3056_text503174715201714">The value can contain a maximum of 255 bytes.</span></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row31383010104128"><td class="cellrowborder" valign="top" width="17.169999999999998%" headers="mcps1.3.3.3.1.2.1.5.1.1 "><p id="evs_04_2093__evs_04_3056_p58995861104128">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.1.2.1.5.1.2 "><p id="evs_04_2093__evs_04_3056_p13935408104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.34%" headers="mcps1.3.3.3.1.2.1.5.1.3 "><p id="evs_04_2093__evs_04_3056_p55026268104128">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.339999999999996%" headers="mcps1.3.3.3.1.2.1.5.1.4 "><p id="evs_04_2093__evs_04_3056_p27942720104128">Specifies the snapshot name. <span id="evs_04_2093__evs_04_3056_text1418954783201721">The value can contain a maximum of 255 bytes.</span></p>
|
|
<div class="note" id="evs_04_2093__evs_04_3056_note12652884103214"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2093__evs_04_3056_p46767097103214">When creating a backup for a disk, a snapshot will be created and named with prefix <strong id="evs_04_2093__evs_04_3056_b84235270616432">autobk_snapshot_</strong>. The EVS console has imposed operation restrictions on snapshots with prefix <strong id="evs_04_2093__evs_04_3056_b842352706164512">autobk_snapshot_</strong>. Therefore, you are advised not to use <strong id="evs_04_2093__evs_04_3056_b842352706164552">autobk_snapshot_</strong> as the name prefix for the snapshots you created. Otherwise, the snapshots cannot be used normally.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="evs_04_2093__evs_04_3056_ul36257715104128"><li id="evs_04_2093__evs_04_3056_li57883987104128">Example request<pre class="screen" id="evs_04_2093__evs_04_3056_screen20956395164139">{
|
|
"snapshot": {
|
|
"name": "snap-001",
|
|
"description": "Daily backup",
|
|
"volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
|
|
"force": false,
|
|
"metadata": { }
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_2093__section26860493104128"><h4 class="sectiontitle">Response</h4><ul id="evs_04_2093__ul1511411391209"><li id="evs_04_2093__li17114193911017">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2093__table17114639207" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2093__row201158391702"><th align="left" class="cellrowborder" valign="top" width="21.43%" id="mcps1.3.4.2.1.1.1.4.1.1"><p id="evs_04_2093__p1911523917015">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.43%" id="mcps1.3.4.2.1.1.1.4.1.2"><p id="evs_04_2093__p71151139104">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.14%" id="mcps1.3.4.2.1.1.1.4.1.3"><p id="evs_04_2093__p7115539708">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_2093__row191151395014"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="evs_04_2093__p101155391703">snapshot</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="evs_04_2093__p311513393010">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="evs_04_2093__p11154391208">Specifies the snapshot information. For details, see <a href="#evs_04_2093__evs_04_3056_li52620487104128">Parameters in the snapshot field</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__row1911514391803"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="evs_04_2093__p129522216412">error</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="evs_04_2093__p1595262111415">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="evs_04_2093__p109527215417">Specifies the error message returned when an error occurs. For details, see <a href="#evs_04_2093__li0419202382514">Parameters in the error field</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="evs_04_2093__evs_04_3056_ul28216342104128"><li id="evs_04_2093__evs_04_3056_li52620487104128"><a name="evs_04_2093__evs_04_3056_li52620487104128"></a><a name="evs_04_3056_li52620487104128"></a>Parameters in the <strong id="evs_04_2093__b1957923513017">snapshot</strong> field
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2093__evs_04_3056_table3822335104128" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2093__evs_04_3056_row44730354104128"><th align="left" class="cellrowborder" valign="top" width="21.43%" id="mcps1.3.4.3.1.2.1.4.1.1"><p id="evs_04_2093__evs_04_3056_p66388932104128">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.43%" id="mcps1.3.4.3.1.2.1.4.1.2"><p id="evs_04_2093__evs_04_3056_p8794435104128">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.14%" id="mcps1.3.4.3.1.2.1.4.1.3"><p id="evs_04_2093__evs_04_3056_p53776742104128">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_2093__evs_04_3056_row41515896104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p7344400104128">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p58025504104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p63859146104128">Specifies the snapshot ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row37861410104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p46875355104128">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p38807409104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p4381265104128">Specifies the snapshot status. For details, see <a href="evs_04_0041.html">EVS Snapshot Status</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row39431393104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p39826261104128">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p4701738104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p45139478104128">Specifies the snapshot name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row3602118104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p23336160104128">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p11180798104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p7230824104128">Specifies the snapshot description.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row65077419104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p36779556104128">created_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p26354021104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p36300897104128">Specifies the time when the snapshot was created.</p>
|
|
<p id="evs_04_2093__p1298034454315"><span id="evs_04_2093__text56625358415">Time format: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX</span></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row58272623104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p22462033104128">metadata</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p7485408104128">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p55185187104128">Specifies the snapshot metadata.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row26904637104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p31791970104128">volume_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p25012792104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p27759637104128">Specifies the ID of the snapshot's source disk.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row48510149104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p37007959104128">size</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p44854718104128">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p19441706104128">Specifies the snapshot size, in GB.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_3056_row40757631104128"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_3056_p13033849104128">updated_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_3056_p49108876104128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_3056_p13680922104128">Specifies the time when the snapshot was updated.</p>
|
|
<p id="evs_04_2093__p194293411430"><span id="evs_04_2093__text272744520446">Time format: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX</span></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="evs_04_2093__evs_04_3056_ul34412902104128"><li id="evs_04_2093__li0419202382514"><a name="evs_04_2093__li0419202382514"></a><a name="li0419202382514"></a>Parameters in the <strong id="evs_04_2093__evs_04_2013_b1288034833610">error</strong> field
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2093__evs_04_2013_table15441099103019" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2093__evs_04_2013_row54094047103019"><th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.4.1.2.1.4.1.1"><p id="evs_04_2093__evs_04_2013_p19541716103019">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.4.1.2.1.4.1.2"><p id="evs_04_2093__evs_04_2013_p39375186103019">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.64423557644236%" id="mcps1.3.4.4.1.2.1.4.1.3"><p id="evs_04_2093__evs_04_2013_p38578950103019">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_2093__evs_04_2013_row59401790103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.4.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_2013_p46815658103019">message</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.4.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_2013_p33971979103019">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.4.4.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_2013_p21623243103019">The error message returned if an error occurs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_2093__evs_04_2013_row60391466103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.4.1.2.1.4.1.1 "><p id="evs_04_2093__evs_04_2013_p59870541103019">code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.4.1.2.1.4.1.2 "><p id="evs_04_2093__evs_04_2013_p17675690103019">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.4.4.1.2.1.4.1.3 "><p id="evs_04_2093__evs_04_2013_p6087468103019">The error code returned if an error occurs.</p>
|
|
<p id="evs_04_2093__evs_04_2013_p54787218103019">For details about the error code, see <a href="evs_04_0038.html">Error Codes</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="evs_04_2093__evs_04_3056_li41280666104128">Example response<pre class="screen" id="evs_04_2093__evs_04_3056_screen499817416428">{
|
|
"snapshot": {
|
|
"status": "creating",
|
|
"description": "Daily backup",
|
|
"created_at": "2013-02-25T03:56:53.081642",
|
|
"metadata": { },
|
|
"volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
|
|
"size": 1,
|
|
"id": "ffa9bc5e-1172-4021-acaf-cdcd78a9584d",
|
|
"name": "snap-001",
|
|
"updated_at": "2013-02-25T03:56:53.081642"
|
|
}
|
|
}</pre>
|
|
<p id="evs_04_2093__evs_04_3056_p52821068113531">or</p>
|
|
<pre class="screen" id="evs_04_2093__evs_04_3056_screen49985784152557">{
|
|
"error": {
|
|
"message": "XXXX",
|
|
"code": "XXX"
|
|
}
|
|
}</pre>
|
|
<p id="evs_04_2093__evs_04_3056_p5655715720175">In the preceding example, <strong id="evs_04_2093__b842352706143959">error</strong> indicates a general error, for example, <strong id="evs_04_2093__b842352706144438">badRequest</strong> or <strong id="evs_04_2093__b842352706144454">itemNotFound</strong>. An example is provided as follows:</p>
|
|
<pre class="screen" id="evs_04_2093__evs_04_3056_screen62160680152616">{
|
|
"itemNotFound": {
|
|
"message": "XXXX",
|
|
"code": "XXX"
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_2093__section10171239104128"><h4 class="sectiontitle">Status Codes</h4><ul id="evs_04_2093__evs_04_3056_ul18564055104128"><li id="evs_04_2093__evs_04_3056_li32858773104128">Normal<p id="evs_04_2093__evs_04_3056_p27293504104128"><a name="evs_04_2093__evs_04_3056_li32858773104128"></a><a name="evs_04_3056_li32858773104128"></a>202</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_2093__section431317151242"><h4 class="sectiontitle">Error Codes</h4><p id="evs_04_2093__evs_04_2013_p783819215242">For details, see <a href="evs_04_0038.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="evs_04_3055.html">EVS Snapshot</a></div>
|
|
</div>
|
|
</div>
|
|
|