接口请求域名: vod.tencentcloudapi.com 。
该接口用于将一个网络上的视频拉取到云点播平台。
默认接口请求频率限制:100次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:PullUpload。 |
Version | 是 | String | 公共参数,本接口取值:2018-07-17。 |
Region | 否 | String | 公共参数,本接口不需要传递此参数。 |
MediaUrl | 是 | String | 要拉取的媒体 URL,暂不支持拉取 Dash 格式(可以支持 HLS)。 支持的扩展名详见媒体类型。 |
MediaName | 否 | String | 媒体名称。 |
CoverUrl | 否 | String | 要拉取的视频封面 URL。仅支持 gif、jpeg、png 三种图片格式。 |
Procedure | 否 | String | 媒体后续任务操作,详见上传指定任务流。 |
ExpireTime | 否 | Timestamp ISO8601 | 媒体文件过期时间,格式按照 ISO 8601 标准表示,详见 ISO 日期格式说明。 |
StorageRegion | 否 | String | 指定上传园区,仅适用于对上传地域有特殊需求的用户: |
ClassId | 否 | Integer | 分类ID,用于对媒体进行分类管理,可通过创建分类接口,创建分类,获得分类 ID。 |
SessionContext | 否 | String | 来源上下文,用于透传用户请求信息,当指定 Procedure 任务后,任务流状态变更回调将返回该字段值,最长 1000 个字符。 |
SessionId | 否 | String | 用于去重的识别码,如果三天内曾有过相同的识别码的请求,则本次的请求会返回错误。最长 50 个字符,不带或者带空字符串表示不做去重。 |
ExtInfo | 否 | String | 保留字段,特殊用途时使用。 |
SubAppId | 否 | Integer | 点播子应用 ID。如果要访问子应用中的资源,则将该字段填写为子应用 ID;否则无需填写该字段。 |
SourceContext | 否 | String | 来源上下文,用于透传用户请求信息,上传完成回调 将返回该字段值,最长 250 个字符。 |
参数名称 | 类型 | 描述 |
---|---|---|
TaskId | String | 拉取上传视频的任务 ID,可以通过该 ID 查询拉取上传任务的状态。 |
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
http://www.abc.com/abc.mp4
的 MP4 视频。https://vod.tencentcloudapi.com/?Action=PullUpload
&MediaUrl=http://www.abc.com/abc.mp4
&<公共请求参数>
{
"Response": {
"RequestId": "5ca61e3a-6b8e-4b4e-9256-fdc701190064ef0",
"TaskId": "125xxxxxx07-pull-893dc41e6fdc22dcf24aa6e9c61cp94"
}
}
http://www.abc.com/abc.mp4
的 MP4 视频至重庆园区。https://vod.tencentcloudapi.com/?Action=PullUpload
&MediaUrl=http://www.abc.com/abc.mp4
&StorageRegion=ap-chongqing
&<公共请求参数>
{
"Response": {
"RequestId": "6ca61e3a-6b8e-4b4e-9256-fdc701190064ef0",
"TaskId": "125xxxxxx07-pull-793dc41e6fdc22dcf24aa6e9c61cp94"
}
}
http://www.abc.com/abc.mp4
的 MP4 视频至新加坡园区。https://vod.tencentcloudapi.com/?Action=PullUpload
&MediaUrl=http://www.abc.com/abc.mp4
&StorageRegion=ap-singapore
&<公共请求参数>
{
"Response": {
"RequestId": "5ca61e3a-6b8e-4b4e-9256-fdc701190064ef0",
"TaskId": "125xxxxxx07-pull-693dc41e6fdc22dcf24aa6e9c61cp94"
}
}
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
FailedOperation | 操作失败。 |
FailedOperation.CoverType | 操作失败:不支持的封面类型。 |
FailedOperation.InvalidVodUser | 没有开通点播业务。 |
FailedOperation.MediaType | 操作失败:不支持的媒体类型。 |
InternalError | 内部错误。 |
InvalidParameter.ExpireTime | 参数值错误:过期时间。 |
InvalidParameter.StorageRegion | 参数值错误:存储地域。 |
InvalidParameterValue | 参数取值错误。 |
InvalidParameterValue.CoverUrl | 参数值错误:封面 URL。 |
InvalidParameterValue.ExpireTime | 参数值错误:ExpireTime 格式错误。 |
InvalidParameterValue.MediaUrl | 参数值错误:媒体文件 URL。 |
InvalidParameterValue.SessionContextTooLong | SessionContext 过长。 |
InvalidParameterValue.SessionId | 去重识别码重复,请求被去重。 |
InvalidParameterValue.SessionIdTooLong | SessionId 过长。 |
InvalidParameterValue.StorageRegion | 参数值错误:存储地域。 |
ResourceNotFound.CoverUrl | 资源不存在:封面不存在。 |
ResourceNotFound.UserNotExist | 用户不存在。 |
UnauthorizedOperation | 未授权操作。 |
直达最佳实践:【 SAP(HANA+S/4)上云基础环境部署最佳实践 】 最佳实践频道:...
题目是一名叫截然不同的同学私信我的一个问题,原话是,搞大数据,java 需要掌握...
本文转载自微信公众号「菜鸟飞呀飞」,作者刘进坤。转载本文请联系菜鸟飞呀飞公...
站群服务器 怎么选?站群服务器可以简单理解为多个服务器组合在一起,这样做网站...
导读 高可用可以说是分布式系统中最常谈到的词之一,那么我们在聊高可用时,我们...
本文转载自微信公众号「脑子进煎鱼了」,作者陈煎鱼 。转载本文请联系脑子进煎鱼...
作者简介: 黄乐,北京掌数信息技术有限公司联合创始人,清流派企业安全沙龙创始...
人脸识别sdk,人脸活体识别sdk多少钱?生物识别,是指依靠人体的身体特征来进行...
本文转载自微信公众号「后端Q」,作者conan。转载本文请联系后端Q公众号。 概述 ...
企业越来越喜爱 搭建流媒体服务器 ,原因就是有很多企业将自己的网站进行了改革...