Todos os produtos
Search
Central de documentação

DataWorks:CreateNode

Última atualização: Jun 26, 2026

Cria um nó no DataStudio. As informações sobre o nó são descritas usando FlowSpec.

Descrição da operação

Importante

Esta API não suporta operações em lote. Se você definir mais de um nó no FlowSpec, todos os nós exceto 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 workspace do DataWorks. Você pode fazer logon no console do DataWorks e acessar a página Workspace para consultar o ID.

Você deve configurar este parâmetro para especificar o workspace do DataWorks ao qual a operação de API é aplicada.

123456

ContainerId

string

Não

Especifique este parâmetro se você deseja criar o nó dentro de um contêiner. Este parâmetro representa o identificador exclusivo do contêiner, que pode ser um workflow ou um nó de contêiner.

Nota

Se este parâmetro for especificado, o campo path definido no FlowSpec será ignorado.

Nota

Antes da versão 8.0.0 do SDK, este campo é do tipo Long. Na versão 8.0.0 e posteriores do SDK, é do tipo String. Essa alteração não afeta o uso normal do SDK. O parâmetro é retornado com base no tipo definido no SDK. Falhas de compilação causadas pela alteração de tipo podem ocorrer apenas quando você atualiza o SDK entre versões anteriores e posteriores à 8.0.0. Nesse caso, você deve atualizar manualmente o tipo de dados.

23451286945488XXXX

Scene

string

Sim

Especifique este parâmetro se você deseja criar o nó dentro de um contêiner. Este parâmetro representa o identificador exclusivo do contêiner, que pode ser um workflow ou um nó de contêiner.

Nota

Se este parâmetro for especificado, o campo path definido no FlowSpec será ignorado.

Nota

Antes da versão 8.0.0 do SDK, este campo é do tipo Long. Na versão 8.0.0 e posteriores do SDK, é do tipo String. Essa alteração não afeta o uso normal do SDK. O parâmetro é retornado com base no tipo definido no SDK. Falhas de compilação causadas pela alteração de tipo podem ocorrer apenas quando você atualiza o SDK entre versões anteriores e posteriores à 8.0.0. Nesse caso, você deve atualizar manualmente o tipo de dados.

DATAWORKS_PROJECT

Spec

string

Sim

As informações do FlowSpec que descrevem o nó. Para mais informações, consulte FlowSpec.

Nota

Como obter rapidamente um modelo de FlowSpec?

  • Acesse o Data Studio, abra um nó, clique em Version no lado direito, encontre a versão mais recente e clique em Scheduling Settings para obter a descrição FlowSpec do nó atual. Você pode usar a descrição FlowSpec na versão para construir rapidamente um modelo que atenda aos seus requisitos.

Nota

Como configurar o conteúdo do nó?

  • Insira o código do nó no campo $.spec.nodes[].script.content.

Nota

Como configurar 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.

AFBB799F-8578-51C5-A766-E922EDB8XXXX

Id

string

O identificador exclusivo do nó do Data Studio.

Nota

Este campo é do tipo Long em versões do SDK anteriores à 8.0.0 e do tipo String em versões do SDK 8.0.0 e posteriores. Essa alteração não afeta o uso normal do SDK. O parâmetro é retornado com base no tipo definido no SDK. Falhas de compilação causadas pela alteração de tipo podem ocorrer apenas quando você atualiza o SDK entre versões anteriores e posteriores à 8.0.0. Nesse caso, você deve atualizar manualmente o tipo de dados.

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.