全部產品
Search

搜尋本產品

    ApsaraVideo VOD：GetUploadDetails - 擷取媒體上傳詳情

    文件中心

    ApsaraVideo VOD：GetUploadDetails - 擷取媒體上傳詳情

    更新時間：Dec 15, 2025

    通過媒體ID擷取媒體上傳詳情（如上傳時間、已上傳比例、上傳來源等資訊），支援批量擷取。

    介面說明

    • 本介面只支援擷取音/視頻的上傳詳情。

    • 如果通過點播控制台上傳的音/視頻，通過本介面可擷取到上傳比例等資訊。如果是使用 SDK 上傳的音/視頻，滿足以下條件的上傳 SDK才能通過本介面擷取到媒體上傳詳情。

    說明

    僅服務端上傳 SDK 支援本介面，用戶端上傳 SDK 暫不支援本介面。本介面支援的服務端上傳 SDK 版本限制如下：

    • Java 上傳 SDK 的版本 ≥ 1.4.4

    • C++上傳 SDK 的版本 ≥ 1.0.0

    • PHP 上傳 SDK 的版本 ≥ 1.0.2

    • Python 上傳 SDK 的版本 ≥ 1.3.0

    QPS 限制

    本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetUploadDetails

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    MediaIds

    string

    是

    媒體 ID，即音/視頻 ID（VideoId）。多個 ID 之間使用半形逗號（,）分隔，最多支援 20 個。可通過以下方式擷取：

    61ccbdb06fa83012be4d8083f6****,7d2fbc380b0e08e55f****
    MediaType

    string

    否

    媒體類型。取固定值：video（音/視頻）。

    video

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    9E290613-04F4-47F4-795D30732077****
    ForbiddenMediaIds

    array

    禁止訪問的媒體 ID。

    string

    禁止訪問的媒體 ID。

    7d2fbc380b0e08e55f****
    NonExistMediaIds

    array

    不存在的媒體 ID。

    string

    不存在的媒體 ID。

    dfsg****
    UploadDetails

    array<object>

    上傳詳情列表。

    object

    返回結果詳情。

    Status

    string

    視頻狀態。具體的視頻狀態取值及描述，請參見Status：視頻狀態的取值列表。

    Uploading
    CreationTime

    string

    建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-04-28T09:42:07Z
    UploadSource

    string

    上傳資源。

    WebSDK
    UploadIP

    string

    上傳 IP 位址。

    192.168.0.1
    DeviceModel

    string

    裝置模型。

    Chrome
    ModificationTime

    string

    更新時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-04-28T09:43:12Z
    CompletionTime

    string

    完成時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-04-28T09:45:07Z
    MediaId

    string

    上傳的音/視頻 ID。

    61ccbdb06fa83012be4d8083f6****
    UploadSize

    integer

    上傳大小。單位：位元組。

    346
    UploadRatio

    number

    上傳比率。

    0.038
    UploadStatus

    string

    上傳任務狀態。具體的上傳狀態取值及描述，請參見Status：URL 上傳任務狀態的取值列表。

    Uploading
    Title

    string

    標題。

    測試檔案上傳詳情
    FileSize

    integer

    檔案大小。單位：位元組。

    46

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "9E290613-04F4-47F4-795D30732077****",
  "ForbiddenMediaIds": [
    "7d2fbc380b0e08e55f****"
  ],
  "NonExistMediaIds": [
    "dfsg****"
  ],
  "UploadDetails": [
    {
      "Status": "Uploading",
      "CreationTime": "2019-04-28T09:42:07Z",
      "UploadSource": "WebSDK",
      "UploadIP": "192.168.0.1",
      "DeviceModel": "Chrome",
      "ModificationTime": "2019-04-28T09:43:12Z",
      "CompletionTime": "2019-04-28T09:45:07Z",
      "MediaId": "61ccbdb06fa83012be4d8083f6****",
      "UploadSize": 346,
      "UploadRatio": 0.038,
      "UploadStatus": "Uploading",
      "Title": "測試檔案上傳詳情",
      "FileSize": 46
    }
  ]
}

    錯誤碼

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

    變更歷史

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