功能介绍

该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	服务不可用。