跳转至

创建用户

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 创建一个定时执行的任务