doc-exports/docs/ecs/api-ref/en-us_topic_0065820827.html

Deleting a Specified Tag from an ECS

This API is used to delete a specified tag from an ECS.

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

Constraints

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

URI

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

Table 1 describes the parameters in the URI.

Table 1 Parameter description

Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID.
server_id	Yes	Specifies the ECS ID.
tag	Yes	Specifies the key of the tag to be deleted. If no key is specified, all tags of the ECS will be deleted. For details about key rules, see Tag Types. NOTE: Tag functions have been upgraded on the public cloud. If the tags added before the function upgrade are in the format of "Key.Value", delete tags using "Key". For example, an existing tag is a.b. After the tag function upgrade, delete the tag using "a".

Request

None

Response

None

Example Request

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

Example Response

None

Returned Values

See Returned Values for General Requests.

Parent topic: Tag Management