# Deleting a Tag of a BMS (Native OpenStack API)

#### Function

This API is used to delete a tag of a BMS.

You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.

#### Constraints

- The tag contains a maximum of 80 characters.
- If a tag contains non-URL-safe characters, perform URL encoding.

- Tag __type_baremetal is used to identify a BMS. You are not advised to delete this tag. Otherwise, the BMS will be displayed only on the ECS console.
- After deleting the __type_baremetal tag, you can add it again by following the instructions in Adding a Tag to a BMS (Native OpenStack API). After the tag is added, the BMS will be displayed on the BMS console.

#### URI

DELETE /v2.1/{project_id}/servers/{server_id}/tags/{tag}

Table 1 lists the parameters.

Table 1 Parameter description
Parameter | Mandatory | Description
--- | --- | ---
project_id | Yes | Specifies the project ID. For how to obtain the project ID, see Obtaining Required Information.
server_id | Yes | Specifies the BMS ID. You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API.

tag

Yes

Specifies the tag information.

Constraints:

- A tag can contain a maximum of 80 characters. If a tag contains non-URL-safe characters, perform URL encoding.
- If no key is specified, all tags of the BMS are deleted.

#### Request

- Request parameters

  None

- Example request

      1

      DELETE https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags/{tag}

#### Response

N/A

#### Returned Values

Normal values

Returned Values | Description
--- | ---
204 | The server has processed the request but did not return any content.

For details about other returned values, see Status Codes.

#### Error Codes

See Error Codes.

Parent topic: BMS 1D Tag Management