Help Center/ Direct Connect/ API Reference/ API/ Tag Management/ Deleting a Resource Tag
Updated on 2025-08-13 GMT+08:00
View PDF

Deleting a Resource Tag

Function

When a tag is deleted, the tag character set is not verified. Before calling this API, perform the encodeURI operation. The server must perform decodeURI on the API URI. The tag key cannot be left blank or be an empty string. If the key of the tag to be deleted is not found, 404 will be returned.

Debugging

For details, see Calling APIs.

URI

DELETE /v3/{project_id}/{resource_type}/{resource_id}/tags/{key}

Table 1 URI parameters

Parameter

Mandatory

Type

Description

key

Yes

String

Specifies the tag key.

project_id

Yes

String

Specifies the project ID.

resource_id

Yes

String

Specifies the resource ID.

resource_type

Yes

String
  • Specifies the Direct Connect resource type. The value can be dc-directconnect, dc-vgw, or dc-vif.
  • dc-directconnect: Direct Connect connection
  • dc-vgw: virtual gateway
  • dc-vif: virtual interface

Enumeration values:

  • dc-directconnect
  • dc-vgw
  • dc-vif

Request Parameters

None

Response Parameters

None

Example Requests

Deleting a resource tag

DELETE https://{dc-endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/instance/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags/key1

Example Responses

None

Status Code

Status Code

Description

204

No Content

Error Codes

See Error Codes.

Parent Topic: Tag Management