UpdateTask
Modify task configurations, including trigger settings, runtime resources, and dependencies, to manage DataWorks operations via the MCP server.
Instructions
更新任务 *This Tool has a 'MCP Resource'，please request UpdateTask(MCP Resource) to get more examples for using this tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ClientUniqueCode | No | 任务的客户端唯一码，用来唯一标识一个任务。用于实现异步和幂等，创建时如果不指定，系统将自动生成，该代码将与资源ID进行唯一绑定。更新、删除资源时如果指定该参数，应与创建时的客户端唯一码保持统一 | |
| DataSource | No | 关联数据源信息 | |
| Dependencies | No | 依赖信息 | |
| Description | No | 描述信息 | |
| EnvType | No | 项目环境。- Prod：生产- Dev：开发 | |
| Id | No | 任务ID | |
| Inputs | No | 输入信息 | |
| InstanceMode | No | 实例生成模式。-T+1（第二天生成）-Immediately（立即生成） | |
| Name | Yes | 名称 | |
| Outputs | No | 输出信息 | |
| Owner | Yes | 任务的责任人的账号ID | |
| RerunInterval | No | 重试时间间隔，单位秒 | |
| RerunMode | Yes | 任务是否允许重跑的配置。- AllDenied：失败或成功都不可重跑- FailureAllowed：只有失败可重跑- AllAllowed：失败或成功均可重跑 | |
| RerunTimes | No | 重试次数，当任务设置为可重跑时生效 | |
| RuntimeResource | Yes | 运行环境配置，如资源组信息 | |
| Script | No | 运行脚本信息 | |
| Tags | No | 任务标签列表 | |
| Timeout | No | 任务执行超时时间，单位秒 | |
| Trigger | Yes | 任务触发方式 |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ClientUniqueCode": {
"description": "任务的客户端唯一码，用来唯一标识一个任务。用于实现异步和幂等，创建时如果不指定，系统将自动生成，该代码将与资源ID进行唯一绑定。更新、删除资源时如果指定该参数，应与创建时的客户端唯一码保持统一",
"type": "string"
},
"DataSource": {
"additionalProperties": false,
"description": "关联数据源信息",
"properties": {
"Name": {
"description": "数据源名称",
"type": "string"
}
},
"type": "object"
},
"Dependencies": {
"description": "依赖信息",
"items": {
"additionalProperties": false,
"properties": {
"Type": {
"description": "依赖类型。- CrossCycleDependsOnChildren：跨周期依赖一级子节点- CrossCycleDependsOnSelf：跨周期依赖自己- CrossCycleDependsOnOtherNode：跨周期依赖其他节点- Normal：同周期依赖",
"type": "string"
},
"UpstreamOutput": {
"description": "上游任务的输出标识符。（`同周期依赖`且设置input内容时，返回此字段）",
"type": "string"
},
"UpstreamTaskId": {
"description": "上游任务的Id。（`跨周期依赖其他节点`与`同周期依赖`未设置input内容时，返回此字段，其他情况不返回）"
}
},
"required": [
"Type"
],
"type": "object"
},
"type": "array"
},
"Description": {
"description": "描述信息",
"type": "string"
},
"EnvType": {
"description": "项目环境。- Prod：生产- Dev：开发",
"type": "string"
},
"Id": {
"description": "任务ID"
},
"Inputs": {
"additionalProperties": false,
"description": "输入信息",
"properties": {
"Variables": {
"description": "变量定义列表",
"items": {
"additionalProperties": false,
"properties": {
"Name": {
"description": "变量名称",
"type": "string"
},
"Type": {
"description": "类型。- Constant：常量- PassThrough：参数节点输出- System：变量- NodeOutput：脚本输出",
"type": "string"
},
"Value": {
"description": "变量值",
"type": "string"
}
},
"required": [
"Type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"InstanceMode": {
"description": "实例生成模式。-T+1（第二天生成）-Immediately（立即生成）",
"type": "string"
},
"Name": {
"description": "名称",
"type": "string"
},
"Outputs": {
"additionalProperties": false,
"description": "输出信息",
"properties": {
"TaskOutputs": {
"description": "任务输出定义列表",
"items": {
"additionalProperties": false,
"properties": {
"Output": {
"description": "输出标识符",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"Variables": {
"description": "变量定义列表",
"items": {
"additionalProperties": false,
"properties": {
"Name": {
"description": "变量名称",
"type": "string"
},
"Type": {
"description": "类型。- Constant：常量- PassThrough：参数节点输出- System：变量- NodeOutput：脚本输出",
"type": "string"
},
"Value": {
"description": "变量值",
"type": "string"
}
},
"required": [
"Type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"Owner": {
"description": "任务的责任人的账号ID",
"type": "string"
},
"RerunInterval": {
"description": "重试时间间隔，单位秒"
},
"RerunMode": {
"description": "任务是否允许重跑的配置。- AllDenied：失败或成功都不可重跑- FailureAllowed：只有失败可重跑- AllAllowed：失败或成功均可重跑",
"type": "string"
},
"RerunTimes": {
"description": "重试次数，当任务设置为可重跑时生效"
},
"RuntimeResource": {
"additionalProperties": false,
"description": "运行环境配置，如资源组信息",
"properties": {
"Cu": {
"description": "任务运行配置CU消耗",
"type": "string"
},
"Image": {
"description": "任务运行配置的镜像ID",
"type": "string"
},
"ResourceGroupId": {
"description": "任务运行配置的调度资源组标识符",
"type": "string"
}
},
"required": [
"ResourceGroupId"
],
"type": "object"
},
"Script": {
"additionalProperties": false,
"description": "运行脚本信息",
"properties": {
"Content": {
"description": "脚本内容",
"type": "string"
},
"Parameters": {
"description": "脚本参数列表",
"type": "string"
}
},
"type": "object"
},
"Tags": {
"description": "任务标签列表",
"items": {
"additionalProperties": false,
"properties": {
"Key": {
"description": "标签键",
"type": "string"
},
"Value": {
"description": "标签值",
"type": "string"
}
},
"required": [
"Key"
],
"type": "object"
},
"type": "array"
},
"Timeout": {
"description": "任务执行超时时间，单位秒"
},
"Trigger": {
"additionalProperties": false,
"description": "任务触发方式",
"properties": {
"Cron": {
"description": "Cron表达式，type=Scheduler时生效",
"type": "string"
},
"EndTime": {
"description": "周期触发失效时间，type=Scheduler时生效。格式为`yyyy-mm-ddhh:mm:ss`",
"type": "string"
},
"Recurrence": {
"description": "触发时的运行模式，type=Scheduler时生效。- Pause：暂停- Skip：空跑- Normal：正常运行",
"type": "string"
},
"StartTime": {
"description": "周期触发生效时间，type=Scheduler时生效。格式为`yyyy-mm-ddhh:mm:ss`",
"type": "string"
},
"Type": {
"description": "触发方式类型。- Scheduler：调度周期触发- Manual：手动触发",
"type": "string"
}
},
"required": [
"Type"
],
"type": "object"
}
},
"required": [
"Name",
"Owner",
"RerunMode",
"Trigger",
"RuntimeResource"
],
"type": "object"
}