视频点播 VOD视频点播 VOD

文档首页> 视频点播 VOD> API参考> 媒资上传> 创建媒资:OBS托管方式
更新时间:2021/09/18 GMT+08:00
分享

创建媒资:OBS托管方式

功能介绍

通过存量托管的方式,将已存储在OBS桶中的音视频文件同步到点播服务。

OBS托管方式分为增量托管和存量托管,增量托管暂只支持通过视频点播控制台配置,配置后,若OBS有新增音视频文件,则会自动同步到点播服务中,具体请参见增量托管。两个托管方式都需要先将对应的OBS桶授权给点播服务,具体请参见桶授权

调试

您可以在API Explorer中调试该接口。

URI

POST /v1.0/{project_id}/asset/obs/host/stock/task

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

表3 请求Body参数

参数

是否必选

参数类型

描述

bucket

String

源桶名。

object

String

源目录名或源文件名。

suffix

Array of strings

批量托管时的文件后缀名列表。不传或传空值时,表示托管所有音视频文件,不进行后缀名过滤。

template_group_name

String

转码模板组名称。

若不为空,则使用指定的转码模板对上传的音视频进行转码,您可以在视频点播控制台配置转码模板,具体请参见转码设置。

若同时设置了“template_group_name”和“workflow_name”字段,则“template_group_name”字段生效。

workflow_name

String

工作流名称。

若不为空,则使用指定的工作流对上传的音视频进行处理,您可以在视频点播控制台配置工作流,具体请参见工作流设置

host_type

Integer

表示音视频处理后生成的媒资文件所存储的位置类型。

取值如下所示:

  • 0:表示存储到点播桶。

  • 1:表示存储在租户桶。

  • 2:表示存储到租户桶,并且存储路径与源文件一致。

output_bucket

String

输出桶名,host_type为1时必选

output_path

String

输出路径名,host_type为1时必选

响应参数

状态码: 202

表4 响应Body参数

参数

参数类型

描述

task_id

String

任务ID。

状态码: 403

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

POST https://{endpoint}/v1.0/{project_id}/asset/obs/host/stock/task

{
  "bucket" : "obs-gg",
  "object" : "1/Shoushu_FLV.flv",
  "suffix" : [ ],
  "template_group_name" : "original_template_group",
  "host_type" : 1,
  "output_bucket" : "obs-gg",
  "output_path" : "ouput/"
}

响应示例

状态码: 202

处理成功返回

{
  "task_id" : "456"
}

状态码: 403

处理失败返回。

{
  "error_code" : "VOD.10053",
  "error_msg" : "The request parameter is illegal, illegal field: {xx}."
}

状态码

状态码

描述

202

处理成功返回

403

处理失败返回。

错误码

请参见错误码

分享:

    相关文档

    相关产品