Files
doc-exports/docs/bms/api-ref/en-us_topic_0107658627.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

85 lines
10 KiB
HTML

<a name="EN-US_TOPIC_0107658627"></a><a name="EN-US_TOPIC_0107658627"></a>
<h1 class="topictitle1">Detaching an EVS Disk from a <span id="text1027592519399">BMS</span><span id="text0253427195218"></span><span id="text581682754612"></span></h1>
<div id="body1524140242686"><div class="section" id="EN-US_TOPIC_0107658627__section178925211771"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0107658627__p171255416309">This API is used to detach a disk from a <span id="EN-US_TOPIC_0107658627__text3193165751811">BMS</span><span id="EN-US_TOPIC_0107658627__text131935571185"></span>.</p>
<ul id="EN-US_TOPIC_0107658627__ul19983102015815"><li id="EN-US_TOPIC_0107658627__en-us_topic_0102427988_li2948622144736">A disk attached to <strong id="EN-US_TOPIC_0107658627__b9489145819307">/dev/sda</strong> functions as the system disk. You can only detach the system disk from a stopped BMS.</li><li id="EN-US_TOPIC_0107658627__en-us_topic_0102427988_li571809915431">Disks attached to a mount point other than <strong id="EN-US_TOPIC_0107658627__b138161842193119">/dev/sda</strong> function as data disks and can be detached from a running or stopped BMS.<p id="EN-US_TOPIC_0107658627__en-us_topic_0102427988_p9850107928"> </p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0107658627__section1289719216715"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0107658627__p199718219720">If a <span id="EN-US_TOPIC_0107658627__text289452115207">BMS</span><span id="EN-US_TOPIC_0107658627__text178951021162019"></span> is stopped, disks can be detached from it without any constrict on the OS. If a <span id="EN-US_TOPIC_0107658627__text679851013211">BMS</span><span id="EN-US_TOPIC_0107658627__text147981210162116"></span> is running, the constraints are as follows:</p>
<ul id="EN-US_TOPIC_0107658627__ul1997112112716"><li id="EN-US_TOPIC_0107658627__li89995211771">Before detaching an EVS disk from a Linux <span id="EN-US_TOPIC_0107658627__text257585152220">BMS</span><span id="EN-US_TOPIC_0107658627__text1757515192220"></span>, log in to the <span id="EN-US_TOPIC_0107658627__text195769562211">BMS</span><span id="EN-US_TOPIC_0107658627__text11576185122212"></span>, run <strong id="EN-US_TOPIC_0107658627__b2057610532210">unmount</strong> to unmount the disk from the file system, and ensure that no program is reading data from or writing data to the disk. Otherwise, the disk will fail to be detached.</li><li id="EN-US_TOPIC_0107658627__li1499910211875">Before detaching an EVS disk from a Windows <span id="EN-US_TOPIC_0107658627__text15711557249">BMS</span><span id="EN-US_TOPIC_0107658627__text117114520247"></span>, ensure that no program is reading data from or writing data to the disk. Otherwise, data will be lost.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0107658627__section12901162119715"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0107658627__p7279549194920">DELETE /v1/{project_id}/baremetalservers/{server_id}/detachvolume/{attachment_id}</p>
<p id="EN-US_TOPIC_0107658627__p645232714120"><a href="#EN-US_TOPIC_0107658627__table44563816121">Table 1</a> lists the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0107658627__table44563816121"></a><a name="table44563816121"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0107658627__table44563816121" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0107658627__row54714387129"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.4.2.4.1.1"><p id="EN-US_TOPIC_0107658627__p3999521475">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_0107658627__p1999913218711">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_0107658627__p599911215716">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0107658627__row14488384129"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.1 "><p id="EN-US_TOPIC_0107658627__p79999210713">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_0107658627__p179992215718">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_0107658627__p19996217710">Specifies the project ID.</p>
<p id="EN-US_TOPIC_0107658627__p652825144113">For details about how to obtain the project ID, see <a href="en-us_topic_0171277624.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0107658627__row1148143851211"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.1 "><p id="EN-US_TOPIC_0107658627__p17999121274">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_0107658627__p149996213711">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_0107658627__p1999916218716">Specifies the <span id="EN-US_TOPIC_0107658627__text137116141246">BMS</span><span id="EN-US_TOPIC_0107658627__text27171413241"></span> ID.</p>
<p id="EN-US_TOPIC_0107658627__p29791113277">You can obtain the BMS ID from the <span id="EN-US_TOPIC_0107658627__en-us_topic_0113746489_text895314101319">BMS</span><span id="EN-US_TOPIC_0107658627__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_0107658627__row1418094715121"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.4.2.4.1.1 "><p id="EN-US_TOPIC_0107658627__p13999162114716">attachment_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_0107658627__p9999621677">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_0107658627__p119990216718">Specifies the IDs of EVS disks attached to the <span id="EN-US_TOPIC_0107658627__text94701544112410">BMS</span><span id="EN-US_TOPIC_0107658627__text5470164492410"></span>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0107658627__section592518211471"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0107658627__p1484171614315">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0107658627__section17577218827"><h4 class="sectiontitle">Example Request</h4><div class="p" id="EN-US_TOPIC_0107658627__p1355644318911">Detaching an EVS disk (ID: 6b604cef-9bd8-4f5a-ae56-45839e6e1f0a) from a <span id="EN-US_TOPIC_0107658627__text266731472811">BMS</span><span id="EN-US_TOPIC_0107658627__text7802430369"></span><span id="EN-US_TOPIC_0107658627__text549771912419"></span> (ID: cf2a8b97-b5c6-47ef-9714-eb27adf26e5b)<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0107658627__screen13161768326"><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">//{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/detachvolume/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0107658627__section3925182116719"><h4 class="sectiontitle">Response</h4><p id="EN-US_TOPIC_0107658627__p54575646">See <a href="en-us_topic_0131356399.html">Task ID Response</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0107658627__section7610951"><h4 class="sectiontitle">Returned Values</h4><div class="p" id="EN-US_TOPIC_0107658627__en-us_topic_0107658564_p06917254610">Normal values
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_table753804619176" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_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_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_p19735204616177">Returned Value</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_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_p207355465176">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_row1473514621713"><td class="cellrowborder" valign="top" width="42.42%" headers="mcps1.3.7.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_p13735144611178">202</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_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_p207351246161711">The request has been accepted, but the processing has been delayed.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<p id="EN-US_TOPIC_0107658627__en-us_topic_0107658564_en-us_topic_0106040941_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_0107658627__section14752650154917"><h4 class="sectiontitle">Error Codes</h4><p id="EN-US_TOPIC_0107658627__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_0113746491.html">BMS Disk Management</a></div>
</div>
</div>