（即将下线）创建媒资：OBS托管方式
- 音视频托管功能即将下线，功能下线后，将不再对新用户开放音视频托管功能。
- 现网还在用增量托管功能的用户，功能下线后，仍可正常使用。但是建议用户将数据从OBS桶迁移至VOD服务进行存储，不要依赖托管功能，详情请参见【下线公告】华为云视频点播VOD服务音视频托管功能下线。
功能介绍
通过存量托管的方式，将已存储在OBS桶中的音视频文件同步到点播服务。
OBS托管方式分为增量托管和存量托管，增量托管暂只支持通过视频点播控制台配置，配置后，若OBS有新增音视频文件，则会自动同步到点播服务中，具体请参见《点播服务用户指南》中的“增量托管”。两个托管方式都需要先将对应的OBS桶授权给点播服务，具体请参见《点播服务用户指南》中的“桶授权”。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1.0/{project_id}/asset/obs/host/stock/task
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
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 |
表示音视频处理后生成的媒资文件所存储的位置类型。 取值如下所示：
|
output_bucket |
否 |
String |
输出桶名，host_type为1时必选 |
output_path |
否 |
String |
输出路径名，host_type为1时必选 |
响应参数
状态码： 202
参数 |
参数类型 |
描述 |
|---|---|---|
task_id |
String |
任务ID。 |
状态码： 403
参数 |
参数类型 |
描述 |
|---|---|---|
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 |
处理失败返回。 |
错误码
请参见错误码。
