All Products
Search
Document Center

ApsaraVideo VOD:UpdateAttachedMediaInfos

更新時間:Jul 29, 2024

Modifies the information about multiple auxiliary media assets such as watermark images, subtitle files, and materials in a batch based on IDs. You can modify information such as the title, description, tags, and category.

Operation description

You can modify the information about up to 20 auxiliary media assets at a time.

Debugging

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

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
vod:UpdateAttachedMediaInfos
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
UpdateContentstringYes

The new information about the one or more images. You can modify the information about up to 20 auxiliary media assets at a time. For more information, see the UpdateContent section of this topic.

Note
  • You cannot specify emojis for Title, Description, or Tags.
  • The specific parameter of a video is updated only when a new value is passed in the parameter.
  • [{"MediaId ":"bbc65bba53f6ed90de118a7849****","Title":" test title1","Description":"test description1","Tags":"tag1,tag2"},{"MediaId ":"f45cf4eba5cb90233389558c39****","Title2":"test title2","Description2":"test description2","Tags":"tag3,tag4"}]

    UpdateContent

    Note You must convert the UpdateContent parameter to a string before you pass it in.

    ParameterTypeRequiredDescription
    MediaIdStringYesThe ID of the auxiliary media asset. You can obtain the ID from the response to the CreateUploadAttachedMedia operation.
    TitleStringNoThe title. The title cannot exceed 128 bytes. The value must be encoded in UTF-8.
    DescriptionStringNoThe description. The description can be up to 1,024 bytes in length. The value must be encoded in UTF-8.
    TagsStringNoThe tags. Each tag can be up to 32 bytes in length. You can specify up to 16 tags. Separate multiple tags with commas (,). The value must be encoded in UTF-8.
    CateIdsStringNoThe ID of the category. Separate multiple IDs with commas (,). You can obtain the ID by using one of the following methods:Log on to the ApsaraVideo VOD console. In the left-side navigation pane, choose Configuration Management > Media Management >Categories. On the page that appears, view the category ID.Obtain the category ID from the response to the AddCategory operation that you call to create a category.Obtain the category ID from the response to the GetCategories operation that you call to query categories.

    Response parameters

    ParameterTypeDescriptionExample
    object

    The response parameters.

    RequestIdstring

    The ID of the request.

    25818875-5F78-4DF6-D7393642CA58****
    NonExistMediaIdsarray

    The IDs of the auxiliary media assets that do not exist.

    string

    The ID of the auxiliary media assets that does not exist.

    ["bbc65bba53f6ed90de118a7849****"]

    Examples

    Sample success responses

    JSONformat

    {
      "RequestId": "25818875-5F78-4DF6-D7393642CA58****",
      "NonExistMediaIds": [
        "[\"bbc65bba53f6ed90de118a7849****\"]"
      ]
    }

    Error codes

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