日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

UploadMediaByURL - URL批量拉取上傳

基于源文件URL,拉取音視頻媒體文件進行上傳,支持批量上傳。

接口說明

  • 請確保在使用該接口前,已充分了解視頻點播產品的收費方式和價格。媒資文件上傳到視頻點播中會產生存儲費用,計費詳情,請參見媒資存儲計費。如果您已開通了存儲傳輸加速,則上傳媒資文件到視頻點播時還將涉及上傳加速費用,計費詳情請參見存儲傳輸加速計費。
  • 本接口支持上傳的媒體文件格式,請參見媒體格式。
  • 本接口主要適用于文件沒有存儲在本地服務器或終端,需要通過公網訪問的 URL 地址上傳的場景。
  • 本接口為異步上傳接口,非實時,不保證時效性,一般提交后會在數小時、甚至數天內完成遷移上傳。如果對時效性要求較高,建議使用上傳 SDK 上傳。
  • 如果配置了回調,則上傳完成后會收到 URL 上傳視頻完成的事件通知,可以通過獲取 URL 上傳信息接口查詢上傳狀態(tài)。
  • 上傳任務提交成功后,會在云端生成異步執(zhí)行的任務,相應服務地域下所有用戶提交的 URL 上傳任務進行排隊執(zhí)行,完成時間受已有任務數量影響;上傳完成后可根據事件通知(消息回調)返回的 URL 和視頻 ID 等信息進行關聯(lián)。
  • 本接口目前僅支持華東 2(上海)新加坡地域。
  • 同一個媒體文件 URL,每次提交上傳任務都會在點播中產生一個新的媒體資源(即產生新的媒體 ID)。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯(lián)操作:是指成功執(zhí)行操作所需要的其他權限。操作者必須同時具備關聯(lián)操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯(lián)操作
vod:UploadMediaByURLWrite
  • 全部資源
    *

請求參數

名稱類型必填描述示例值
UploadURLsstring

媒體源文件 URL。

  • URL 中需要包括擴展名, 比如https://****.mp4中 mp4 為擴展名。
    • 如果 URL 中不包含擴展名,可以在UploadMetadatas中傳入FileExtension來指定。
    • 如果 URL 中有擴展名且同時傳入FileExtension,以傳入的FileExtension為準。
    • 指定支持的擴展名,請參見上傳概述。
  • URL 編碼,多個地址之間以半角逗號(,)分隔,最多支持 20 個。
  • 避免存在特殊字符導致無法上傳視頻,需要 URL 編碼后再做逗號拼接。
https://****.mp4
TemplateGroupIdstring

轉碼模板組 ID。可通過以下方式獲?。?/p>

  • 登錄點播控制臺,選擇配置管理 > 媒體處理配置 > 轉碼模板組查看轉碼模版組 ID。
  • 通過創(chuàng)建轉碼模板組接口創(chuàng)建轉碼模板組時,轉碼模板組 ID 為返回參數 TranscodeTemplateGroupId 的值。
  • 通過查詢轉碼配置列表接口查詢轉碼模板組時,為請求后返回參數 TranscodeTemplateGroupId 的值。
說明
  • 不設置轉碼模板組 ID,則按默認的轉碼模板組進行轉碼;設置了轉碼模板組 ID 時,會使用該指定的模板組進行轉碼。
  • 可以在UploadMetadatas中進行設置,如果在 UploadMetadatas 中設置了 TemplateGroupId,此處也設置了 TemplateGroupId,則以 UploadMetadatas 中設置的 TemplateGroupId 為準。
  • ca3a8f6e4957b65806709586****
    StorageLocationstring

    媒體文件存儲地址。

    登錄點播控制臺,選擇配置管理 > 媒資管理配置 > 存儲管理查看存儲地址。不指定時會使用默認存儲地址。

    outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com
    UploadMetadatasstring

    上傳媒體文件的元數據信息,為 JSON 字符串。

    • 與 UploadURLs 里的 URL 匹配才能生效。
    • JSON 格式:[UploadMetadata, UploadMetadata,…],需轉為 JSON 字符串 。
    • 更多信息,請參見下表 UploadMetadata
    [{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
    UserDatastring

    自定義設置。為 JSON 字符串,支持消息回調、上傳加速等設置。更多信息,請參見 UserData 。

    說明
  • 此參數中消息回調的使用前提是需要在控制臺配置 HTTP 回調地址和勾選對應的回調事件類型才能使用,否則回調設置不生效??刂婆_配置 HTTP 回調的操作,請參考回調設置。
  • 如需使用上傳加速功能,您需要提交工單申請開通,更多信息,請參見上傳相關說明。關于如何提交工單,請參見聯(lián)系我們。
  • {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
    AppIdstring

    應用 ID。默認取值:app-1000000。 更多信息,請參見多應用

    app-****
    WorkflowIdstring

    工作流 ID??傻卿?a class="" target="_blank" >點播控制臺,選擇配置管理 > 媒體處理配置 > 工作流管理查看工作流 ID。

    說明 如果同時傳遞了 WorkflowId 和 TemplateGroupId,以 WorkflowId 為準。使用說明,請參見工作流
    e1e243b42548248197d6f74f9****
    SessionIdstring

    自定義去重識別碼,如果傳遞了該參數請求,當檢測到在過去 10 分鐘內曾有過相同識別碼的請求,則會在本次請求時返回錯誤。 該去重識別碼由您自定義設置,長度最長為 50 個字符,支持大小寫英文字母、數字、短劃線(-)和下劃線(_),不傳或者帶空字符串表示不去重。

    5c62d40299034bbaa4c195da330****

    UploadMetadata

    名稱類型是否必需描述
    SourceURLString需要上傳的媒體源文件 URL。
    TitleString媒體標題。長度不超過 128 個字節(jié)。UTF-8 編碼。
    FileSizeString文件大小。
    DescriptionString描述。長度不超過 1024 個字節(jié)。UTF-8 編碼。
    CoverURLString自定義視頻封面 URL 地址。
    CateIdString分類 ID??赏ㄟ^登錄點播控制臺,選擇配置管理 > 媒資管理配置 > 分類管理查看分類 ID。
    TagsString標簽。單個標簽不超過 32 字節(jié),最多不超過 16 個標簽。多個標簽,請使用半角逗號(,)分隔。UTF8 編碼。
    TemplateGroupIdString轉碼模板組 ID。會覆蓋外層傳入的 TemplateGroupId。
    WorkflowIdString工作流 ID。如果同時傳入了 WorkflowId 和 TemplateGroupId,以 WorkflowId 為準。更多信息,請參見工作流。
    FileExtensionString媒體文件擴展名,支持的擴展名,請參見上傳概述。
    說明
  • UploadMetadata 中的參數(如 Title、Description、Tags 等)不能包含表情符。
  • 為確保正常播放,當 TemplateGroupId 設置為“VOD_NO_TRANSCODE”不轉碼的方式上傳視頻文件后,目前僅以下格式的文件支持不轉碼直接播放:MP4、FLV、MP3、M3U8、WEBM,其他格式僅支持存儲(關注 FileName 的擴展名)。若使用阿里云播放器,版本須為 3.1.0 或以上。
  • 指定不轉碼的模板組(TemplateGroupId 設置為“VOD_NO_TRANSCODE”),視頻上傳后僅有視頻上傳完成的事件通知,沒有單個清晰度轉碼完成的事件通知。
  • 如果配置了回調,視頻上傳完成后,除了上傳和轉碼通知,還有 URL 上傳視頻完成事件通知。
  • 批量提交時,每一個 SourceURL 有獨立的通知。
  • 返回參數

    名稱類型描述示例值
    object

    返回結果。

    RequestIdstring

    請求 ID。

    25818875-5F78-4AF6-D7393642CA58****
    UploadJobsarray<object>

    上傳任務列表。

    object

    上傳任務詳情。

    SourceURLstring

    上傳任務對應的源文件 URL。

    http://example****.mp4
    JobIdstring

    上傳任務 ID。

    ad90a501b1b94fb72374ad005046****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
      "UploadJobs": [
        {
          "SourceURL": "http://example****.mp4",
          "JobId": "ad90a501b1b94fb72374ad005046****"
        }
      ]
    }

    錯誤碼

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

    變更歷史

    變更時間變更內容概要操作
    2023-05-16OpenAPI 入參發(fā)生變更查看變更詳情

    接口錯誤碼

    下表列舉了本接口特有的錯誤碼。

    錯誤代碼錯誤信息HTTP 狀態(tài)碼說明
    InvalidParameter.UploadURLsThe specified parameter UploadURLs is not valid.400參數 UploadURLs 無效。