Todos os produtos
Search
Central de documentação

DataWorks:CreateNode

Última atualização: Sep 29, 2026

Cria um nó do Data Studio na nova versão do Data Studio.

Descrição da operação

Importante Esta operação não suporta operações em lote. Se mais de um nó for definido no FlowSpec, todos os nós após o primeiro serão ignorados.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ProjectId

integer

Sim

O ID do espaço de trabalho do DataWorks. Você pode fazer login no console do DataWorks e acessar a página Gerenciamento de Espaços de Trabalho para obter o ID.

Este parâmetro especifica o espaço de trabalho do DataWorks para esta operação de chamada de API.

123456

ContainerId

string

Não

O identificador exclusivo de um contêiner no qual você deseja criar o nó. O contêiner pode ser um workflow ou um nó de contêiner. Especifique este parâmetro quando precisar criar o nó dentro de um contêiner.

Importante Se este parâmetro for especificado, o campo path definido no FlowSpec se tornará inválido.
Importante Este campo era do tipo Long nas versões do SDK anteriores à 8.0.0 e é do tipo String no SDK 8.0.0 e posterior. Esta alteração não afeta o uso normal do SDK, e o parâmetro ainda é retornado no tipo definido no SDK. Somente ao atualizar para uma versão do SDK superior à 8.0.0, a alteração de tipo pode causar falhas na compilação do projeto, sendo necessário corrigir manualmente o tipo de dados.

23451286945488XXXX

Scene

string

Sim

O cenário no qual o nó é criado. Este parâmetro determina se o nó é criado na área de nós manuais ou na área do Data Studio. DATAWORKS_MANUAL_WORKFLOW pode ser usado somente quando ContainerId é especificado e o contêiner é um workflow manual.

Valores válidos:

  • DATAWORKS_PROJECT: diretório do projeto.

  • DATAWORKS_MANUAL_WORKFLOW: workflow manual.

  • DATAWORKS_MANUAL_TASK: tarefa manual.

DATAWORKS_PROJECT

Spec

string

Sim

As informações do FlowSpec que descrevem o nó. Para obter mais informações sobre a especificação, consulte FlowSpec.

Nota

Como obter rapidamente um modelo do FlowSpec?

  • No Data Studio, abra um nó, clique em Versões no lado direito, visualize a versão mais recente e, em seguida, visualize a configuração de agendamento. Isso fornece a descrição do FlowSpec para o nó atual. Você pode usar a descrição do FlowSpec na versão para criar rapidamente um modelo que atenda aos seus requisitos.

Nota

Como especificar o conteúdo do nó?

  • Especifique o conteúdo do nó no campo $.spec.nodes[*].script.content.

Nota

Como configurar o conteúdo de um nó de sincronização em lote?

{ "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" } ] } } ] } }

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Schema da resposta.

RequestId

string

O ID da solicitação. Você pode usar este ID para localizar logs e solucionar problemas.

AFBB799F-8578-51C5-A766-E922EDB8XXXX

Id

string

O identificador exclusivo do nó do Data Studio.

Nota

<notice>Este campo era do tipo Long nas versões do SDK anteriores à 8.0.0 e é do tipo String no SDK 8.0.0 e posterior. Esta alteração não afeta o uso normal do SDK, e o parâmetro ainda é retornado no tipo definido no SDK. Somente ao atualizar para uma versão do SDK superior à 8.0.0, a alteração de tipo pode causar falhas na compilação do projeto, sendo necessário corrigir manualmente o tipo de dados.></notice>

860438872620113XXXX

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.