Todos os produtos
Search
Central de documentação

DataWorks:GetNode

Última atualização: Sep 29, 2026

Consulta as informações sobre um nó no Data Studio.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dataworks:*

get

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ProjectId

integer

Não

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.

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

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 na versão 8.0.0 e posteriores do SDK. Essa alteração não afeta o uso normal do SDK; os parâmetros ainda são retornados de acordo com o tipo definido no SDK. Falhas de compilação devido à alteração de tipo podem ocorrer apenas ao atualizar o SDK para uma versão posterior à 8.0.0. Nesse caso, os usuários precisam corrigir manualmente o tipo de dados.

86043887262011****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

22C97E95-F023-56B5-8852-B1A77A17XXXX

Node

object

Detalhes do nó do Data Studio.

ProjectId

integer

O ID do espaço de trabalho do DataWorks.

10000

Name

string

O nome do nó.

Node name

Owner

string

O proprietário do nó.

196596664824XXXX

CreateTime

integer

A hora em que o nó foi criado. Este valor é um timestamp UNIX.

1700539206000

ModifyTime

integer

A hora em que o nó foi modificado pela última vez. Este valor é um timestamp UNIX.

1700539206000

Spec

string

As informações do campo FlowSpec sobre este nó. Para mais informações, consulte FlowSpec.

{ "version": "1.1.0", "kind": "Node", "spec": { "nodes": [ { "recurrence": "Normal", "id": "860438872620113XXXX", "timeout": 0, "instanceMode": "T+1", "rerunMode": "Allowed", "rerunTimes": 3, "rerunInterval": 180000, "datasource": { "name": "odps_test", "type": "odps" }, "script": { "language": "odps-sql", "path": "XX/OpenAPI_Test/ODPS_SQL_Test", "runtime": { "command": "ODPS_SQL", "commandTypeId": 10 }, "content": "select now();", "id": "853573334108680XXXX" }, "trigger": { "type": "Scheduler", "id": "543680677872062XXXX", "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", "id": "623731286945488XXXX", "resourceGroupId": "7201XXXX" }, "name": "ODPS_SQL_Test", "owner": "110755000425XXXX", "metadata": { "owner": "110755000425XXXX", "ownerName": "XXXXX@test.XXX.com", "projectId": "307XXX" }, "inputs": { "nodeOutputs": [ { "data": "lwttest_standard_root", "artifactType": "NodeOutput" } ] }, "outputs": { "nodeOutputs": [ { "data": "860438872620113XXXX", "artifactType": "NodeOutput", "refTableName": "ODPS_SQL_Test", "isDefault": true } ] } } ], "flow": [ { "nodeId": "860438872620113XXXX", "depends": [ { "type": "Normal", "output": "lwttest_standard_root" } ] } ] }, "metadata": { "uuid": "860438872620113XXXX" } }

TaskId

integer

O ID da tarefa de agendamento correspondente após a implantação do nó.

700006680527

Id

string

O identificador exclusivo do nó do Data Studio.

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, ele é 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 para uma versão posterior à 8.0.0. Nesse caso, você deve atualizar manualmente o tipo de dados.

860438872620113XXXX

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX",
  "Node": {
    "ProjectId": 10000,
    "Name": "Node name",
    "Owner": "196596664824XXXX",
    "CreateTime": 1700539206000,
    "ModifyTime": 1700539206000,
    "Spec": "{\n    \"version\": \"1.1.0\",\n    \"kind\": \"Node\",\n    \"spec\": {\n        \"nodes\": [\n            {\n                \"recurrence\": \"Normal\",\n                \"id\": \"860438872620113XXXX\",\n                \"timeout\": 0,\n                \"instanceMode\": \"T+1\",\n                \"rerunMode\": \"Allowed\",\n                \"rerunTimes\": 3,\n                \"rerunInterval\": 180000,\n                \"datasource\": {\n                    \"name\": \"odps_test\",\n                    \"type\": \"odps\"\n                },\n                \"script\": {\n                    \"language\": \"odps-sql\",\n                    \"path\": \"XX/OpenAPI_Test/ODPS_SQL_Test\",\n                    \"runtime\": {\n                        \"command\": \"ODPS_SQL\",\n                        \"commandTypeId\": 10\n                    },\n                    \"content\": \"select now();\",\n                    \"id\": \"853573334108680XXXX\"\n                },\n                \"trigger\": {\n                    \"type\": \"Scheduler\",\n                    \"id\": \"543680677872062XXXX\",\n                    \"cron\": \"00 00 00 * * ?\",\n                    \"startTime\": \"1970-01-01 00:00:00\",\n                    \"endTime\": \"9999-01-01 00:00:00\",\n                    \"timezone\": \"Asia/Shanghai\",\n                    \"delaySeconds\": 0\n                },\n                \"runtimeResource\": {\n                    \"resourceGroup\": \"S_res_group_XXXX_XXXX\",\n                    \"id\": \"623731286945488XXXX\",\n                    \"resourceGroupId\": \"7201XXXX\"\n                },\n                \"name\": \"ODPS_SQL_Test\",\n                \"owner\": \"110755000425XXXX\",\n                \"metadata\": {\n                    \"owner\": \"110755000425XXXX\",\n                    \"ownerName\": \"XXXXX@test.XXX.com\",\n                    \"projectId\": \"307XXX\"\n                },\n                \"inputs\": {\n                    \"nodeOutputs\": [\n                        {\n                            \"data\": \"lwttest_standard_root\",\n                            \"artifactType\": \"NodeOutput\"\n                        }\n                    ]\n                },\n                \"outputs\": {\n                    \"nodeOutputs\": [\n                        {\n                            \"data\": \"860438872620113XXXX\",\n                            \"artifactType\": \"NodeOutput\",\n                            \"refTableName\": \"ODPS_SQL_Test\",\n                            \"isDefault\": true\n                        }\n                    ]\n                }\n            }\n        ],\n        \"flow\": [\n            {\n                \"nodeId\": \"860438872620113XXXX\",\n                \"depends\": [\n                    {\n                        \"type\": \"Normal\",\n                        \"output\": \"lwttest_standard_root\"\n                    }\n                ]\n            }\n        ]\n    },\n    \"metadata\": {\n        \"uuid\": \"860438872620113XXXX\"\n    }\n}",
    "TaskId": 700006680527,
    "Id": "860438872620113XXXX\n"
  }
}

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.