All Products
Search
Document Center

DataWorks:UpdateTaskInstances

Last Updated:Mar 30, 2026

Modify the properties of multiple task instances in batch, including priority, resource group, data source, and more.

Operation description

You must purchase DataWorks Basic Edition or a higher edition to use this feature.

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

TaskInstances

array<object>

No

The instances.

array<object>

No

Id

integer

Yes

The instance ID.

1234

Priority

integer

No

The priority of the instance. Valid values: 1, 3, 5, 7, and 8.

A larger value indicates a higher priority. Default value: 1.

Valid values:

  • 1 :

    1

  • 3 :

    3

  • 5 :

    5

  • 7 :

    7

  • 8 :

    8

1

RuntimeResource

string

No

The resource group information. Set this parameter to the ID of a resource group for scheduling.

S_res_group_524258031846018_1684XXXXXXXXX

DataSource

object

No

The information about the associated data source.

Name

string

No

The name of the data source.

mysql_test

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 instance 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 instance does not exist.

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.