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

创建作业-CreateJobs

功能介绍

创建作业

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字段对输入数据进行筛选

processor_id

是

Long

算子id

resource_spec

是

String

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

priority

否

Integer

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

warehouse_filters

否

WarehouseDataFilters object

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

warehouse_id

否

String

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

envs

否

Array of JobEnv objects

环境变量配置，最多十组

data_source

是

String

输入数据来源

workspace_id

是

String

工作空间id

cluster_type

否

String

集群类型

cluster_id

否

String

集群ID，当cluster_type为MODELARTS时,该字段必填

表4 WarehouseDataFilters

参数

是否必选

参数类型

描述

start_time

否

Long

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

end_time

否

Long

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

file_name

否

String

文件名称筛选

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个

表5 JobEnv

参数

是否必选

参数类型

描述

key

是

String

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

value

是

String

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

响应参数

状态码：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-xxxx-xxxx-xxxx-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

系统内部错误

错误码

请参见错误码。

父主题：作业管理

相关文档