CreateNode - DataWorks - Centre de documentation Alibaba Cloud

Description de l'opération

Important Cette opération ne prend pas en charge les opérations par lot. Si plusieurs nœuds sont définis dans FlowSpec, tous les nœuds après le premier sont ignorés.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ProjectId	integer	Oui	L'identifiant de l'espace de travail DataWorks. Vous pouvez vous connecter à la console DataWorks et accéder à la page de gestion des espaces de travail pour obtenir cet identifiant. Ce paramètre spécifie l'espace de travail DataWorks pour cette opération d'appel d'API.	123456
ContainerId	string	Non	L'identifiant unique d'un conteneur dans lequel vous souhaitez créer le nœud. Le conteneur peut être un flux de travail ou un nœud de conteneur. Spécifiez ce paramètre lorsque vous devez créer le nœud à l'intérieur d'un conteneur. Important Si ce paramètre est spécifié, le champ path défini dans FlowSpec devient invalide. Important Ce champ était de type Long dans les versions du SDK antérieures à la 8.0.0 et est de type String dans le SDK 8.0.0 et les versions ultérieures. Ce changement n'affecte pas l'utilisation normale du SDK, et le paramètre est toujours retourné dans le type défini dans le SDK. Uniquement lors d'une mise à niveau traversant la version 8.0.0 du SDK, le changement de type peut entraîner des échecs de compilation du projet, et vous devez corriger manuellement le type de données.	23451286945488XXXX
Scene	string	Oui	Le scénario dans lequel le nœud est créé. Ce paramètre détermine si le nœud est créé dans la zone des nœuds manuels ou dans la zone de développement de données. DATAWORKS_MANUAL_WORKFLOW ne peut être utilisé que lorsque ContainerId est spécifié et que le conteneur est un flux de travail manuel. Valeurs valides : DATAWORKS_PROJECT : répertoire du projet. DATAWORKS_MANUAL_WORKFLOW : flux de travail manuel. DATAWORKS_MANUAL_TASK : tâche manuelle.	DATAWORKS_PROJECT
Spec	string	Oui	Les informations FlowSpec qui décrivent le nœud. Pour plus d'informations sur la spécification, consultez FlowSpec. Remarque Comment obtenir rapidement un modèle FlowSpec ? Dans DataStudio, ouvrez un nœud, cliquez sur Versions sur le côté droit, consultez la dernière version, puis consultez la configuration de planification. Cela fournit la description FlowSpec pour le nœud actuel. Vous pouvez utiliser la description FlowSpec dans la version pour créer rapidement un modèle qui répond à vos besoins. Remarque Comment spécifier le contenu du nœud ? Spécifiez le contenu du nœud dans le champ $.spec.nodes[].script.content. Remarque* Comment configurer le contenu d'un nœud de synchronisation par lot ? Écrivez un script en suivant l'étape 4 de la section Configurer un nœud de synchronisation par lot à l'aide de l'éditeur de code, et spécifiez le contenu dans le champ $.spec.nodes[*].script.content. Vous pouvez également créer un nœud de synchronisation par lot sur la page et obtenir le contenu du script en consultant la version.	{ "version": "1.1.0", "kind": "Node", "spec": { "nodes": [ { "recurrence": "Normal", "timeout": 0, "instanceMode": "T+1", "rerunMode": "Allowed", "rerunTimes": 3, "rerunInterval": 180000, "datasource": { "name": "odps_test" }, "script": { "path": "XX/OpenAPI_Test/odpsSQL_Test", "runtime": { "command": "ODPS_SQL" }, "content": "select now();" }, "trigger": { "type": "Scheduler", "cron": "00 00 00 * * ?", "startTime": "1970-01-01 00:00:00", "endTime": "9999-01-01 00:00:00", "timezone": "Asia/Shanghai", "delaySeconds": 0 }, "runtimeResource": { "resourceGroup": "S_res_group_XXXX_XXXX" }, "name": "odpsSQL_Test", "inputs": { "nodeOutputs": [ { "data": "project_root", "artifactType": "NodeOutput" } ] }, "outputs": { "nodeOutputs": [ { "data": "output_data", "artifactType": "NodeOutput", "refTableName": "odpsSQL_Test" } ] } } ] } }

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête. Vous pouvez utiliser cet identifiant pour localiser les journaux et résoudre les problèmes.	AFBB799F-8578-51C5-A766-E922EDB8XXXX
Id	string	L'identifiant unique du nœud de développement de données. Important Ce champ était de type Long dans les versions du SDK antérieures à la 8.0.0 et est de type String dans le SDK 8.0.0 et les versions ultérieures. Ce changement n'affecte pas l'utilisation normale du SDK, et le paramètre est toujours retourné dans le type défini dans le SDK. Uniquement lors d'une mise à niveau traversant la version 8.0.0 du SDK, le changement de type peut entraîner des échecs de compilation du projet, et vous devez corriger manuellement le type de données.	860438872620113XXXX

Exemples

JSON format

{
  "RequestId": "AFBB799F-8578-51C5-A766-E922EDB8XXXX",
  "Id": "860438872620113XXXX"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.