文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 作业管理/ 创建作业
更新时间：2024-02-06 GMT+08:00
查看PDF
分享

创建作业

功能介绍

创建作业

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

系统内部错误

错误码

请参见错误码。

父主题： 作业管理

相关文档