Tous les produits
Search
Centre de documentation

:CreateTask

Dernière mise à jour :Aug 07, 2026

Crée un nœud de tâche pour un flux de tâches.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dms:CreateTask

create

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Tid

integer

Non

L'identifiant du locataire.

Remarque

Pour afficher l'identifiant du locataire, placez le pointeur sur la photo de profil dans le coin supérieur droit de la console Data Management (DMS). Pour plus d'informations, consultez la section « Afficher les informations sur le locataire actuel » de la rubrique Gérer les locataires DMS.

3***

DagId

integer

Oui

L'identifiant du flux de tâches. Vous pouvez appeler l'opération ListTaskFlow ou ListLhTaskFlowAndScenario pour interroger l'identifiant du flux de tâches.

7***

NodeName

string

Oui

Le nom du nœud que vous souhaitez créer.

zhttest

NodeType

string

Oui

Le type du nœud que vous souhaitez créer. Pour plus d'informations sur les valeurs valides pour ce paramètre, consultez Paramètre NodeType.

NORMAL_SQL

NodeContent

string

Non

La configuration du nœud.

test

TimeVariables

string

Non

Les variables de temps configurées pour le nœud.

test

NodeOutput

string

Non

Les variables de sortie configurées pour la tâche.

test

GraphParam

string

Non

La position du nœud sur le graphe acyclique orienté (DAG).

test

Description des paramètres liés aux nœuds

La configuration d'un nœud varie en fonction du type de nœud. Cette rubrique fournit une description complémentaire des opérations liées aux nœuds de tâche, telles que CreateTask et UpdateTaskOutput. Les paramètres NodeParam, NodeContent et GraphParam s'appliquent à toutes les opérations liées aux nœuds de tâche.
Seuls les nœuds tels que l'affectation SQL pour instance unique, le code de script et la commande à distance Elastic Compute Service (ECS) possèdent des variables de sortie. Les configurations des variables de sortie varient en fonction du type de nœud. Pour plus d'informations, consultez la rubrique associée à l'opération UpdateTaskOutput.

SQL pour instance unique

  • DagId

  • NodeName

  • NodeType: 1

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dbId":123456, // L'identifiant de la base de données.
    "sql":"/* Utilisez la syntaxe de la base de données pour le nœud actuel afin de rédiger des instructions SQL */", // L'instruction SQL.
    "dbType":"lindorm_sql" // Le type de base de données.
}

Script

  • DagId

  • NodeName

  • NodeType: 28

  • NodeParam

  • GraphParam

  • NodeOutput

{
    "outputs":[
        {
            "extractMethod":"json", // La valeur est au format JSON.
            "variableName":"var", // Le nom de la variable.
            "description":"description de la démo" // La description de la variable.
        }
    ]
}
  • NodeContent:

{
    "regionId":"cn-hangzhou", // L'identifiant de la région.
    "gatewayId":"dg-xxxxxxxxxxxxxx", // L'identifiant de la passerelle.
    "gatewayInstanceId":"dg-node-xxxxxxxxxxxxxx", // L'identifiant de l'instance de passerelle.
    "scriptFileName":"demo.sh", // Le nom du fichier.
    "args":[ // Les paramètres d'exécution.
        "-n value",
        "-n1 value1"
    ]
}

Modification de données sans verrouillage

  • DagId

  • NodeName

  • NodeType: 24

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dbId":123456, // L'identifiant de la base de données.
    "sql":"/* Utilisez la syntaxe de la base de données pour le nœud actuel afin de rédiger des instructions SQL */", // L'instruction SQL.
    "dbType":"polardb" // Le type de base de données.
}

Affectation SQL pour instance unique

  • DagId

  • NodeName

  • NodeType: 32

  • NodeParam

  • GraphParam

  • NodeOutput:

{
    "outputs":[
        {
            /*
            // Les paramètres d'extraction de variable.
            {
                "row":0, // Lignes. Une valeur de -1 indique toutes les lignes.
                "column":-1, // Colonnes. Une valeur de -1 indique toutes les colonnes.
                "combiner":"," // Le délimiteur. Si vous sélectionnez toutes les lignes ou colonnes, vous devez spécifier un délimiteur. La valeur renvoyée de la variable est une chaîne.
            }
            */
            "extractMethod":"{\"row\":0,\"column\":-1,\"combiner\":\",\"}", 
            "variableName":"var", // Le nom de la variable.
            "description":"Pour la démonstration" // La description de la variable.
        }
    ]
}
  • NodeContent:

{
    "dbId":123456, // L'identifiant de la base de données.
    "sql":"/* Utilisez la syntaxe de la base de données pour le nœud actuel afin de rédiger des instructions SQL. Seules les instructions SELECT sont prises en charge. Par défaut, le nombre maximal de lignes renvoyées est de 30. */", // L'instruction SQL.
    "dbType":"lindorm_cql" // Le type de base de données.
}

Vérification des dépendances

  • DagId

  • NodeName

  • NodeType: 2

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dependentDAGId":132, // Objet de dépendance : flux de tâches.
    "dependentNodeId":"", // Objet de dépendance : un nœud unique. Par défaut, l'objet de dépendance est le flux de tâches spécifié.
    "dependentStartTimePattern":"yyyy-MM-dd HH:mm|-2d+0h+0m", // Le décalage de l'heure de début.
    "dependentEndTimePattern":"yyyy-MM-dd HH:mm|+1d +0h+0m", // Le décalage de l'heure de fin.
    "multiSuccessStrategy":2, // La stratégie de vérification d'instance. Une valeur de 0 indique que le nœud le plus précédent a réussi. Une valeur de 1 indique que tous les nœuds ont réussi. Une valeur de 2 indique que le nœud spécifié a réussi.
    "multiSuccessStrategyIndex":1 // Stratégie de vérification d'instance : le nœud x+1 a réussi.
}

Vérification de l'état d'une colonne temporelle dans une table

  • DagId

  • NodeName

  • NodeType: 2

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dependentDAGId":132, // Objet de dépendance : flux de tâches.
    "dependentNodeId":"", // Objet de dépendance : un nœud unique. Par défaut, l'objet de dépendance est le flux de tâches spécifié.
    "dependentStartTimePattern":"yyyy-MM-dd HH:mm|-2d+0h+0m", // Le décalage de l'heure de début.
    "dependentEndTimePattern":"yyyy-MM-dd HH:mm|+1d +0h+0m", // Le décalage de l'heure de fin.
    "multiSuccessStrategy":2, // La stratégie de vérification d'instance. Une valeur de 0 indique que le nœud le plus précédent a réussi. Une valeur de 1 indique que tous les nœuds ont réussi. Une valeur de 2 indique que le nœud spécifié a réussi.
    "multiSuccessStrategyIndex":1 // Stratégie de vérification d'instance : le nœud x+1 a réussi.
}

Vérification de l'état SQL

  • DagId

  • NodeName

  • NodeType: 25

  • NodeParam

  • GraphParam

  • NodeContent:

{
    "dbId":123456,
    "sql":"/* Utilisez la syntaxe de la base de données pour le nœud actuel afin de rédiger des instructions SQL */ \n\n select 1 from abc",
    "dbType":"lindorm_cql"
}

Éléments de réponse

Élément

Type

Description

Exemple

object

Les paramètres de réponse.

RequestId

string

L'identifiant de la requête. Vous pouvez utiliser cet identifiant pour interroger les journaux et résoudre les problèmes.

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

ErrorCode

string

Le code d'erreur renvoyé.

InvalidParameterValid

ErrorMessage

string

Le message d'erreur renvoyé en cas d'échec de la requête.

InvalidParameterValid

Success

boolean

Indique si la requête a réussi. Valeurs valides :

  • true

  • false

true

NodeId

integer

L'identifiant du nœud de tâche renvoyé lors de la création de la tâche.

3***

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.