全部产品
云市场

上传地址和凭证

更新时间:2019-02-21 20:23:10

简介

上传地址和凭证是点播服务下发的上传媒体文件到点播存储的授权凭证和文件地址。上传凭证主要解决媒体上传过程中的授权和安全问题,防止被恶意上传。同时,点播服务在下发上传地址和凭证时还会自动创建媒资信息,即媒体ID(MediaId,某些场合也用视频VideoId、图片ImageId)。媒体ID用来追踪和管理媒体的生命周期,媒体的初始状态一般为上传中,当相应处理完成后会自动更新为下一个状态(如上传完成、转码中、正常等);还可使用媒体ID发起转码、截图、视频AI处理,以及视频剪辑等。

相关限制

上传地址和凭证只能用于单个媒体,不能多个混用,否则会互相覆盖,同时也有一些其它限制:

  • 同一个视频,重复请求会获取到不同的上传地址和凭证。

  • 上传地址(目录)由点播服务自动分配,暂不支持自由指定。

  • 上传凭证有效期统一为 3000 秒。

  • 由于视频文件可能较大、上传耗时较长,凭证失效后需要刷新上传凭证,刷新后新的凭证有效期仍是 3000 秒,且上传地址不变。

  • 图片、辅助媒资(水印/字幕文件等)文件较小,凭证失效后只能重新获取。

使用说明

获取上传地址和凭证的环节为点播服务的核心基础,也是每个上传操作的必经过程;但并非每种上传方式都需要关心此环节。

  • 使用客户端SDK上传:需要自行获取上传地址和凭证,且只需要下发给客户端即可。

  • 使用API上传:需要自行获取上传地址和凭证,并对其进行解析和使用,完成整个上传逻辑。

  • 使用OSS原生SDK上传:需要自行获取上传地址和凭证,并对其进行解析和使用,完成整个上传逻辑。注意不能仅使用OSS上传SDK进行上传,否则无法创建媒资信息。

  • 使用服务端SDK上传:服务端上传SDK内部实现了获取上传地址和凭证,不需要关注此环节,但当前仅覆盖了部分开发语言。

获取方式

上传凭证分为视频上传凭证、图片上传凭证、辅助媒资上传凭证,主要API为:

推荐使用 服务端SDK 调用API来获取上传凭证,更为简单、高效,详情可参考各API文档的SDK示例

您也可以参考 公共参数API示例,来生成HTTP/HTTPS请求。

上传地址和凭证的解析

默认情况下不需要解析上传地址和凭证,也不需要关注其内部逻辑。如果需要基于OSS原生SDK或API实现上传,则请自行解析。

上传地址(UploadAddress)和上传凭证(UploadAuth)分别进行Base64解码,可得到OSS的上传地址和授权信息。

  • UploadAddress字段Base64解码后,得到JSON格式字符串,包含字段如下:
变量名 含义
Bucket OSS Bucket名称
Endpoint OSS区域地址
FileName 分配的媒体文件名
  • UploadAuth字段Base64解码后,得到JSON格式字符串,包含字段如下:
变量名 含义
AccessKeyId 上传授权密钥ID
AccessKeySecret 上传授权密钥
SecurityToken 上传授权安全令牌
Expiration 上传授权过期时间,视频为3000秒,过期需要刷新上传凭证

详细实现可参考 基于OSS原生SDK上传视频到点播