Removes a tag for a media file.

Usage notes

You can call this operation to remove only one tag at a time.

Limits on QPS

You can call this operation up to 100 times per second. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limits.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteMediaTag

The operation that you want to perform. Set the value to DeleteMediaTag.

MediaId String Yes 3e6149d5a8c944c09b1a8d2dc3e4****

The ID of the media file for which you want to remove a tag. To obtain the ID of a media file, you can call the AddMedia operation. Alternatively, perform the following operations in the ApsaraVideo Media Processing (MPS) console: In the left-side navigation pane, choose Media Management > Media List. Find the required video and click Manage. The ID of the video is displayed on the Basics tab.

Tag String No tag1

The media tag that you want to remove. The value is encoded in UTF-8 and can be up to 32 bytes in length.

Note You can remove only one tag at a time.

Response parameters

Parameter Type Example Description
RequestId String 283DC68C-146F-4489-A2A1-2F88F1472A56

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "283DC68C-146F-4489-A2A1-2F88F1472A56"

Error codes

For a list of error codes, visit the API Error Center.