doc-exports/docs/bms/api-ref/en-us_topic_0107658627.html
guoyanyan c311ecafe3 bms_api_0510
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>
2023-10-11 08:28:11 +00:00

85 lines
9.8 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__text3754282715">BMS</span><span id="EN-US_TOPIC_0107658627__text6754178379"></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__text10827133315521">BMS</span><span id="EN-US_TOPIC_0107658627__text1968164914717"></span> is stopped, disks can be detached from it without any constraints on the OS. If a <span id="EN-US_TOPIC_0107658627__text19717385522">BMS</span><span id="EN-US_TOPIC_0107658627__text997163825212"></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__text1765813412523">BMS</span><span id="EN-US_TOPIC_0107658627__text1865874116526"></span>, log in to the <span id="EN-US_TOPIC_0107658627__text96795441525">BMS</span><span id="EN-US_TOPIC_0107658627__text5679644165216"></span>, run the <strong id="EN-US_TOPIC_0107658627__b149995211072">unmount</strong> command to disassociate the disk to be detached 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__text13869144885213">BMS</span><span id="EN-US_TOPIC_0107658627__text20870548135211"></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__text279718333575">BMS</span><span id="EN-US_TOPIC_0107658627__text0797123365720"></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_text013014803615">BMS</span><span id="EN-US_TOPIC_0107658627__en-us_topic_0113746489_text10131448133612"></span> console or by calling the <a href="en-us_topic_0053158693.html">Querying BMSs (Native OpenStack API)</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 the EVS disks attached to the <span id="EN-US_TOPIC_0107658627__text93625576529">BMS</span><span id="EN-US_TOPIC_0107658627__text15362757185210"></span>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0107658627__section592518211471"><h4 class="sectiontitle">Request</h4><ul id="EN-US_TOPIC_0107658627__ul15691175353117"><li id="EN-US_TOPIC_0107658627__li15425612144311">Request parameters<p id="EN-US_TOPIC_0107658627__p1484171614315"><a name="EN-US_TOPIC_0107658627__li15425612144311"></a><a name="li15425612144311"></a>None</p>
</li><li id="EN-US_TOPIC_0107658627__li469111538319">Example request<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>
</li></ul>
</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.6.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.6.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.6.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.6.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>