全部產品
Search

搜尋本產品

    ApsaraVideo VOD：GetAttachedMediaInfo

    文件中心

    ApsaraVideo VOD：GetAttachedMediaInfo

    更新時間：Jul 21, 2026

    當浮水印圖片、字幕檔案、素材等輔助媒體資源上傳到影片點播後，可以呼叫本介面傳入多個輔助媒體資源 ID 以批次取得輔助媒體資源的基本資訊及存取位址。

    介面說明

    一次最多支援取得 20 個輔助媒體資源的資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetAttachedMediaInfo

    get

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    MediaIds

    string

    是

    輔助媒體資源 ID。

    • 多個 ID 之間使用半形逗號（,）分隔，最多支援 20 個 ID。

    • 呼叫 CreateUploadAttachedMedia 介面取得輔助媒體資源上傳位址和憑證後，會返回此參數。

    eb1861d2c9a842340e989dd56****,0222e203cf80f9c22870a4d2c****
    AuthTimeout

    integer

    否

    輔助媒體資源位址過期時間，單位：秒。

    • 如果 OutputType 取值為 cdn：

      • 只有開啟了 URL 驗證的輔助媒體資源位址才會過期失效，否則會永久有效。

      • 最小值：1。

      • 最大值：無限制。

      • 預設值：未設定時，取值為 URL 驗證中設定的預設有效時長。

    • 如果 OutputType 取值為 oss：

      • 只有儲存權限為私有，輔助媒體資源位址才會過期失效，否則會永久有效。

      • 最小值：1。

      • 最大值：為降低來源站安全風險，當輔助媒體資源儲存在點播系統 Bucket 上時，最大值為 2592000（即 30 天），當輔助媒體資源儲存在 OSS 自有 Bucket 上時，最大值為 129600（即 36 小時）。

      • 預設值：未設定時，取值為 3600。

    3600
    OutputType

    string

    否

    輸定位址類型。取值：

    • oss：回源位址。

    • cdn（預設）：加速位址。

    oss

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    221BCB57-B217-42BF-619BD13378F9****
    NonExistMediaIds

    array

    不存在的輔助媒體資源 ID。

    string

    不存在的輔助媒體資源 ID。

    eb1861d2c9a842340e989dd56****
    AttachedMediaList

    array<object>

    輔助媒體資源資訊清單。

    array<object>

    輔助媒體資源詳情。

    Type

    string

    輔助媒體資源類型。

    • watermark：浮水印。

    • subtitle：字幕。

    • material：素材。

    subtitle
    StorageLocation

    string

    輔助媒體資源的儲存位址。

    outin-bfefbb9*****c7426.oss-cn-shanghai.aliyuncs.com
    CreationTime

    string

    輔助媒體資源建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-01-01T10:00:00Z
    Status

    string

    輔助媒體資源狀態。取值：

    • Uploading：上傳中。

    • Normal：正常。

    • UploadFail：上傳失敗。

    Normal
    Tags

    string

    標籤。

    說明

    僅當輔助媒體資源有標籤資訊時，才會返回此參數。

    tag1,tag2
    ModificationTime

    string

    輔助媒體資源的最後更新時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2020-05-31T11:42:20Z
    MediaId

    string

    輔助媒體資源 ID。

    0222e203cf80f9c22870a4d2c****
    Description

    string

    描述。

    說明

    僅當輔助媒體資源有描述資訊時，才會返回此參數。

    Description test
    AppId

    string

    應用程式 ID。

    app-*****
    URL

    string

    輔助媒體資源的存取位址。

    說明

    如果點播設定了 CDN 網域則為 CDN 位址，否則為 OSS 位址。

    https://al*****.cn/subtitle/9843C2*****4E186F19B6.vtt?auth_key=159099f60e0b7fd59****
    Title

    string

    標題。

    Subtitle test
    Categories

    array<object>

    分類清單。

    object

    分類詳情。

    ParentId

    integer

    父分類別識別碼。

    1000224336
    CateName

    string

    分類名稱。

    测试
    CateId

    integer

    分類別識別碼。

    1000224338
    Level

    integer

    分類層級。

    0

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "221BCB57-B217-42BF-619BD13378F9****",
  "NonExistMediaIds": [
    "eb1861d2c9a842340e989dd56****"
  ],
  "AttachedMediaList": [
    {
      "Type": "subtitle",
      "StorageLocation": "outin-bfefbb9*****c7426.oss-cn-shanghai.aliyuncs.com",
      "CreationTime": "2019-01-01T10:00:00Z",
      "Status": "Normal",
      "Tags": "tag1,tag2",
      "ModificationTime": "2020-05-31T11:42:20Z",
      "MediaId": "0222e203cf80f9c22870a4d2c****",
      "Description": "描述测试",
      "AppId": "app-*****",
      "URL": "https://al*****.cn/subtitle/9843C2*****4E186F19B6.vtt?auth_key=159099f60e0b7fd59****",
      "Title": "字幕测试",
      "Categories": [
        {
          "ParentId": 1000224336,
          "CateName": "测试",
          "CateId": 1000224338,
          "Level": 0
        }
      ]
    }
  ]
}

    錯誤碼

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

    變更歷史

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