全部產品
Search

搜尋本產品

    ApsaraVideo VOD：UpdateAttachedMediaInfos

    文件中心

    ApsaraVideo VOD：UpdateAttachedMediaInfos

    更新時間：Jul 21, 2026

    當將帶有浮水印的圖片、字幕檔案或其它素材等輔助媒體資源上傳至影片點播後，可以透過本介面依據這些輔助媒體的唯一識別碼（ID），批次更新它們的標題、描述、標籤及分類等資訊。

    介面說明

    一次最多支援修改 20 個輔助媒資的資訊。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:UpdateAttachedMediaInfos

    update

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    UpdateContent

    string

    是

    更新內容。一次最多支援修改 20 個輔助媒資資訊。參數結構請參考下表更新內容 UpdateContent。

    說明

    • Title、Description、Tags 更新內容中不能包含表情符號。

    • 傳入參數則更新相應欄位，否則相應欄位不會被覆蓋或更新。

    [{"MediaId":"bbc65bba53f6ed90de118a7849****","Title":" title1","Description":" description1","Tags":" tag1, tag2"},{"MediaId":"f45cf4eba5cb90233389558c39****","Title2":" title","Description2":" description","Tags":" tag3, tag4"}]

    更新內容 UpdateContent

    說明

    UpdateContent 的取值需要轉為 String 後作為傳入參數。

    名稱類型是否必需描述
    MediaIdString是輔助媒資 ID。呼叫 CreateUploadAttachedMedia 介面後會返回。
    TitleString否標題。長度不超過 128 個位元組。UTF-8 編碼。
    DescriptionString否描述。長度不超過 1024 個位元組。UTF-8 編碼。
    TagsString否標籤。單個標籤不超過 32 位元組。最多不超過 16 個標籤。多個標籤之間使用半形逗號（,）分隔。UTF-8 編碼。
    CateIdsString否分類 ID。多個 ID 之間使用半形逗號（,）分隔。可透過以下方式取得：
    登入點播控制台，選擇配置管理 > 媒資管理配置 > 分類管理，檢視分類 ID。
    呼叫 AddCategory 介面建立分類時會返回。
    呼叫 GetCategories 介面查詢分類時會返回。







    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

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

    array

    不存在的輔助媒資 ID 清單。

    string

    不存在的輔助媒資 ID 清單。

    ["bbc65bba53f6ed90de118a7849****"]

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。