创建用户
1. 接口描述¶
本接口用于创建一个任务实例。
2. 输入参数¶
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
namespace | 是 | Number | 任务所属空间 |
job.displayName | 是 | String | 任务显示名称 |
job.group | 是 | String | 任务所属工作组 |
job.workflow.uid | 是 | String | 指定任务执行的工作流模板ID |
job.priority | 否 | Number | 任务的执行优先级 |
3. 输出参数¶
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
metadata | 是 | Object | 任务实体的元数据 |
name | 是 | String | 任务唯一标识 |
displayName | 是 | String | 任务显示名称 |
group | 是 | String | 任务所属工作组 |
workflow.uid | 是 | String | 指定任务执行的工作流模板ID |
priority | 是 | Number | 任务的执行优先级 |
status | 是 | Object | 资源实体的状态信息 |
inputs | 是 | Object | 任务的输入参数 |
outputs | 是 | Object | 任务的输出参数 |
status.startedAt | 否 | String | 任务创建时间 |
status.finishedAt | 否 | String | 任务完成时间 |
argonWorkflow | 否 | Object | 任务对应的argo工作流模板 |
4. 示例¶
实例1 创建一个普通任务
在 default
空间下创建一个显示名称为 "常规任务bbb31937", 优先级为0
,最大重试次数为2
重试间隔为3s
的普通计算任务
输入示例
POST /api/v1/namespaces/default/jobs
Body
{
job: {
displayName: "常规任务bbb31937",
group: "开发资源组",
workflow: {uid: "25619d6c-c55e-4c91-a498-e059a0b738c7"},
priority: 0,
retryOption: {maxretry: 2, retryInterval: 3000},
type: "normal"
}
namespace: "default"
}
输出示例
{
argoWorkflow: {name: "build-from-job-7a3ecec2-f4c9-41f4-a078-3e25c94f4324-g46xw",…}
displayName: "常规任务bbb31937"
inputs: [{id: "cad15b68", anchors: [{source: "a0e9da1a", sourceAnchor: "972abbc8"}],…}]
metadata: {clusterName: "default", namespace: "default", uid: "7a3ecec2-f4c9-41f4-a078-3e25c94f4324"}
name: "job-7a3ecec2-f4c9-41f4-a078-3e25c94f4324"
outputs: [{id: "7ff0b208", anchors: [{source: "6c1f506e", sourceAnchor: "b9c499f2"}],…}]
priority: 0
retryOption: {maxRetry: 2, retryInterval: 3000}
status: {startedAt: "2021-01-27T06:26:22Z", finishedAt: null}
type: "normal"
workflow: {uid: "25619d6c-c55e-4c91-a498-e059a0b738c7"}
}
实例2 创建一个带回调接口的任务
实例3 创建一个定时执行的任务