Files
doc-exports/docs/bms/api-ref/en-us_topic_0000002340063028.html
wanghuijuan738 69783f9e3e bms api 20241225 version
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: wanghuijuan738 <wanghuijuan738@huawei.com>
Co-committed-by: wanghuijuan738 <wanghuijuan738@huawei.com>
2025-07-16 09:58:55 +00:00

82 lines
11 KiB
HTML

<a name="EN-US_TOPIC_0000002340063028"></a><a name="EN-US_TOPIC_0000002340063028"></a>
<h1 class="topictitle1">Deleting Specified <span id="en-us_topic_0053158683_text68606276113">BMS</span><span id="en-us_topic_0053158683_text382315715202"></span><span id="en-us_topic_0053158683_text142695224375"></span> Metadata</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section5520708185439"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p44524223185439">This API is used to delete specified <span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text11500134014405">BMS</span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text9501164064011"></span> metadata.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section5072450814374"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p1255315556220">The <span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text51351510112510">BMS</span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text613513105256"></span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text1413514101258"></span> <strong id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_b31351610142516">OS-EXT-STS:vm_state</strong> attribute (<span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text151352106254">BMS</span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text513617104252"></span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text613651032512"></span> status) must be <strong id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_b9136510152518">active</strong>, <strong id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_b14136181012516">stopped</strong>, or <strong id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_b13136171032513">paused</strong>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section65173692185439"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p54025806185439">DELETE /v2.1/{project_id}/servers/{server_id}/metadata/{key}</p>
<p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p15834927173614"><a href="#EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_table12474435113619">Table 1</a> lists the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_table12474435113619"></a><a name="en-us_topic_0053158683_table12474435113619"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_table12474435113619" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_row1947413503615"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.4.2.4.1.1"><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p54886041185439">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.4.2.4.1.2"><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p16584368185439">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.4.2.4.1.3"><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p1156530185439">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_row16474735103610"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.1 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p4696221185439">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.2 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p44849621185439">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.3 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p8940698185439">Specifies the project ID.</p>
<p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p9141450142010">For how to obtain the project ID, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328009.html" target="_blank" rel="noopener noreferrer">Obtaining Required Information</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_row12474113573619"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.1 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p8209263185439">server_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.2 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p60970546185439">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.3 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p39667165185439">Specifies the <span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text206021412192517">BMS</span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text18602111242513"></span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text1760281282512"></span> ID.</p>
<p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p29791113277">You can obtain the BMS ID from the <span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0113746489_text895314101319">BMS</span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0113746489_text1695320481317"></span> console or by calling the API <a href="en-us_topic_0000002340063012.html">Querying BMSs</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_row16474835173611"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.1 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p48209085185622">key</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.2 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p12621798185622">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.3 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p15732716185622">Specifies the <span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text18734141311421">BMS</span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text1573681354217"></span> metadata key value to be deleted.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section21460169185439"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p11644491245">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section8250699363"><h4 class="sectiontitle">Example Request</h4><div class="p" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p96661540145616">Deleting metadata of a <span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text45712332573">BMS</span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text1157143335715"></span><span id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_text4571933155718"></span> (ID: 95bf2490-5428-432c-ad9b-5e3406f869dd)<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_screen18739133511210"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">DELETE</span><span class="w"> </span><span class="n">https</span><span class="p">:</span><span class="c1">//{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata/{key}</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section31286738185439"><h4 class="sectiontitle">Response</h4><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_p25637144185815">N/A</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section27037160"><h4 class="sectiontitle">Returned Values</h4><div class="p" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_p1271142611013">Normal values
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_table753804619176" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_row10735134615172"><th align="left" class="cellrowborder" valign="top" width="42.42%" id="mcps1.3.7.2.1.1.3.1.1"><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_p19735204616177">Returned Values</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.58%" id="mcps1.3.7.2.1.1.3.1.2"><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_p207355465176">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_row1473514621713"><td class="cellrowborder" valign="top" width="42.42%" headers="mcps1.3.7.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_p13735144611178">204</p>
</td>
<td class="cellrowborder" valign="top" width="57.58%" headers="mcps1.3.7.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_p81516575011">The server has processed the request but did not return any content.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0053158659_p47633965">For details about other returned values, see <a href="en-us_topic_0053158690.html">Status Codes</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_section14752650154917"><h4 class="sectiontitle">Error Codes</h4><p id="EN-US_TOPIC_0000002340063028__en-us_topic_0053158683_en-us_topic_0106040941_p10243161417491">See <a href="en-us_topic_0107541808.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0000002340063024.html">BMS Metadata Management (OpenStack Nova APIs)</a></div>
</div>
</div>