更新时间:2024-02-06 GMT+08:00
分享

创建作业

功能介绍

创建作业

URI

POST /v1.0/{project_id}/data/jobs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id,获取方法请参见获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

Content-Type

String

内容类型。填application/json

表3 请求Body参数

参数

是否必选

参数类型

描述

data_id

String

输入数据id。取值为数据仓库id时表示以数据仓库数据作为作业输入,可以使用warehouse_filters字段对输入数据进行筛选

最大长度:64

processor_id

Long

算子id

最小值:1

resource_spec

String

资源规格,示例:1Core_4GiB。具体获取方式可参考“查询可用资源规格“接口

priority

Integer

作业优先级,数值越大优先级越高

最小值:-50

最大值:50

缺省值:0

warehouse_filters

WarehouseDataFilters object

当data_id字段的取值为数据仓库id时,本结构体配置数据仓库输入数据筛选条件

warehouse_id

String

输出到数据仓库的id。当算子类型为数据标记、数据集、数据图表和回放仿真时必填

envs

Array of JobEnv objects

环境变量配置,最多十组

data_source

String

输入数据来源

枚举值:

  • DATA_PACKAGE(数据包)

  • DATA_WAREHOUSE(数据仓库)

  • DATA_SCENARIO(数据场景)

表4 WarehouseDataFilters

参数

是否必选

参数类型

描述

start_time

Long

创建时间最小值时间,UTC标准时间毫秒时间戳

最小值:0

end_time

Long

创建时间最大值时间,UTC标准时间毫秒时间戳

最小值:0

file_name

String

文件名称筛选

最大长度:255

data_process_task_ids

Array of strings

数据处理任务id列表,id最多5个

raw_data_ids

Array of strings

原始数据id列表,id最多5个

and_tags

Array of longs

按标签筛选,多个标签取交集,tag最多5个

or_tags

Array of integers

按标签筛选,多个标签取并集,tag最多5个

and_custom_attributes

Array of strings

按自定义属性筛选,多个属性取交集,attribute最多5个

or_custom_attributes

Array of strings

按自定义属性筛选,多个属性取并集,attribute最多5个

file_types

Array of strings

文件类型列表,file_type最多10个

枚举值:

  • IMAGE(图片)

  • POINT_CLOUD(点云)

  • TEXT(文本)

  • VIDEO(视频)

  • SCENARIO(场景文件)

  • OTHERS(其他)

表5 JobEnv

参数

是否必选

参数类型

描述

key

String

环境变量键,不能重复,配置环境变量时此项必填

最大长度:64

value

String

环境变量值,配置环境变量时此项必填

最大长度:64

响应参数

状态码: 201

表6 响应Body参数

参数

参数类型

描述

payload

payloadWithSingleNumber object

实际返回信息

meta_info

RespMetaInfo object

元数据

表7 payloadWithSingleNumber

参数

参数类型

描述

item

Long

资源id

表8 RespMetaInfo

参数

参数类型

描述

current_time

String

请求时间,UTC时间格式,时间为UTC标准时间

请求示例

POST https://{endpoint}/v1.0/{project_id}/data/jobs

{
  "envs" : [ {
    "key" : "topic",
    "value" : "camera_1"
  } ],
  "priority" : 1,
  "data_id" : "DPK0000001",
  "data_source" : "DATA_PACKAGE",
  "processor_id" : 10002,
  "warehouse_id" : "f78214c6-1f7e-48fc-b5d2-0315098bce88",
  "warehouse_filters" : {
    "raw_data_ids" : [ "DPK0000001" ],
    "file_types" : [ "TEXT", "IMAGE" ]
  },
  "resource_spec" : "1Core_1GiB"
}

响应示例

状态码: 201

创建成功,返回作业id

{
  "meta_info" : {
    "current_time" : "2022-01-01T08:08:29Z"
  },
  "payload" : {
    "item" : 1
  }
}

状态码

状态码

描述

201

创建成功,返回作业id

400

请求参数错误

403

权限校验失败

500

系统内部错误

错误码

请参见错误码

相关文档