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

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 視頻點播 開發參考 API參考 API目錄 媒體上傳 RegisterMedia - 注冊媒資信息

RegisterMedia - 注冊媒資信息

更新時間：
產品詳情
我的收藏

進行媒資注冊，接入點播服務的OSS自有Bucket上的存量媒資文件，需要進行媒資注冊生成點播需要的關聯數據后，才能正常使用點播提供的轉碼、截圖等功能。

接口說明

  • 針對已接入點播服務的 OSS bucket，已存儲在 OSS bucket 上的音視頻媒體文件，需要通過注冊媒資接口生成點播需要的關聯數據后，才能在點播服務中對這些媒體文件通過媒體 ID 發起轉碼、截圖和 AI 處理等。
  • 一次最多可注冊 10 個 OSS 媒體文件，且一次提交的媒體文件對應的存儲地址需要一致。
  • 在點播中上傳的媒體文件，如未指定轉碼模板組 ID，則會按照默認模板組進行轉碼處理；與之不同的是，注冊媒資后，如未指定轉碼模板組 ID，則不會自動觸發轉碼；如指定了轉碼模板組 ID，則會按照指定的模板組進行轉碼處理。
  • 重復注冊的媒體文件，只返回與其關聯的唯一媒體 ID，不做其他處理。
  • 請確保您要注冊的媒資文件含有合法的后綴，否則會注冊失敗。

調試

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

授權信息

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

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

請求參數

名稱類型必填描述示例值
RegisterMetadatasstring是

注冊媒資元數據。為 JSON 字符串，一次最多支持設置 10 個媒資元數據。參數結構的更多信息，請參見下表 RegisterMetadata。

[{"FileURL":"https://****.oss-cn-shanghai.aliyuncs.com/video/test/video123.m3u8","Title":"VideoName"}]
TemplateGroupIdstring否

轉碼模板組 ID。可通過以下方式獲取：

  • 登錄點播控制臺，選擇配置管理 > 媒體處理配置 > 轉碼模板組查看轉碼模版組 ID。
  • 通過創建轉碼模板組接口創建轉碼模板組時，轉碼模板組 ID 為返回參數 TranscodeTemplateGroupId 的值。
  • 通過查詢轉碼配置列表接口查詢轉碼模板組時，為請求后返回參數 TranscodeTemplateGroupId 的值。
說明
  • 如果不需要轉碼無轉碼，請指定 TemplateGroupId 為 VOD_NO_TRANSCODE（不轉碼模板組），否則視頻會出現異常。如果需要轉碼，則指定轉碼模板組 ID。
  • 如果同時傳遞了 WorkflowId 和 TemplateGroupId，以 WorkflowId 為準。使用說明，請參見工作流。
    •
    		ca3a8f6e49c87b65806709586****
    UserDatastring否

    自定義設置。為 JSON 字符串，支持消息回調等設置。參數詳情，請參見 UserData 。

    說明 本接口不支持回調，即便此參數中設置了消息回調，在媒資注冊完成后也不會產生回調消息。當后續對注冊完成的媒資發起轉碼、截圖等媒體處理時，若在發起轉碼、截圖時單獨設置了 UserData 中的消息回調，則優先使用那個回調地址；未設置，則使用此處注冊媒資時 UserData 中設置的回調地址。
    		{"Extend":{"localId":"****","test":"www"}}
    WorkflowIdstring否

    工作流 ID。可登錄點播控制臺，選擇配置管理 > 媒體處理配置 > 工作流管理查看工作流 ID。

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

    RegisterMetadata

    指定要注冊的媒資元數據。

    名稱類型是否必選描述
    FileURLString是源文件地址。可通過獲取源文件信息接口獲取。
    長度不超過 1024 個字節，文件名需要保證全局唯一。添加相同文件名稱時，則關聯唯一媒體 ID。
    TitleString是標題。長度不超過 128 個字節。UTF8 編碼。
    DescriptionString否描述。長度不超過 1024 個字節。UTF8 編碼。
    TagsString否標簽。單個標簽不超過 32 個字節，最多不超過 16 個標簽，多個標簽之間用半角逗號(,)分隔。UTF8 編碼。
    CoverURLString否封面 URL。長度不超過 1024 個字節。
    CateIdLong否分類 ID。可通過以下方式獲取：
    登錄點播控制臺，選擇配置管理 > 媒資管理配置 > 分類管理查看分類 ID。
    通過創建分類接口創建分類時，分類 ID 為返回參數 CateId 的值。
    通過獲取分類及子分類接口查詢分類時，為請求后返回參數 CateId 的值。

    返回參數

    名稱類型描述示例值
    object

    返回結果。

    RequestIdstring

    請求 ID。

    		14F43C5C-8033-448B-AD04F64E5098****
    FailedFileURLsarray

    注冊失敗的文件地址列表。

    FileURLstring

    注冊失敗的文件地址列表。

    		["http://****.oss-cn-shanghai.aliyuncs.com/vod_sample_03.mp4"]
    RegisteredMediaListarray<object>

    本次注冊成功的 Media 列表，包括新增注冊和已注冊成功過的文件。

    RegisteredMediaobject

    注冊詳情。

    NewRegisterboolean

    新注冊或重復注冊。

    • true：表示新注冊。
    • false：表示重復注冊。
    		false
    FileURLstring

    OSS 文件地址。

    		http://****.oss-cn-shanghai.aliyuncs.com/vod_sample_01.mp4
    MediaIdstring

    點播媒體 ID。當注冊的媒體文件為音視頻時，對應點播的 VideoId。

    		d97af32828084d1896683b1aa38****

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "14F43C5C-8033-448B-AD04F64E5098****",
  "FailedFileURLs": [
    "[\"http://****.oss-cn-shanghai.aliyuncs.com/vod_sample_03.mp4\"]"
  ],
  "RegisteredMediaList": [
    {
      "NewRegister": false,
      "FileURL": "http://****.oss-cn-shanghai.aliyuncs.com/vod_sample_01.mp4",
      "MediaId": "d97af32828084d1896683b1aa38****"
    }
  ]
}

    錯誤碼

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

    變更歷史

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