All Products
Search
Document Center

ApsaraVideo Media Processing:AddMediaTag

Last Updated:Mar 03, 2024

Adds a tag to a media file.

Operation description

You can call this operation to add only one tag. To add multiple tags at a time, you can call the UpdateMedia operation.

QPS limit

You can call this operation up to 100 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limit.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
MediaIdstringYes

The ID of the media file to which you want to add tags.

Note 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 file that you want to manage and click Manage in the Actions column. The ID of the file is displayed on the Basics tab.
3e6149d5a8c944c09b1a8d2dc3e4****
TagstringNo

The tag that you want to add to the medial file. The value is encoded in UTF-8 and can be up to 32 bytes in length.

tag1

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

91B6CAB9-034C-4E4E-A40B-E7F5C81E1A2K

Examples

Sample success responses

JSONformat

{
  "RequestId": "91B6CAB9-034C-4E4E-A40B-E7F5C81E1A2K"
}

Error codes

For a list of error codes, visit the Service error codes.