ListDownstreamTasks - DataWorks - Centro de documentación de Alibaba Cloud

Consulta una lista paginada de tareas descendientes de una tarea.

Descripción de la operación

Debe adquirir DataWorks Basic Edition o una edición superior para usar esta operación.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Id	integer	Sí	El ID de la tarea.	1234
ProjectEnv	string	No	El entorno del espacio de trabajo. Valores válidos: Prod: entorno de producción Dev: entorno de desarrollo Valores válidos: Prod : Producción. Dev : Desarrollo.	Prod
PageSize	integer	No	El número de entradas por página. Valor predeterminado: 10.	10
PageNumber	integer	No	El número de página. Las páginas comienzan en la página 1. Valor predeterminado: 1.	1

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	22C97E95-F023-56B5-8852-B1A77A17XXXX
PagingInfo	object	La información de paginación.
Tasks	array<object>	Las tareas. Este parámetro está obsoleto y se reemplaza por el parámetro DownstreamTasks.
	array<object>
Name	string	El nombre de la tarea.	SQL node
Description	string	La descripción de la tarea.	test
WorkflowId	integer	El ID del flujo de trabajo al que pertenece la tarea.	1234
InstanceMode	string	El modo de generación de instancias. Valores válidos: T+1 (generar al día siguiente) e Immediately (generar de inmediato).	T+1
Type	string	El tipo de la tarea.	ODPS_SQL
BaselineId	integer	El ID de la línea base.	1234
Priority	integer	La prioridad de la tarea. Valores válidos: de 1 a 8. Un valor mayor indica una prioridad mayor. Valor predeterminado: 1.	1
Timeout	integer	El tiempo de espera de ejecución de la tarea. Unidad: segundos.	3600
RerunMode	string	El modo de reejecución. Valores válidos: AllDenied: La tarea no se puede reejecutar independientemente de si se ejecuta correctamente o falla. FailureAllowed: La tarea se puede reejecutar solo después de que falle. AllAllowed: La tarea se puede reejecutar independientemente de si se ejecuta correctamente o falla. Valores válidos: AllDenied : No se puede reejecutar independientemente de si se ejecuta correctamente o falla. FailureAllowed : Se puede reejecutar solo después de un fallo. AllAllowed : Se puede reejecutar independientemente de si se ejecuta correctamente o falla.	AllAllowed
RerunTimes	integer	El número de veces que se reejecuta la tarea. Este parámetro surte efecto solo si el parámetro RerunMode se establece en AllAllowed o FailureAllowed.	3
RerunInterval	integer	El intervalo de reejecución. Unidad: segundos.	60
Trigger	object	El método para activar la programación de la tarea.
Type	string	El tipo de activación. Valores válidos: Scheduler: activación basada en un ciclo de programación Manual: activación manual Valores válidos: Scheduler : Activada por un ciclo de programación. Manual : Activada manualmente.	Scheduler
Recurrence	string	El modo de ejecución de la tarea después de activarse. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler. Valores válidos: Pause Skip Normal Valores válidos: Pause : En pausa. Skip : Ejecución de prueba. Normal : Ejecución normal.	Normal
Cron	string	La expresión CRON de la tarea. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler.	00 00 00 * * ?
StartTime	string	La hora de inicio del intervalo de tiempo durante el cual la tarea se programa periódicamente. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler.	1970-01-01 00:00:00
EndTime	string	La hora de finalización del intervalo de tiempo durante el cual la tarea se programa periódicamente. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler.	9999-01-01 00:00:00
Timezone	string	La zona horaria.	Asia/Shanghai
RuntimeResource	object	Las configuraciones del entorno de ejecución, como la información del grupo de recursos.
ResourceGroupId	string	El ID del grupo de recursos de programación configurado para la ejecución de la tarea.	S_res_group_524258031846018_1684XXXXXXXXX
Image	string	El ID de la imagen configurada para la ejecución de la tarea.	i-xxxxxx
Cu	string	El número de unidades de cómputo (CU) configuradas para la ejecución de la tarea.	0.25
DataSource	object	La información sobre el origen de datos asociado.
Name	string	El nombre del origen de datos.	mysql_test
Id	integer	El ID de la tarea.	1234
ProjectId	integer	El ID del espacio de trabajo.	100
ProjectEnv `deprecated`	string	El entorno del espacio de trabajo. Este parámetro está obsoleto y se reemplaza por el parámetro EnvType. Valores válidos: Prod Dev Valores válidos: Prod : Producción. Dev : Desarrollo.	Prod
EnvType	string	El entorno del espacio de trabajo. Valores válidos: Prod (producción) y Dev (desarrollo).	Prod
Owner	string	El ID de la cuenta del propietario de la tarea.	1000
StepType	string	El tipo de dependencia de programación. Valores válidos: Normal: dependencia de programación del mismo ciclo CrossCycle: dependencia de programación entre ciclos	Normal
CreateTime	integer	La hora de creación.	1710239005403
ModifyTime	integer	La hora de modificación.	1710239005403
CreateUser	string	El ID de la cuenta del creador.	1000
ModifyUser	string	El ID de la cuenta del modificador.	1000
DownstreamTasks	array<object>	Las tareas descendientes.
	array<object>
DependencyType	string	El tipo de dependencia de programación. Valores válidos: Normal: dependencia de programación del mismo ciclo CrossCycle: dependencia de programación entre ciclos	Normal
Task	object	La información sobre la tarea.
Name	string	El nombre de la tarea.	SQL node
Description	string	La descripción.	test
WorkflowId	integer	El ID del flujo de trabajo al que pertenece la tarea.	1234
InstanceMode	string	El modo de generación de instancias. Valores válidos: T+1 (generar al día siguiente) e Immediately (generar de inmediato).	T+1
Type	string	El tipo de la tarea.	ODPS_SQL
BaselineId	integer	El ID de la línea base.	1234
Priority	integer	La prioridad de la tarea. Valores válidos: de 1 a 8.	1
Timeout	integer	El tiempo de espera de ejecución de la tarea. Unidad: segundos.	3600
RerunMode	string	El modo de reejecución. Valores válidos: AllDenied: La tarea no se puede reejecutar independientemente de si se ejecuta correctamente o falla. FailureAllowed: La tarea se puede reejecutar solo después de que falle. AllAllowed: La tarea se puede reejecutar independientemente de si se ejecuta correctamente o falla.	AllAllowed
RerunTimes	integer	El número de veces que se reejecuta la tarea. Este parámetro surte efecto solo si el parámetro RerunMode se establece en AllAllowed o FailureAllowed.	3
RerunInterval	integer	El intervalo de reejecución. Unidad: segundos.	60
Trigger	object	El método de activación.
Type	string	El tipo de activación. Valores válidos: Scheduler: activación basada en un ciclo de programación Manual: activación manual	Scheduler
Recurrence	string	El modo de ejecución de la tarea después de activarse. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler. Valores válidos: Pause (en pausa), Skip (ejecución de prueba) y Normal (ejecución normal).	Normal
Cron	string	La expresión CRON. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler.	00 00 00 * * ?
StartTime	string	La hora de inicio del intervalo de tiempo durante el cual la tarea se programa periódicamente. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler.	1970-01-01 00:00:00
EndTime	string	La hora de finalización del intervalo de tiempo durante el cual la tarea se programa periódicamente. Este parámetro surte efecto solo si el parámetro Type se establece en Scheduler.	9999-01-01 00:00:00
Timezone	string	La zona horaria.	Asia/Shanghai
RuntimeResource	object	Las configuraciones del entorno de ejecución, como la información del grupo de recursos.
ResourceGroupId	string	El ID del grupo de recursos de programación configurado para la ejecución de la tarea.	S_res_group_524258031846018_1684XXXXXXXXX
Image	string	El ID de la imagen configurada para la ejecución de la tarea.	i-xxxxxx
Cu	string	El número de unidades de cómputo (CU) configuradas para la ejecución de la tarea.	0.25
DataSource	object	La información sobre el origen de datos asociado.
Name	string	El nombre del origen de datos.	mysql_test
Id	integer	El ID de la tarea.	1234
ProjectId	integer	El ID del espacio de trabajo.	100
EnvType	string	El entorno del espacio de trabajo. Valores válidos: Prod (producción) y Dev (desarrollo).	Prod
Owner	string	El ID de la cuenta del propietario de la tarea.	1000
CreateTime	integer	La hora de creación.	1710239005403
ModifyTime	integer	La hora de modificación.	1710239005403
CreateUser	string	El ID de la cuenta del creador.	1000
ModifyUser	string	El ID de la cuenta del modificador.	1000
TotalCount	integer	El número total de entradas devueltas.	100
PageSize	integer	El número de entradas por página.	10
PageNumber	integer	El número de página.	1

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX",
  "PagingInfo": {
    "Tasks": [
      {
        "Name": "Nodo SQL",
        "Description": "prueba",
        "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,
        "ProjectEnv": "Prod",
        "EnvType": "Prod",
        "Owner": "1000",
        "StepType": "Normal",
        "CreateTime": 1710239005403,
        "ModifyTime": 1710239005403,
        "CreateUser": "1000",
        "ModifyUser": "1000"
      }
    ],
    "DownstreamTasks": [
      {
        "DependencyType": "Normal",
        "Task": {
          "Name": "Nodo SQL",
          "Description": "prueba",
          "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
  }
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.