- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- API参考
- SDK参考
- 常见问题
- 文档下载
- 通用参考
链接复制成功!
创建作业
功能介绍
创建作业
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字段对输入数据进行筛选 |
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时,该字段必填 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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个 |
响应参数
状态码: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-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 |
系统内部错误 |
错误码
请参见错误码。