UpdateTask API参考-大数据开发治理平台 DataWorks-阿里云-大数据开发治理平台 DataWorks(DataWorks)-阿里云帮助中心

更新指定任务。修改的内容会同步到数据开发，数据开发将新增一个保存版本。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dataworks:*

update

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Id	integer	是	任务 ID。	1234
ClientUniqueCode	string	否	任务的客户端唯一码，用来唯一标识一个任务。用于实现异步和幂等，创建时如果不指定，系统将自动生成，该代码将与资源 ID 进行唯一绑定。更新、删除资源时如果指定该参数，应与创建时的客户端唯一码保持统一。	Task_0bc5213917368545132902xxxxxxxx
EnvType	string	否	项目环境。 Prod：生产 Dev：开发	Prod
Name	string	否	名称。	SQL node
Description	string	否	描述信息。	test
Owner	string	否	任务的责任人的账号 ID。	1000
InstanceMode	string	否	实例生成模式。 T+1（第二天生成） Immediately（立即生成）。注意：节点定时时间在节点发布时间点十分钟后的周期实例才会正常生成。全量转实例期间（22:00~24:00 点期间）不能进行实时转实例，可以提交发布节点，但新增节点不会自动转出实例。	T+1
Timeout	integer	否	任务执行超时时间，单位秒。取值应大于 3600。	3600
RerunMode	string	否	任务是否允许重跑的配置。 AllDenied：失败或成功都不可重跑 FailureAllowed：只有失败可重跑 AllAllowed：失败或成功均可重跑	AllAllowed
RerunTimes	integer	否	重试次数，当任务设置为可重跑时生效。	3
RerunInterval	integer	否	重试时间间隔，单位毫秒。（不得超过 1800000）	60000
Script	object	否	运行脚本信息。
Content `deprecated`	string	否	脚本内容。	echo "helloWorld"
Parameters	string	否	脚本参数列表。	para1=$bizdate
Trigger	object	否	任务触发方式。
Type	string	否	触发方式类型。 Scheduler：调度周期触发 Manual：手动触发	Scheduler
Recurrence	string	否	触发时的运行模式，type=Scheduler 时生效。 Pause：暂停 Skip：空跑 Normal：正常运行	Normal
Cron	string	否	Cron 表达式，type=Scheduler 时生效。	00 00 00 * * ?
StartTime	string	否	周期触发生效时间，type=Scheduler 时生效。格式为`yyyy-mm-dd hh:mm:ss`	1970-01-01 00:00:00
EndTime	string	否	周期触发失效时间，type=Scheduler 时生效。格式为`yyyy-mm-dd hh:mm:ss`	9999-01-01 00:00:00
CycleType	string	否	周期类型，Type=Scheduler 且 Cron 表达式为指定某小时定时调度时生效。默认为 Daily。 Daily：指定为天调度 NotDaily：指定为小时调度	Daily
RuntimeResource	object	否	运行环境配置，如资源组信息。
ResourceGroupId	string	否	任务运行配置的调度资源组标识符。	S_res_group_524258031846018_1684XXXXXXXXX
Image	string	否	任务运行配置的镜像 ID。	i-xxxxxx
Cu	string	否	任务运行配置 CU 消耗。	0.25
DataSource	object	否	关联数据源信息。
Name	string	否	数据源名称。	odps_test
Inputs	object	否	输入信息。
Variables	array<object>	否	变量定义列表。
	object	否
Type	string	是	类型。 Constant：常量 PassThrough：参数节点输出 System：变量 NodeOutput：脚本输出	Constant
Value	string	否	变量值。	value1
Name	string	否	变量名称。	key1
Outputs	object	否	输出信息。
TaskOutputs	array<object>	否	任务输出定义列表。
	object	否
Output	string	否	输出标识符。	pre.odps_sql_demo_0
Variables	array<object>	否	变量定义列表。
	object	否
Type	string	是	类型。 Constant：常量 PassThrough：参数节点输出 System：变量 NodeOutput：脚本输出	Constant
Value	string	否	变量值。	value1
Name	string	否	变量名称。	key1
Dependencies	array<object>	否	依赖信息。
	object	否
Type	string	是	依赖类型。 CrossCycleDependsOnChildren：跨周期依赖一级子节点 CrossCycleDependsOnSelf：跨周期依赖自己 CrossCycleDependsOnOtherNode：跨周期依赖其他节点 Normal：同周期依赖	Normal
UpstreamOutput	string	否	上游任务的输出标识符。（`同周期依赖`且设置 input 内容时，返回此字段）	pre.odps_sql_demo_0
UpstreamTaskId	integer	否	上游任务的 Id。（`跨周期依赖其他节点`与`同周期依赖`未设置 input 内容时，返回此字段，其他情况不返回）	1234
Tags	array<object>	否	任务标签列表。
	object	否
Value	string	否	标签值。	value1
Key	string	是	标签键。	key1

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求的 ID，用于定位日志，排查问题。	22C97E95-F023-56B5-8852-B1A77A17XXXX
Success	boolean	操作是否成功。	true

示例

正常返回示例

JSON格式

{
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX",
  "Success": true
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。