All Products
Search
Document Center

DataWorks:ListDownstreamTasks

Last Updated:Jun 11, 2026

Mengkueri daftar tugas turunan suatu tugas per halaman.

Deskripsi operasi

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

Id

integer

Yes

ID tugas.

1234

ProjectEnv

string

No

Lingkungan ruang kerja.

Nilai valid:

  • Prod: lingkungan produksi

  • Dev: lingkungan pengembangan.

Valid values:

  • Prod :
  • Dev :

Prod

PageSize

integer

No

Jumlah entri per halaman. Nilai default: 10.

10

PageNumber

integer

No

Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.

1

Elemen respons

Element

Type

Description

Example

object

RequestId

string

The request ID.

22C97E95-F023-56B5-8852-B1A77A17XXXX

PagingInfo

object

The pagination information.

Tasks

array<object>

The tasks. This parameter is deprecated and replaced by the DownstreamTasks parameter.

array<object>

Name

string

The name of the task.

SQL node

Description

string

The description of the task.

test

WorkflowId

integer

The ID of the workflow to which the task belongs.

1234

InstanceMode

string

The instance generation mode. Valid values:

  • T+1

  • Immediately

T+1

Type

string

The type of the task.

ODPS_SQL

BaselineId

integer

The baseline ID.

1234

Priority

integer

The priority of the task. Valid values: 1 to 8. A larger value indicates a higher priority. Default value: 1.

1

Timeout

integer

The timeout period of task running. Unit: seconds.

3600

RerunMode

string

The rerun mode.

Valid values:

  • AllDenied: The task cannot be rerun regardless of whether it is successfully run or fails to run.

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

  • AllAllowed: The task can be rerun regardless of whether it is successfully run or fails to run.

Valid values:

  • AllDenied :
  • FailureAllowed :
  • AllAllowed :

AllAllowed

RerunTimes

integer

The number of times that the task is rerun. This parameter takes effect only if the RerunMode parameter is set to AllAllowed or FailureAllowed.

3

RerunInterval

integer

The rerun interval. Unit: seconds.

60

Trigger

object

The method to trigger task scheduling.

Type

string

The trigger type.

Valid values:

  • Scheduler: scheduling cycle-based trigger

  • Manual: manual trigger

Valid values:

  • Scheduler :
  • Manual :

Scheduler

Recurrence

string

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

Valid values:

  • Pause :
  • Skip :
  • Normal :

Normal

Cron

string

The CRON expression of the task. This parameter takes effect only if the Type parameter is set to Scheduler.

00 00 00 * * ?

StartTime

string

The start time of the time range during which the task is periodically scheduled. This parameter takes effect only if the Type parameter is set to Scheduler.

1970-01-01 00:00:00

EndTime

string

The end time of the time range during which the task is periodically scheduled. This parameter takes effect only if the Type parameter is set to Scheduler.

9999-01-01 00:00:00

Timezone

string

The time zone.

Asia/Shanghai

RuntimeResource

object

The configurations of the runtime environment, such as the resource group information.

ResourceGroupId

string

The ID of the resource group for scheduling configured for task running.

S_res_group_524258031846018_1684XXXXXXXXX

Image

string

The ID of the image configured for task running.

i-xxxxxx

Cu

string

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

0.25

DataSource

object

The information about the associated data source.

Name

string

The name of the data source.

mysql_test

Id

integer

The task ID.

1234

ProjectId

integer

The workspace ID.

100

ProjectEnv deprecated

string

The environment of the workspace. This parameter is deprecated and replaced by the EnvType parameter.

Valid values:

  • Prod

  • Dev

Valid values:

  • Prod :
  • Dev :

Prod

EnvType

string

The environment of the workspace. Valid values:

  • Prod

  • Dev

Prod

Owner

string

The account ID of the task owner.

1000

StepType

string

The scheduling dependency type. Valid values:

  • Normal: same-cycle scheduling dependency

  • CrossCycle: cross-cycle scheduling dependency

Normal

CreateTime

integer

The creation time.

1710239005403

ModifyTime

integer

The modification time.

1710239005403

CreateUser

string

The account ID of the creator.

1000

ModifyUser

string

The account ID of the modifier.

1000

DownstreamTasks

array<object>

The descendant tasks.

array<object>

DependencyType

string

The scheduling dependency type. Valid values:

  • Normal: same-cycle scheduling dependency

  • CrossCycle: cross-cycle scheduling dependency

Normal

Task

object

The information about the task.

Name

string

The name of the task.

SQL node

Description

string

The description.

test

WorkflowId

integer

The ID of the workflow to which the task belongs.

1234

InstanceMode

string

The instance generation mode. Valid values:

  • T+1

  • Immediately

T+1

Type

string

The type of the task.

ODPS_SQL

BaselineId

integer

The baseline ID.

1234

Priority

integer

The priority of the task. Valid values: 1 to 8.

1

Timeout

integer

The timeout period of task running. Unit: seconds.

3600

RerunMode

string

The rerun mode. Valid values:

  • AllDenied: The task cannot be rerun regardless of whether the task is successfully run or fails to run.

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

  • AllAllowed: The task can be rerun regardless of whether it is successfully run or fails to run.

AllAllowed

RerunTimes

integer

The number of times that the task is rerun. This parameter takes effect only if the RerunMode parameter is set to AllAllowed or FailureAllowed.

3

RerunInterval

integer

The rerun interval. Unit: seconds.

60

Trigger

object

The trigger method.

Type

string

The trigger type. Valid values:

  • Scheduler: scheduling cycle-based trigger

  • Manual: manual trigger

Scheduler

Recurrence

string

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

The CRON expression. This parameter takes effect only if the Type parameter is set to Scheduler.

00 00 00 * * ?

StartTime

string

The start time of the time range during which the task is periodically scheduled. This parameter takes effect only if the Type parameter is set to Scheduler.

1970-01-01 00:00:00

EndTime

string

The end time of the time range during which the task is periodically scheduled. This parameter takes effect only if the Type parameter is set to Scheduler.

9999-01-01 00:00:00

Timezone

string

The time zone.

Asia/Shanghai

RuntimeResource

object

The configurations of the runtime environment, such as the resource group information.

ResourceGroupId

string

The ID of the resource group for scheduling configured for task running.

S_res_group_524258031846018_1684XXXXXXXXX

Image

string

The ID of the image configured for task running.

i-xxxxxx

Cu

string

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

0.25

DataSource

object

The information about the associated data source.

Name

string

The name of the data source.

mysql_test

Id

integer

The task ID.

1234

ProjectId

integer

The workspace ID.

100

EnvType

string

The environment of the workspace. Valid values:

  • Prod

  • Dev

Prod

Owner

string

The account ID of the task owner.

1000

CreateTime

integer

The creation time.

1710239005403

ModifyTime

integer

The modification time.

1710239005403

CreateUser

string

The account ID of the creator.

1000

ModifyUser

string

The account ID of the modifier.

1000

TotalCount

integer

The total number of entries returned.

100

PageSize

integer

The number of entries per page.

10

PageNumber

integer

The page number.

1

Contoh

Respons sukses

JSONformat

{
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX",
  "PagingInfo": {
    "Tasks": [
      {
        "Name": "SQL node\n",
        "Description": "test",
        "WorkflowId": 1234,
        "InstanceMode": "T+1",
        "Type": "ODPS_SQL",
        "BaselineId": 1234,
        "Priority": 1,
        "Timeout": 3600,
        "RerunMode": "AllAllowed",
        "RerunTimes": 3,
        "RerunInterval": 60,
        "Trigger": {
          "Type": "Scheduler",
          "Recurrence": "Normal\n",
          "Cron": "00 00 00 * * ?",
          "StartTime": "1970-01-01 00:00:00",
          "EndTime": "9999-01-01 00:00:00",
          "Timezone": "Asia/Shanghai"
        },
        "RuntimeResource": {
          "ResourceGroupId": "S_res_group_524258031846018_1684XXXXXXXXX\n",
          "Image": "i-xxxxxx",
          "Cu": "0.25"
        },
        "DataSource": {
          "Name": "mysql_test\n"
        },
        "Id": 1234,
        "ProjectId": 100,
        "ProjectEnv": "Prod",
        "EnvType": "Prod",
        "Owner": "1000",
        "StepType": "Normal",
        "CreateTime": 1710239005403,
        "ModifyTime": 1710239005403,
        "CreateUser": "1000",
        "ModifyUser": "1000"
      }
    ],
    "DownstreamTasks": [
      {
        "DependencyType": "Normal",
        "Task": {
          "Name": "SQL node",
          "Description": "test",
          "WorkflowId": 1234,
          "InstanceMode": "T+1",
          "Type": "ODPS_SQL",
          "BaselineId": 1234,
          "Priority": 1,
          "Timeout": 3600,
          "RerunMode": "AllAllowed",
          "RerunTimes": 3,
          "RerunInterval": 60,
          "Trigger": {
            "Type": "Scheduler",
            "Recurrence": "Normal",
            "Cron": "00 00 00 * * ?",
            "StartTime": "1970-01-01 00:00:00",
            "EndTime": "9999-01-01 00:00:00",
            "Timezone": "Asia/Shanghai"
          },
          "RuntimeResource": {
            "ResourceGroupId": "S_res_group_524258031846018_1684XXXXXXXXX",
            "Image": "i-xxxxxx",
            "Cu": "0.25"
          },
          "DataSource": {
            "Name": "mysql_test"
          },
          "Id": 1234,
          "ProjectId": 100,
          "EnvType": "Prod",
          "Owner": "1000",
          "CreateTime": 1710239005403,
          "ModifyTime": 1710239005403,
          "CreateUser": "1000",
          "ModifyUser": "1000"
        }
      }
    ],
    "TotalCount": 100,
    "PageSize": 10,
    "PageNumber": 1
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.