doc-exports/docs/evs/api-ref/evs_04_3043.html
zhangyue f3b09e5d2f Elastic Volume Service API V1
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2023-02-02 16:28:20 +00:00

120 lines
9.1 KiB
HTML

<a name="evs_04_3043"></a><a name="evs_04_3043"></a>
<h1 class="topictitle1">Deleting One Piece of Metadata for an EVS Disk</h1>
<div id="body1521535373827"><div class="section" id="evs_04_3043__section19390540"><h4 class="sectiontitle">Function</h4><p id="evs_04_3043__p50301879">This API is used to delete one piece of the EVS disk metadata.</p>
</div>
<div class="section" id="evs_04_3043__section40297137"><h4 class="sectiontitle">URI</h4><ul id="evs_04_3043__ul47920438"><li id="evs_04_3043__li28630766">URI format<p id="evs_04_3043__p37390672"><a name="evs_04_3043__li28630766"></a><a name="li28630766"></a>DELETE /v3/{project_id}/volumes/{volume_id}/metadata/{key}</p>
</li><li id="evs_04_3043__li971734">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3043__table8745607" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3043__row15985080"><th align="left" class="cellrowborder" valign="top" width="27.689999999999998%" id="mcps1.3.2.2.2.1.1.4.1.1"><p id="evs_04_3043__p19723089">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.3%" id="mcps1.3.2.2.2.1.1.4.1.2"><p id="evs_04_3043__p54066375">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.01%" id="mcps1.3.2.2.2.1.1.4.1.3"><p id="evs_04_3043__p17300225">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_3043__row59140967"><td class="cellrowborder" valign="top" width="27.689999999999998%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="evs_04_3043__p25689059">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="21.3%" headers="mcps1.3.2.2.2.1.1.4.1.2 "><p id="evs_04_3043__p439002">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="51.01%" headers="mcps1.3.2.2.2.1.1.4.1.3 "><p id="evs_04_3043__p35559222">Specifies the project ID.</p>
</td>
</tr>
<tr id="evs_04_3043__row51597550"><td class="cellrowborder" valign="top" width="27.689999999999998%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="evs_04_3043__p18651996">volume_id</p>
</td>
<td class="cellrowborder" valign="top" width="21.3%" headers="mcps1.3.2.2.2.1.1.4.1.2 "><p id="evs_04_3043__p34416674">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="51.01%" headers="mcps1.3.2.2.2.1.1.4.1.3 "><p id="evs_04_3043__p36287209">Specifies the disk ID.</p>
</td>
</tr>
<tr id="evs_04_3043__row21272210213647"><td class="cellrowborder" valign="top" width="27.689999999999998%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="evs_04_3043__p45327484213647">key</p>
</td>
<td class="cellrowborder" valign="top" width="21.3%" headers="mcps1.3.2.2.2.1.1.4.1.2 "><p id="evs_04_3043__p47647615213647">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="51.01%" headers="mcps1.3.2.2.2.1.1.4.1.3 "><p id="evs_04_3043__p34251586213647">Specifies the key of the piece of metadata to be deleted.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="evs_04_3043__section27129916"><h4 class="sectiontitle">Request</h4><ul id="evs_04_3043__ul14963212101"><li id="evs_04_3043__li12496526109">Example request<pre class="screen" id="evs_04_3043__screen1836449161017">DELETE https://{endpoint}/v3/{project_id}/volumes/b104b8db-170d-441b-897a-3c8ba9c5a214/metadata/value1</pre>
</li></ul>
</div>
<div class="section" id="evs_04_3043__section42842654"><h4 class="sectiontitle">Response</h4><ul id="evs_04_3043__evs_04_2079_ul61377636121252"><li id="evs_04_3043__evs_04_2079_li15527813121252">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3043__evs_04_2079_table5532594121252" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3043__evs_04_2079_row60048709121252"><th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.2.1.1.1.4.1.1"><p id="evs_04_3043__evs_04_2079_p32107236121252">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.2.1.1.1.4.1.2"><p id="evs_04_3043__evs_04_2079_p50549312121252">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.64423557644236%" id="mcps1.3.4.2.1.1.1.4.1.3"><p id="evs_04_3043__evs_04_2079_p2030156121252">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_3043__evs_04_2079_row30224973121252"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="evs_04_3043__evs_04_2079_p129522216412">error</p>
</td>
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="evs_04_3043__evs_04_2079_p1595262111415">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="evs_04_3043__evs_04_2079_p109527215417">Specifies the error message returned when an error occurs. For details, see <a href="#evs_04_3043__evs_04_2079_li0419202382514">Parameters in the error field</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_3043__evs_04_2079_li0419202382514"><a name="evs_04_3043__evs_04_2079_li0419202382514"></a><a name="evs_04_2079_li0419202382514"></a>Parameters in the <strong id="evs_04_3043__evs_04_2079_evs_04_2013_b1288034833610">error</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_3043__evs_04_2079_evs_04_2013_table15441099103019" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_3043__evs_04_2079_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_3043__evs_04_2079_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_3043__evs_04_2079_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_3043__evs_04_2079_evs_04_2013_p38578950103019">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_3043__evs_04_2079_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_3043__evs_04_2079_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_3043__evs_04_2079_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_3043__evs_04_2079_evs_04_2013_p21623243103019">The error message returned if an error occurs.</p>
</td>
</tr>
<tr id="evs_04_3043__evs_04_2079_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_3043__evs_04_2079_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_3043__evs_04_2079_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_3043__evs_04_2079_evs_04_2013_p6087468103019">The error code returned if an error occurs.</p>
<p id="evs_04_3043__evs_04_2079_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_3043__evs_04_2079_li38255809121252">Example response<p id="evs_04_3043__evs_04_2079_p8757961121252"><a name="evs_04_3043__evs_04_2079_li38255809121252"></a><a name="evs_04_2079_li38255809121252"></a>None</p>
<p id="evs_04_3043__evs_04_2079_p11712787121252">or</p>
<pre class="screen" id="evs_04_3043__evs_04_2079_screen48445255151416">{
"error": {
"message": "XXXX",
"code": "XXX"
}
}</pre>
<p id="evs_04_3043__evs_04_2079_p9211706121252">In the preceding example, <strong id="evs_04_3043__evs_04_2079_b842352706143959">error</strong> indicates a general error, for example, <strong id="evs_04_3043__evs_04_2079_b842352706144438">badrequest</strong> or <strong id="evs_04_3043__evs_04_2079_b842352706144454">itemNotFound</strong>. An example is provided as follows:</p>
<pre class="screen" id="evs_04_3043__evs_04_2079_screen52058323151436">{
"itemNotFound": {
"message": "XXXX",
"code": "XXX"
}
}</pre>
</li></ul>
</div>
<div class="section" id="evs_04_3043__section50039568"><h4 class="sectiontitle">Status Codes</h4><ul id="evs_04_3043__evs_04_2079_ul5136981"><li id="evs_04_3043__evs_04_2079_li46232835">Normal<p id="evs_04_3043__evs_04_2079_p13442339"><a name="evs_04_3043__evs_04_2079_li46232835"></a><a name="evs_04_2079_li46232835"></a>200</p>
</li></ul>
</div>
<div class="section" id="evs_04_3043__section431317151242"><h4 class="sectiontitle">Error Codes</h4><p id="evs_04_3043__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_3028.html">EVS Disk</a></div>
</div>
</div>