更新时间:2021-08-03 GMT+08:00
分享

创建作业

功能介绍

该API用于创建所选视频分析服务的作业。

URI

  • URI格式
    POST /v2/{project_id}/services/{service_name}/tasks
  • 参数说明

    名称

    是否必选

    类型

    说明

    project_id

    String

    服务所在区域对应的项目ID,获取方法请参见获取项目ID

    service_name

    String

    所选视频分析服务名称。

请求消息

  • 请求示例
    POST /v2/6204a5bd270343b5885144cf9c8c158d/services/video-analyze/tasks
    {  
        "name": "task-est",
        "description": "description",
        "input": {  
               "type": "obs",
               "data": [
                      {  
                       "bucket": "obs-iva",
                       "path": "input/demo.mp4"
                      }  
               ]  
        },  
        "output": {
               "obs": {
                      "bucket": "obs-iva",
                      "path": "output/"
               }
        },
       "service_version":"1.0"  
    }
  • 请求参数说明

    参数名称

    是否为必选

    类型

    描述信息

    name

    String

    作业名称,只能由字母(a~z,A~Z)、数字(0~9)、中划线(-)、下划线(_)组成,长度范围为[1,100]。

    description

    String

    作业描述信息,最大长度为500字符长度。

    input

    Object

    视频数据的输入列表。

    详细参数定义参见task.input(任务输入参数)

    service_version

    String

    功能版本。

    output

    Object

    结果数据的输出列表。

    详细参数定义见task.output(任务输出参数)

响应消息

  • 响应示例
    [  
      {      "id": "f18320e61e4c4dc685aa2dfc22a28dc5"   }
    ]
  • 返回作业ID列表

    参数名称

    类型

    描述信息

    id

    String

    作业ID。

返回值

  • 正常

    201

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误,具体返回错误码请参考错误码

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

close