全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
视频点播

获取视频上传地址和凭证

更新时间:2017-08-17 11:54:20

描述

获取视频上传地址和凭证,并创建视频信息。

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值: CreateUploadVideo
Title String 视频标题,长度不超过128个字节,UTF8编码
FileName String 视频源文件名,必须带扩展名,且扩展名不区分大小写, 支持的扩展名参见上传概述的限制部分
FileSize String 视频文件大小,单位:字节
Description String 视频描述,长度不超过1024个字节,UTF8编码
CoverURL String 自定义视频封面URL地址
CateId Long 视频分类ID,请在“点播控制台-全局设置-分类管理”里编辑或查看分类的ID
Tags String 视频标签,单个标签不超过32字节,最多不超过16个标签。多个用逗号分隔,UTF8编码

返回参数

名称 类型 描述
RequestId String 请求ID
VideoId String 视频ID
UploadAddress String 上传地址
UploadAuth String 上传凭证

请注意:

  • 该接口不会真正上传视频文件,您需要拿到上传凭证和地址后使用上传SDK进行文件上传;
  • 如果视频上传凭证失效(有效期3600秒),请调用刷新视频上传凭证接口重新获取上传凭证。

特殊错误码

错误代码 错误描述 HTTP状态码 语义
InvalidParameter.FileName The specified parameter FileName is not valid. 400 参数FileName无效
Forbidden.InitFailed Initialization of your account has failed while opening service. 403 服务开通时账号初始化失败
AddVideoFailed Adding video has failed due to some unknown error. 503 创建视频信息失败,请稍后重试

示例

1. 请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=CreateUploadVideo&Title=exampleTitle&FileName=example.avi&FileSize=10485760&Format=JSON&<公共参数>

注:示例中的“公共参数”需要有效传参,详情请查看 公共参数说明文档

2. 返回示例

Json:

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "VideoId": "93ab850b4f6f44eab54b6e91d24d81d4",
  4. "UploadAddress": "eyJTZWN1cml0eVRva2VuIjoiQ0FJU3p3TjF",
  5. "UploadAuth": "eyJFbmRwb2ludCI6Im"
  6. }
本文导读目录