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 descriptionParameter
|
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
| DELETE https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags/{tag}
|
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.