CreateUploadMedia_智能媒体生产_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 获取上传地址和凭证为智能媒体服务的核心基础,是每个上传操作的必经过程。
  • 如果视频上传凭证失效(默认有效期为 3000 秒),请调用刷新视频上传凭证接口重新获取上传凭证。
  • 上传后,可通过配置回调,接收上传事件通知或调用 GetMediaInfo 接口根据返回的媒资状态来判断是否上传成功。
  • 本接口返回的 MediaId 参数,可以用于媒资生命周期管理或媒体处理。

使用限制

  • 本接口仅支持上传至 VOD 点播存储,不支持上传至用户自有 OSS 存储。使用自有 OSS 存储的用户,可以先通过OSS SDK上传文件至 OSS,再调用 RegisterMediaInfo 接口将 OSS 文件注册至媒资库。
  • 本接口目前仅支持华东 2(上海)、华北 2(北京)、华南 1(深圳)地域。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ice:CreateUploadMedia
Create
全部资源
*

请求参数

字段名称字段详情
AppIdstring

应用 ID。默认取值:app-1000000。

示例值:app-1000000
EntityIdstring

实体 ID。可调用 CreateEntity 接口创建实体,自定义动态元数据结构。

示例值:9e177cac2fb44f8b8c67b199fcc7bffd
FileInfostring

文件信息,JSON 类型,包含参数字段:展开详情

示例值:{\"Type\":\"video\",\"Name\":\"test\",\"Size\":108078336,\"Ext\":\"mp4\"}参考取值来源:
    GetMediaInfo
    BatchGetMediaInfos
    ListMediaBasicInfos
UserDatastring

自定义设置。为 JSON 字符串,支持消息回调等设置。

示例值:{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
UploadTargetConfigstring

目标存储地址。展开详情

示例值:{\"StorageType\":\"oss\",\"StorageLocation\":\"outin-***.oss-cn-shanghai.aliyuncs.com\"}
MediaMetaDatastring

上传媒资的元数据,JSON 格式。展开详情

示例值:{\"Title\": \"UploadTest\", \"Description\": \"UploadImageTest\", \"Tags\": \"tag1,tag2\",\"BusinessType\":\"cover\"}
PostProcessConfigstring

Type = video || audio 有上传后处理动作。展开详情

示例值:{\"ProcessType\":\"Workflow\",\"ProcessID\":\"74ba870f1a4873a3ba238e0bf6fa9***\"}

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:4E84BE44-58A7-****-****-FBEBEA16EF94
MediaIdstring

媒资 ID。

示例值:****20b48fb04483915d4f2cd8ac****
MediaURLstring

媒资地址。展开详情

示例值:https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4
FileURLstring

文件 OSS 地址(不带鉴权)。

示例值:http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4
UploadAddressstring

上传地址。展开详情

示例值:eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuthstring

上传凭证。展开详情

示例值:eyJFbmRwb2ludCI6Imm****

返回示例

变更历史

变更时间变更内容概要操作
2022-06-20
新增OpenAPI,获取媒资上传地址和凭证

相关示例

获取媒资上传地址和凭证
2022-10-25