Todos los productos
Search
Centro de documentos

Data Management:CreateTask

Última actualización: Sep 01, 2026

Crea un nodo de tarea para un flujo de tareas.

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

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dms:CreateTask

create

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

Tid

integer

No

El ID del inquilino.

Nota

Para ver el ID del inquilino, pase el puntero sobre la imagen de perfil en la esquina superior derecha de la consola de Data Management (DMS). Para obtener más información, consulte la sección "Ver información sobre el inquilino actual" del tema Gestionar inquilinos de DMS.

3***

DagId

integer

Sí

El ID del flujo de tareas. Puede llamar a la operación ListTaskFlow o ListLhTaskFlowAndScenario para consultar el ID del flujo de tareas.

7***

NodeName

string

Sí

El nombre del nodo que desea crear.

zhttest

NodeType

string

Sí

El tipo de nodo que desea crear. Para obtener más información sobre los valores válidos de este parámetro, consulte Parámetro NodeType.

NORMAL_SQL

NodeContent

string

No

La configuración del nodo.

test

TimeVariables

string

No

Las variables de tiempo configuradas para el nodo.

test

NodeOutput

string

No

Las variables de salida configuradas para la tarea.

test

GraphParam

string

No

La posición del nodo en el grafo acíclico dirigido (DAG).

test

Descripción de parámetros relacionados con nodos

La configuración de un nodo varía según el tipo de nodo. Este tema es una descripción complementaria de las operaciones relacionadas con nodos de tarea, como CreateTask y UpdateTaskOutput. Los parámetros NodeParam, NodeContent y GraphParam se aplican a todas las operaciones relacionadas con nodos de tarea.
Solo los nodos como asignación SQL de instancia única, código de script y comando remoto de Elastic Compute Service (ECS) tienen variables de salida. Las configuraciones de las variables de salida varían según el tipo de nodo. Para obtener más información, consulte el tema relacionado de la operación UpdateTaskOutput.

SQL para instancia única

  • DagId

  • NodeName

  • NodeType: 1

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dbId":123456, // El ID de la base de datos.
    "sql":"/* Utilice la sintaxis de base de datos para el nodo actual para escribir sentencias SQL */", // La sentencia SQL.
    "dbType":"lindorm_sql" // El tipo de base de datos.
}

Script

  • DagId

  • NodeName

  • NodeType: 28

  • NodeParam

  • GraphParam

  • NodeOutput

{
    "outputs":[
        {
            "extractMethod":"json", // El valor está en formato JSON.
            "variableName":"var", // El nombre de la variable.
            "description":"demo desc" // La descripción de la variable.
        }
    ]
}
  • NodeContent:

{
    "regionId":"cn-hangzhou", // El ID de la región.
    "gatewayId":"dg-xxxxxxxxxxxxxx", // El ID de la puerta de enlace.
    "gatewayInstanceId":"dg-node-xxxxxxxxxxxxxx", // El ID de la instancia de puerta de enlace.
    "scriptFileName":"demo.sh", // El nombre del archivo.
    "args":[ // Los parámetros de ejecución.
        "-n value",
        "-n1 value1"
    ]
}

Cambio de datos sin bloqueo

  • DagId

  • NodeName

  • NodeType: 24

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dbId":123456, // El ID de la base de datos.
    "sql":"/* Utilice la sintaxis de base de datos para el nodo actual para escribir sentencias SQL */", // La sentencia SQL.
    "dbType":"polardb" // El tipo de base de datos.
}

Asignación SQL para instancia única

  • DagId

  • NodeName

  • NodeType: 32

  • NodeParam

  • GraphParam

  • NodeOutput:

{
    "outputs":[
        {
            /*
            // La configuración de extracción de variables.
            {
                "row":0, // Filas. Un valor de -1 indica todas las filas.
                "column":-1, // Columnas. Un valor de -1 indica todas las columnas.
                "combiner":"," // El delimitador. Si selecciona todas las filas o columnas, debe especificar un delimitador. El valor devuelto de la variable es una cadena.
            }
            */
            "extractMethod":"{\"row\":0,\"column\":-1,\"combiner\":\",\"}", 
            "variableName":"var", // El nombre de la variable.
            "description":"For demo" // La descripción de la variable.
        }
    ]
}
  • NodeContent:

{
    "dbId":123456, // El ID de la base de datos.
    "sql":"/* Utilice la sintaxis de base de datos para el nodo actual para escribir sentencias SQL. Solo se admiten sentencias SELECT. De forma predeterminada, el número máximo de filas devueltas es 30. *", // La sentencia SQL.
    "dbType":"lindorm_cql" // El tipo de base de datos.
}

Verificación de dependencias

  • DagId

  • NodeName

  • NodeType: 2

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dependentDAGId":132, // Objeto de dependencia: flujo de tareas.
    "dependentNodeId":"", // Objeto de dependencia: un solo nodo. De forma predeterminada, el objeto de dependencia es el flujo de tareas especificado.
    "dependentStartTimePattern":"yyyy-MM-dd HH:mm|-2d+0h+0m", // El desplazamiento de la hora de inicio.
    "dependentEndTimePattern":"yyyy-MM-dd HH:mm|+1d +0h+0m", // El desplazamiento de la hora de finalización.
    "multiSuccessStrategy":2, // La política de verificación de instancias. Un valor de 0 especifica que el nodo anterior más reciente se ejecutó correctamente. Un valor de 1 especifica que todos los nodos se ejecutaron correctamente. Un valor de 2 especifica que el nodo indicado se ejecutó correctamente.
    "multiSuccessStrategyIndex":1 // Política de verificación de instancias: El nodo x+1 se ejecutó correctamente.
}

Verificación de estado de una columna de tiempo en una tabla

  • DagId

  • NodeName

  • NodeType: 2

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dependentDAGId":132, // Objeto de dependencia: flujo de tareas.
    "dependentNodeId":"", // Objeto de dependencia: un solo nodo. De forma predeterminada, el objeto de dependencia es el flujo de tareas especificado.
    "dependentStartTimePattern":"yyyy-MM-dd HH:mm|-2d+0h+0m", // El desplazamiento de la hora de inicio.
    "dependentEndTimePattern":"yyyy-MM-dd HH:mm|+1d +0h+0m", // El desplazamiento de la hora de finalización.
    "multiSuccessStrategy":2, // La política de verificación de instancias. Un valor de 0 especifica que el nodo anterior más reciente se ejecutó correctamente. Un valor de 1 especifica que todos los nodos se ejecutaron correctamente. Un valor de 2 especifica que el nodo indicado se ejecutó correctamente.
    "multiSuccessStrategyIndex":1 // Política de verificación de instancias: El nodo x+1 se ejecutó correctamente.
}

Verificación de estado SQL

  • DagId

  • NodeName

  • NodeType: 25

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dbId":123456,
    "sql":"/* Utilice la sintaxis de base de datos para el nodo actual para escribir sentencias SQL*/ \n\n select 1 from abc",
    "dbType":"lindorm_cql"
}

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los parámetros de respuesta.

RequestId

string

El ID de la solicitud. Puede utilizar el ID para consultar registros y solucionar problemas.

CFD8FE00-36D9-4C1B-940D-65A7B73D9066

ErrorCode

string

El código de error devuelto.

InvalidParameterValid

ErrorMessage

string

El mensaje de error devuelto si la solicitud falló.

InvalidParameterValid

Success

boolean

Indica si la solicitud se realizó correctamente. Valores válidos:

  • true

  • false

true

NodeId

integer

El ID del nodo de tarea devuelto cuando se creó la tarea.

3***

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "CFD8FE00-36D9-4C1B-940D-65A7B73D9066",
  "ErrorCode": "InvalidParameterValid",
  "ErrorMessage": "InvalidParameterValid",
  "Success": true,
  "NodeId": 0
}

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.