• Distributed Message Service

dms
  1. Help Center
  2. Distributed Message Service
  3. API Reference
  4. APIs for Managing Queue Tags
  5. Deleting a Queue Tag

Deleting a Queue Tag

Function

This API is used to delete a queue tag. If the key of the tag to be deleted is empty or an empty string, status code 400 is returned. If the key of the tag to be deleted does not exist, status code 404 is returned.

This API is idempotent.

URI

URI format: DELETE /v1.0/{project_id}/queue/{queue_id}/tags/{key}

Table 1 Request header

Parameter

Description

Mandatory or Not

Example

Content-type

Indicates the MIME types of a request body.

Yes

application/json

X-Auth-Token

Indicates the user token.

Yes

-

Table 2 Parameter description

Parameter

Mandatory or Not

Type

Description

project_id

Yes

String

Indicates the ID of a project.

queue_id

Yes

String

Indicates the queue ID.

key

Yes

String

Indicates a tag key.

Example

 /v1.0/67c01b92944144a19d2da968ef34a912/queue/dd713484-e0b6-4e70-9942-4250e773d17c/tags/T123

Request

Request parameters

None.

Example request

None.

Response

Response parameters

None.

Example response

None.

Status Code

Status Code

Description

204

No content.

400

Invalid parameter.

401

Authentication failed.

403

Insufficient permission.

404

No queue is found or the key does not exist.

500

System error.