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

UploadMediaByURL - URL拉取上傳

調用UploadMediaByURL基于源文件URL,拉取音視頻媒體文件進行上傳,支持批量上傳。本接口主要適用于文件沒有存儲在本地服務器或終端,需要通過公網訪問的URL地址上傳的場景。

接口說明

  • 如果配置了回調,則上傳完成后會收到 URL 上傳視頻完成的事件通知,可以通過獲取 URL 上傳信息接口查詢上傳狀態。
  • 上傳任務提交成功后,會在云端生成異步執行的任務,進行排隊執行;上傳完成后可根據事件通知(消息回調)返回的 URL 和視頻 ID 等信息進行關聯。

使用限制

  • 本接口僅支持上傳至 VOD 點播存儲,不支持上傳至用戶自有 OSS 存儲。使用自有 OSS 存儲的用戶,可以先將文件拉取到本地,通過OSS SDK上傳文件至 OSS,然后再調用 RegisterMediaInfo 接口將 OSS 文件注冊至媒資庫。

  • 本接口目前僅支持華東 2(上海)、華北 2(北京)、華南 1(深圳)地域。

  • 本接口僅支持上傳音視頻文件。

調試

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

授權信息

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

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

請求參數

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

媒體源文件 URL。

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

應用 ID。

app-1000000
UserDatastring

自定義設置。為 JSON 字符串,支持消息回調等設置。

{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
UploadTargetConfigstring

目標存儲地址。

  • StorageType 取值:僅支持 oss。
  • StorageLocation 僅支持 VOD 點播存儲,不支持用戶自有 OSS 存儲。
{"StorageType":"oss","StorageLocation":"outin-***.oss-cn-shanghai.aliyuncs.com"}
MediaMetaDatastring

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

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

Type = video || audio 有上傳后處理動作。

ProcessType 取值:Workflow。

{"ProcessType": "Workflow","ProcessID":"b72a06c6beeb4dcdb898feef067b1***"}
EntityIdstring

實體 ID??烧{用 CreateEntity 接口創建實體,自定義動態元數據結構。

d67281da3c8743b8823ad12976187***

UploadMetadata

名稱類型是否必需描述
SourceURLString需要上傳的媒體源文件 URL。
TitleString媒體標題。長度不超過 128 個字節。UTF-8 編碼。
FileSizeString文件大小。
DescriptionString描述。長度不超過 1024 個字節。UTF-8 編碼。
CoverURLString自定義視頻封面 URL 地址。
CateIdString分類 ID。
TagsString標簽。單個標簽不超過 32 字節,最多不超過 16 個標簽。多個標簽,請使用半角逗號(,)分隔。UTF8 編碼。
WorkflowIdString工作流 ID。
FileExtensionString媒體文件擴展名。
DynamicMetaDataString動態元數據,例:"{"Uploader": "xxx"}"。
EntityIdString實體 Id。
說明
  • UploadMetadata 中的參數(如 Title、Description、Tags 等)不能包含表情符。
  • 如果配置了回調,視頻上傳完成后,除了上傳和轉碼通知,還有 URL 上傳視頻完成件通知。
  • 批量提交時,每一個 SourceURL 有獨立的通知。
  • 返回參數

    名稱類型描述示例值
    object

    返回結果。

    RequestIdstring

    請求 ID。

    ****83B7-7F87-4792-BFE9-63CD2137****
    UploadJobsarray<object>

    多個 Job 信息。

    UploadJobobject

    上傳任務詳情。

    JobIdstring

    上傳任務 ID。

    20ce1e05dba64576b96e9683879f0***
    SourceURLstring

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

    http://example****.mp4
    MediaIdstring

    媒資 ID。

    f476988629f54a7b8a4ba90d1a6c7***

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "****83B7-7F87-4792-BFE9-63CD2137****",
      "UploadJobs": [
        {
          "JobId": "20ce1e05dba64576b96e9683879f0***",
          "SourceURL": "http://example****.mp4\n",
          "MediaId": "f476988629f54a7b8a4ba90d1a6c7***"
        }
      ]
    }

    錯誤碼

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

    變更歷史

    變更時間變更內容概要操作
    暫無變更歷史