文档首页/ 视频点播 VOD/ API参考/ 媒资上传/ (即将下线)创建媒资:OBS托管方式
更新时间:2024-04-28 GMT+08:00
分享

(即将下线)创建媒资:OBS托管方式

功能介绍

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

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

接口约束

  • 音视频托管功能即将下线,功能下线后,将不再对新用户开放音视频托管功能。

  • 现网还在用增量托管功能的用户,功能下线后,仍可正常使用。但是建议用户将数据从OBS桶迁移至VOD服务进行存储,不要依赖托管功能,详情请参见【下线公告】华为云视频点播VOD服务音视频托管功能下线

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

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

错误描述。

请求示例

创建媒资,使用存量托管方式。将已存储在OBS桶中的音视频文件同步到点播服务

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

Content-Type: application/json
{
  "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

处理失败返回。

错误码

请参见错误码

相关文档