doc-exports/docs/ecs/api-ref/en-us_topic_0020212666.html
Artem Goncharov 3196b64bfc
move doc sources to other location (#3)
move doc sources to other location

Reviewed-by: OpenTelekomCloud Bot <None>
2022-04-27 16:24:25 +00:00

75 lines
6.4 KiB
HTML

<a name="EN-US_TOPIC_0020212666"></a><a name="EN-US_TOPIC_0020212666"></a>
<h1 class="topictitle1">Deleting a NIC from an <span id="text168974155020">ECS</span></h1>
<div id="body35162951"><div class="section" id="EN-US_TOPIC_0020212666__section12502218"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0020212666__p29626789">This API is used to delete a NIC from an <span id="EN-US_TOPIC_0020212666__text144341842135019">ECS</span> based on the port ID.</p>
</div>
<div class="section" id="EN-US_TOPIC_0020212666__section1198904415453"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0020212666__p15673547194516">The primary NIC of an <span id="EN-US_TOPIC_0020212666__text184281326318">ECS</span> has routing rules configured and cannot be deleted.</p>
<p id="EN-US_TOPIC_0020212666__p184571144539">When an ECS NIC is detached, all NICs attached to the ECS through the OpenStack Nova API will be deleted.</p>
</div>
<div class="section" id="EN-US_TOPIC_0020212666__section45411103"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0020212666__p1898716519528">DELETE /v2.1/{project_id}/servers/{server_id}/os-interface/{port_id}{?reserve_port}</p>
<p id="EN-US_TOPIC_0020212666__p466705414327">DELETE /v2/{project_id}/servers/{server_id}/os-interface/{port_id}{?reserve_port}</p>
<div class="p" id="EN-US_TOPIC_0020212666__p1160414294458"><a href="#EN-US_TOPIC_0020212666__table34333880">Table 1</a> describes the parameters in the URI.
<div class="tablenoborder"><a name="EN-US_TOPIC_0020212666__table34333880"></a><a name="table34333880"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020212666__table34333880" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0020212666__row1561146"><th align="left" class="cellrowborder" valign="top" width="16.98%" id="mcps1.3.3.4.2.2.4.1.1"><p id="EN-US_TOPIC_0020212666__p5187119">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.37%" id="mcps1.3.3.4.2.2.4.1.2"><p id="EN-US_TOPIC_0020212666__p17503500">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="65.64999999999999%" id="mcps1.3.3.4.2.2.4.1.3"><p id="EN-US_TOPIC_0020212666__p8497414">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0020212666__row34896348"><td class="cellrowborder" valign="top" width="16.98%" headers="mcps1.3.3.4.2.2.4.1.1 "><p id="EN-US_TOPIC_0020212666__p8031928">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="17.37%" headers="mcps1.3.3.4.2.2.4.1.2 "><p id="EN-US_TOPIC_0020212666__p46606392">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="65.64999999999999%" headers="mcps1.3.3.4.2.2.4.1.3 "><p id="EN-US_TOPIC_0020212666__p37593705">Specifies the project ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020212666__row4716221165950"><td class="cellrowborder" valign="top" width="16.98%" headers="mcps1.3.3.4.2.2.4.1.1 "><p id="EN-US_TOPIC_0020212666__p42445993165950">server_id</p>
</td>
<td class="cellrowborder" valign="top" width="17.37%" headers="mcps1.3.3.4.2.2.4.1.2 "><p id="EN-US_TOPIC_0020212666__p15573376165950">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="65.64999999999999%" headers="mcps1.3.3.4.2.2.4.1.3 "><p id="EN-US_TOPIC_0020212666__p53483964165950">Specifies the <span id="EN-US_TOPIC_0020212666__text692911419383">ECS</span> ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020212666__row18974699"><td class="cellrowborder" valign="top" width="16.98%" headers="mcps1.3.3.4.2.2.4.1.1 "><p id="EN-US_TOPIC_0020212666__p60555637">port_id</p>
</td>
<td class="cellrowborder" valign="top" width="17.37%" headers="mcps1.3.3.4.2.2.4.1.2 "><p id="EN-US_TOPIC_0020212666__p6059584">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="65.64999999999999%" headers="mcps1.3.3.4.2.2.4.1.3 "><p id="EN-US_TOPIC_0020212666__p21064308">Specifies the port ID of the NIC.</p>
<div class="note" id="EN-US_TOPIC_0020212666__note2787378017659"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0020212666__p4953742817659">When the ID is the same as the <span id="EN-US_TOPIC_0020212666__text45401463505">ECS</span> primary NIC ID, the system will return error code 403.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0020212666__row16385916495"><td class="cellrowborder" valign="top" width="16.98%" headers="mcps1.3.3.4.2.2.4.1.1 "><p id="EN-US_TOPIC_0020212666__p1738149194916">reserve_port</p>
</td>
<td class="cellrowborder" valign="top" width="17.37%" headers="mcps1.3.3.4.2.2.4.1.2 "><p id="EN-US_TOPIC_0020212666__p11382919491">No</p>
</td>
<td class="cellrowborder" valign="top" width="65.64999999999999%" headers="mcps1.3.3.4.2.2.4.1.3 "><p id="EN-US_TOPIC_0020212666__p1138179154913">Indicates whether to retain the NIC port after the NIC is unbound.</p>
<p id="EN-US_TOPIC_0020212666__p15127134211502"><strong id="EN-US_TOPIC_0020212666__b842352706151144">True</strong>: indicates that the port is reserved.</p>
<p id="EN-US_TOPIC_0020212666__p1983020535501"><strong id="EN-US_TOPIC_0020212666__b842352706151226">False</strong>: indicates that the port is deleted. This is the default value.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0020212666__section6046746"><h4 class="sectiontitle">Request</h4><p id="EN-US_TOPIC_0020212666__p55059575">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0020212666__section54420716"><h4 class="sectiontitle">Response</h4><p id="EN-US_TOPIC_0020212666__p30640599">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0020212666__section05727183616"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="EN-US_TOPIC_0020212666__screen17448426201916">DELETE https://{endpoint}/v2/{project_id}/servers/{server_id}/os-interface/{port_id}
DELETE https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface/{port_id}</pre>
</div>
<div class="section" id="EN-US_TOPIC_0020212666__section712919176361"><h4 class="sectiontitle">Example Response</h4><p id="EN-US_TOPIC_0020212666__p15444182715367">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0020212666__section20024398"><h4 class="sectiontitle">Returned Values</h4><p id="EN-US_TOPIC_0020212666__p65969435">See <a href="en-us_topic_0022067716.html">Returned Values for General Requests</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0020212660.html">NIC Management</a></div>
</div>
</div>