All Products
Search
Document Center

DataWorks:BatchUpdateTasks

Last Updated:Mar 30, 2026

Performs incremental updates on multiple tasks at a time.

Operation description

DataWorks Basic Edition or higher is required.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Tasks

array<object>

No

The list of tasks.

array<object>

No

Id

integer

Yes

The task ID.

1234

EnvType

string

No

The project environment.

  • Prod: Production

  • Dev: Development

Prod

Name

string

No

The name.

SQL node

Description

string

No

The description.

test

Owner

string

No

The account ID of the task owner.

1000

Timeout

integer

No

The task execution timeout in seconds. The value should be greater than 3600.

3600

RerunMode

string

No

The rerun mode. Valid values:

  • AllDenied: The task cannot be rerun.

  • FailureAllowed: The task can be rerun only after it fails.

  • AllAllowed: The task can always be rerun.

AllAllowed

RerunTimes

integer

No

The number of retry attempts. Takes effect when the task is configured to allow reruns.

3

RerunInterval

integer

No

The retry interval in seconds.

60

Trigger

object

No

The task trigger configurations.

Type

string

No

The trigger type. Valid values:

  • Scheduler: periodically triggered

  • Manual

Scheduler

Recurrence

string

No

The running mode of the task after it is triggered. This parameter takes effect only if the Type parameter is set to Scheduler. Valid values:

  • Pause

  • Skip

  • Normal

Normal

Cron

string

No

The cron expression. Takes effect when type=Scheduler.

00 00 00 * * ?

StartTime

string

No

The time when periodic triggering takes effect. This parameter takes effect only if the Type parameter is set to Scheduler. The value of this parameter is in the yyyy-mm-dd hh:mm:ss format.

1970-01-01 00:00:00

EndTime

string

No

The expiration time of periodic triggering. Takes effect only when type is set to Scheduler. The value of this parameter is in theyyyy-mm-dd hh:mm:ss format.

9999-01-01 00:00:00

RuntimeResource

object

No

Runtime environment configurations, such as resource group information.

ResourceGroupId

string

No

The identifier of the scheduling resource group used in the task runtime configuration.

S_res_group_524258031846018_1684XXXXXXXXX

Image

string

No

The image ID used in the task runtime configuration.

i-xxxxxx

Cu

string

No

The default number of compute units (CUs) configured for task running.

0.25

DataSource

object

No

Associated data source information.

Name

string

No

The data source name.

odps_test

Tags

array<object>

No

The list of task tags.

object

No

Key

string

Yes

The tag key.

key1

Value

string

No

The tag value.

value1

Comment

string

No

The remarks.

this is a comment

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

22C97E95-F023-56B5-8852-B1A77A17XXXX

SuccessInfo

object

The result of the batch operation, which is in the MAP structure. The task ID serves as a key, and the result serves as a value.

object

The result.

Success

boolean

Indicates whether the request was successful.

true

Message

string

The error message.

The task does not exist.

Examples

Success response

JSON format

{
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX",
  "SuccessInfo": {
    "key": {
      "Success": true,
      "Message": "The task does not exist."
    }
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.