创建作业
功能介绍
创建作业
URI
POST /v1.0/{project_id}/data/jobs
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目id，获取方法请参见获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） |
Content-Type |
是 |
String |
内容类型。填application/json |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
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 |
输入数据来源 枚举值：
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
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个 枚举值：
|
响应参数
状态码： 201
参数 |
参数类型 |
描述 |
|---|---|---|
payload |
payloadWithSingleNumber object |
实际返回信息 |
meta_info |
RespMetaInfo object |
元数据 |
请求示例
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 |
系统内部错误 |
错误码
请参见错误码。
