forked from docs/doc-exports
zhangyue
f3b09e5d2f
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
177 lines
13 KiB
HTML
177 lines
13 KiB
HTML
<a name="evs_04_3062"></a><a name="evs_04_3062"></a>
|
|
|
|
<h1 class="topictitle1">Adding Metadata of an EVS Snapshot</h1>
|
|
<div id="body1521540452899"><div class="section" id="evs_04_3062__section4805694511340"><h4 class="sectiontitle">Function</h4><p id="evs_04_3062__p29847411340">This API is used to add the metadata of an EVS snapshot.</p>
|
|
</div>
|
|
<div class="section" id="evs_04_3062__section268627411340"><h4 class="sectiontitle">URI</h4><ul id="evs_04_3062__ul1626162711340"><li id="evs_04_3062__li1213691911340">URI format<p id="evs_04_3062__p39128526112120"><a name="evs_04_3062__li1213691911340"></a><a name="li1213691911340"></a>POST /v3/{project_id}/snapshots/{snapshot_id}/metadata</p>
|
|
</li><li id="evs_04_3062__li4356636211340">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3062__table5655293911340" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3062__row4718979611340"><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_3062__p6427715211340">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_3062__p3906685711340">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_3062__p1029885411340">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_3062__row2890086411340"><td class="cellrowborder" valign="top" width="28.57%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="evs_04_3062__p116468178394">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_3062__p3603037711340">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_3062__p3277940011340">Specifies the project ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_3062__row2657914711340"><td class="cellrowborder" valign="top" width="28.57%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="evs_04_3062__p542726811340">snapshot_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_3062__p3695552511340">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_3062__p4060754311340">Specifies the snapshot ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_3062__section87667311340"><h4 class="sectiontitle">Request</h4><ul id="evs_04_3062__evs_04_2099_ul2606463112814"><li id="evs_04_3062__evs_04_2099_li23458172112814">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3062__evs_04_2099_table9796961112814" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3062__evs_04_2099_row1541837112814"><th align="left" class="cellrowborder" valign="top" width="19.86801319868013%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="evs_04_3062__evs_04_2099_p51734634112841">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.978402159784022%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="evs_04_3062__evs_04_2099_p29755832112841">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.238176182381764%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="evs_04_3062__evs_04_2099_p61412231112841">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.91540845915409%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="evs_04_3062__evs_04_2099_p8334847112841">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_3062__evs_04_2099_row15415933112814"><td class="cellrowborder" valign="top" width="19.86801319868013%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="evs_04_3062__evs_04_2099_p40731045112814">metadata</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.978402159784022%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="evs_04_3062__evs_04_2099_p10880325112814">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.238176182381764%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="evs_04_3062__evs_04_2099_p8891142112814">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="evs_04_3062__evs_04_2099_p49093903112814">Specifies the metadata to be added. For details, see <a href="#evs_04_3062__evs_04_2099_li39191951112814">Parameter in the metadata field</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="evs_04_3062__evs_04_2099_li39191951112814"><a name="evs_04_3062__evs_04_2099_li39191951112814"></a><a name="evs_04_2099_li39191951112814"></a>Parameter in the <strong id="evs_04_3062__evs_04_2099_b67202059185917">metadata</strong> field
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3062__evs_04_2099_table17183241112814" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3062__evs_04_2099_row29429246112814"><th align="left" class="cellrowborder" valign="top" width="19.68%" id="mcps1.3.3.2.2.2.1.5.1.1"><p id="evs_04_3062__evs_04_2099_p59908985112845">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.54%" id="mcps1.3.3.2.2.2.1.5.1.2"><p id="evs_04_3062__evs_04_2099_p20789580112845">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.86%" id="mcps1.3.3.2.2.2.1.5.1.3"><p id="evs_04_3062__evs_04_2099_p6234457112845">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.92%" id="mcps1.3.3.2.2.2.1.5.1.4"><p id="evs_04_3062__evs_04_2099_p35228998112845">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_3062__evs_04_2099_row40467139112814"><td class="cellrowborder" valign="top" width="19.68%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_3062__evs_04_2099_p56612845112814">key_val</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_3062__evs_04_2099_p22237723112814">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.86%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_3062__evs_04_2099_p56425142112814">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.92%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_3062__evs_04_2099_p7033765112814">Specifies the metadata information, which is made up of one or multiple key-value pairs.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="evs_04_3062__evs_04_2099_ul32864081112814"><li id="evs_04_3062__evs_04_2099_li27341273112814">Example request<pre class="screen" id="evs_04_3062__evs_04_2099_screen39243449164625">{
|
|
"metadata": {
|
|
"key1": "value1",
|
|
"key2": "value2"
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_3062__section5147449911340"><h4 class="sectiontitle">Response</h4><ul id="evs_04_3062__evs_04_2099_ul45240216"><li id="evs_04_3062__evs_04_2099_li8787321201856">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3062__evs_04_2099_table11977025201856" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3062__evs_04_2099_row8102228201856"><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_3062__evs_04_2099_p52300707201856">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_3062__evs_04_2099_p3642697315541">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_3062__evs_04_2099_p17319263201856">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_3062__evs_04_2099_row60683035201856"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="evs_04_3062__evs_04_2099_p16378828201856">metadata</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_3062__evs_04_2099_p6490369115541">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_3062__evs_04_2099_p20205612201856">Specifies the snapshot metadata, which is made up of key-value pairs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_3062__evs_04_2099_row1193419413714"><td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="evs_04_3062__evs_04_2099_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_3062__evs_04_2099_evs_04_2010_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_3062__evs_04_2099_p109527215417">Specifies the error message returned when an error occurs. For details, see <a href="#evs_04_3062__evs_04_2099_li0419202382514">Parameters in the error field</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="evs_04_3062__evs_04_2099_li0419202382514"><a name="evs_04_3062__evs_04_2099_li0419202382514"></a><a name="evs_04_2099_li0419202382514"></a>Parameters in the <strong id="evs_04_3062__evs_04_2099_evs_04_2013_b1288034833610">error</strong> field
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3062__evs_04_2099_evs_04_2013_table15441099103019" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3062__evs_04_2099_evs_04_2013_row54094047103019"><th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.2.2.2.1.4.1.1"><p id="evs_04_3062__evs_04_2099_evs_04_2013_p19541716103019">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.2.2.2.1.4.1.2"><p id="evs_04_3062__evs_04_2099_evs_04_2013_p39375186103019">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.64423557644236%" id="mcps1.3.4.2.2.2.1.4.1.3"><p id="evs_04_3062__evs_04_2099_evs_04_2013_p38578950103019">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="evs_04_3062__evs_04_2099_evs_04_2013_row59401790103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_3062__evs_04_2099_evs_04_2013_p46815658103019">message</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_3062__evs_04_2099_evs_04_2013_p33971979103019">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_3062__evs_04_2099_evs_04_2013_p21623243103019">The error message returned if an error occurs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="evs_04_3062__evs_04_2099_evs_04_2013_row60391466103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_3062__evs_04_2099_evs_04_2013_p59870541103019">code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_3062__evs_04_2099_evs_04_2013_p17675690103019">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_3062__evs_04_2099_evs_04_2013_p6087468103019">The error code returned if an error occurs.</p>
|
|
<p id="evs_04_3062__evs_04_2099_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_3062__evs_04_2099_li4508766">Example response<pre class="screen" id="evs_04_3062__evs_04_2099_screen57976789153420">{
|
|
"metadata": {
|
|
"key1": "value1",
|
|
"key2": "value2"
|
|
}
|
|
}</pre>
|
|
<p id="evs_04_3062__evs_04_2099_p52821068113531">or</p>
|
|
<pre class="screen" id="evs_04_3062__evs_04_2099_screen14642781153438">{
|
|
"error": {
|
|
"message": "XXXX",
|
|
"code": "XXX"
|
|
}
|
|
}</pre>
|
|
<p id="evs_04_3062__evs_04_2099_p5655715720175">In the preceding example, <strong id="evs_04_3062__evs_04_2099_b842352706143959">error</strong> indicates a general error, for example, <strong id="evs_04_3062__evs_04_2099_b842352706144438">badRequest</strong> or <strong id="evs_04_3062__evs_04_2099_b842352706144454">itemNotFound</strong>. An example is provided as follows:</p>
|
|
<pre class="screen" id="evs_04_3062__evs_04_2099_screen13206110153457">{
|
|
"badRequest": {
|
|
"message": "XXXX",
|
|
"code": "XXX"
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_3062__section1751558211340"><h4 class="sectiontitle">Status Codes</h4><ul id="evs_04_3062__evs_04_2099_ul947606911340"><li id="evs_04_3062__evs_04_2099_li1817575711340">Normal<p id="evs_04_3062__evs_04_2099_p2936408711340"><a name="evs_04_3062__evs_04_2099_li1817575711340"></a><a name="evs_04_2099_li1817575711340"></a>200</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="evs_04_3062__section431317151242"><h4 class="sectiontitle">Error Codes</h4><p id="evs_04_3062__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>
|
|
|