Todos os produtos
Search
Central de documentação

DataWorks:UpdateNode

Última atualização: Sep 29, 2026

Atualiza as informações básicas de um nó no Data Studio. Esta operação de API realiza uma atualização incremental. As informações de atualização são descritas por meio do FlowSpec.

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 Espaço de Trabalho para consultar o ID.

10000

Id

string

Sim

O identificador exclusivo do nó do Data Studio.

Nota

Este campo é do tipo Long nas versões do SDK anteriores à 8.0.0 e do tipo String nas versões do SDK 8.0.0 e posteriores. Essa alteração não afeta o uso normal do SDK; o parâmetro ainda será retornado de acordo com o tipo definido no SDK. No entanto, podem ocorrer falhas de compilação devido à alteração de tipo apenas ao atualizar o SDK para uma versão igual ou superior à 8.0.0. Nesse caso, você deve atualizar manualmente o tipo de dados.

860438872620113XXXX

Spec

string

Sim

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

Como obter rapidamente um modelo do FlowSpec

Abra o nó no Data Studio, clique em Versões à direita, visualize a versão mais recente e a configuração de agendamento para obter a descrição do FlowSpec do nó atual. Use essa descrição para criar rapidamente um modelo que atenda aos requisitos.

Como especificar o conteúdo do nó

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

{ "version": "1.1.0", "kind": "Node", "spec": { "nodes": [ { "id": "860438872620113XXXX", "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" } ] } } ], "flow": [ { "nodeId": "860438872620113XXXX", "depends": [ { "type": "Normal", "output": "project_root" } ] } ] } }

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação. Você pode solucionar problemas com base no ID.

99EBE7CF-69C0-5089-BE3E-79563C31****

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos: true (bem-sucedida) e false (falha).

true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "99EBE7CF-69C0-5089-BE3E-79563C31****",
  "Success": true
}

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.