doc-exports/docs/ecs/api-ref/en-us_topic_0065820827.html
Zaoxu, Li 4edaa4a4cc ECS API 20231016 version
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com>
Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
2024-04-29 11:04:13 +00:00

66 lines
6.6 KiB
HTML

<a name="EN-US_TOPIC_0065820827"></a><a name="EN-US_TOPIC_0065820827"></a>
<h1 class="topictitle1">Deleting a Specified Tag from an <span id="text530862012568">ECS</span></h1>
<div id="body1499653398051"><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p51895228">This API is used to delete a specified tag from an <span id="EN-US_TOPIC_0065820827__text135811711418">ECS</span>.</p>
<p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p872964351214">You are required to use the HTTP header <strong id="EN-US_TOPIC_0065820827__b842352706165643">X-OpenStack-Nova-API-Version: 2.26</strong> to specify the microversion on the client.</p>
<div class="section" id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_section47071996222837"><h4 class="sectiontitle">Constraints</h4><ul id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_ul4426844522290"><li id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_li4120266122290">The tag contains a maximum of 80 characters.</li><li id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_li1615894722290">If a tag contains non-URL-safe characters, perform URL encoding.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_section49330940"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p17816132418199">DELETE /v2.1/{project_id}/servers/{server_id}/tags/{tag}</p>
<div class="p" id="EN-US_TOPIC_0065820827__p663824913614"><a href="#EN-US_TOPIC_0065820827__en-us_topic_0057972842_table536172734712">Table 1</a> describes the parameters in the URI.
<div class="tablenoborder"><a name="EN-US_TOPIC_0065820827__en-us_topic_0057972842_table536172734712"></a><a name="en-us_topic_0057972842_table536172734712"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_table536172734712" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_row103712714716"><th align="left" class="cellrowborder" valign="top" width="22.24%" id="mcps1.3.4.3.2.2.4.1.1"><p id="EN-US_TOPIC_0065820827__p5187119">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.87%" id="mcps1.3.4.3.2.2.4.1.2"><p id="EN-US_TOPIC_0065820827__p17503500">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.88999999999999%" id="mcps1.3.4.3.2.2.4.1.3"><p id="EN-US_TOPIC_0065820827__p8497414">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_row0411327194717"><td class="cellrowborder" valign="top" width="22.24%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p942327144718">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="21.87%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p164222714475">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="55.88999999999999%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0065820827__p37593705">Specifies the project ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_row17438272471"><td class="cellrowborder" valign="top" width="22.24%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p14448270471">server_id</p>
</td>
<td class="cellrowborder" valign="top" width="21.87%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p11458272478">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="55.88999999999999%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p845102714478">Specifies the <span id="EN-US_TOPIC_0065820827__text040121512399">ECS</span> ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_row255344913344"><td class="cellrowborder" valign="top" width="22.24%" headers="mcps1.3.4.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p8553134913345">tag</p>
</td>
<td class="cellrowborder" valign="top" width="21.87%" headers="mcps1.3.4.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p05531249143414">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="55.88999999999999%" headers="mcps1.3.4.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p04316297356">Specifies the key of the tag to be deleted. If no key is specified, all tags of the <span id="EN-US_TOPIC_0065820827__text3163734135618">ECS</span> will be deleted.</p>
<p id="EN-US_TOPIC_0065820827__p141334271371">For details about key rules, see <a href="en-us_topic_0065817686.html">Tag Types</a>.</p>
<div class="note" id="EN-US_TOPIC_0065820827__note124521913175616"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0065820827__p1745221311560">Tag functions have been upgraded on the cloud platform. If the tags added before the function upgrade are in the format of "Key.Value", delete tags using "Key".</p>
<p id="EN-US_TOPIC_0065820827__p213418685710">For example, an existing tag is <strong id="EN-US_TOPIC_0065820827__b84235270610509">a.b</strong>. After the tag function upgrade, delete the tag using "a".</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_section41325284"><h4 class="sectiontitle">Request</h4><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p2496628719319">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_section36383236"><h4 class="sectiontitle">Response</h4><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_p33552830193214">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0065820827__section28931627710"><h4 class="sectiontitle">Example Request</h4><p id="EN-US_TOPIC_0065820827__p33535414123">Delete a specified tag from a specified ECS.</p>
<pre class="screen" id="EN-US_TOPIC_0065820827__screen0277659163916">DELETE https://{endpoint}/v2.1/{project_id}/servers/{server_id}/tags/{tag}</pre>
</div>
<div class="section" id="EN-US_TOPIC_0065820827__section179263403114"><h4 class="sectiontitle">Example Response</h4><p id="EN-US_TOPIC_0065820827__p1912820441612">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_en-us_topic_0020212692_section22960139"><h4 class="sectiontitle">Returned Values</h4><p id="EN-US_TOPIC_0065820827__en-us_topic_0057972842_en-us_topic_0020212692_p23670760">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_0108433460.html">Tag Management</a></div>
</div>
</div>