文档首页/ 视频点播 VOD/ API参考/ 媒资上传/ （即将下线）创建媒资：OBS托管方式
更新时间：2024-04-28 GMT+08:00
在线调试
CLI示例
查看PDF
分享

（即将下线）创建媒资：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

处理失败返回。

错误码

请参见错误码。

父主题： 媒资上传

相关文档