Todos os produtos
Search
Central de documentação

DataWorks:GetNode

Última atualização: Jul 31, 2026

Obtém os detalhes de um nó.

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

NodeId

integer

Sim

O ID do nó. Você pode chamar a operação ListNodes para consultar o ID do nó.

1234

ProjectEnv

string

Sim

O ambiente do workspace. Valores válidos: PROD e DEV.

Valores válidos:

  • PROD :

    Ambiente de produção.

  • DEV :

    Ambiente de desenvolvimento.

PROD

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A entidade da resposta.

HttpStatusCode

integer

O código de status HTTP.

200

RequestId

string

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

E6F0DBDD-5AD****

ErrorMessage

string

A mensagem de erro.

The connection does not exist

ErrorCode

string

O código de erro.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Indica se a solicitação foi bem-sucedida.

true

Data

object

Os detalhes do nó.

SchedulerType

string

O tipo de agendamento. Valores válidos:

  • NORMAL: Nó de agendamento normal.

  • MANUAL: Nó manual que não é agendado regularmente.

  • PAUSE: Nó pausado.

  • SKIP: Nó de dry-run que é agendado regularmente, mas é definido diretamente como bem-sucedido quando o agendamento começa.

NORMAL

RepeatInterval

integer

O intervalo no qual o nó é reagendado após uma falha.

60

Repeatability

string

Indica se o nó pode ser reexecutado.

true

RepeatMode

integer

O modo de reexecução. Um valor de 0 indica que o nó pode ser reexecutado apenas em caso de falha. Um valor de 1 indica que o nó pode ser reexecutado em todos os casos. Um valor de 2 indica que o nó não pode ser reexecutado em nenhum caso.

1

ProjectId

integer

O ID do workspace.

1234

ProgramType

string

O tipo do nó.

ODPS_SQL

Priority

integer

A prioridade do nó. Valores válidos: 1, 3, 5, 7 e 8.

1

OwnerId

string

O ID do proprietário do nó.

17366294****

Connection

string

A string de conexão.

odps_source_dev

ParamValues

string

Os parâmetros adicionais.

a=b

RelatedFlowId

integer

O ID do fluxo de trabalho associado.

123

DqcType

integer

O tipo de DQC. Um valor de 0 indica que nenhuma regra de DQC está associada. Um valor de 1 indica que uma regra de DQC está associada.

1

BaselineId

integer

O ID da linha de base. O ID da linha de base configurado para o nó como um nó folha é retornado. Se nenhuma linha de base estiver configurada, um valor padrão do workspace será retornado.

123456

Description

string

A descrição do nó.

test

NodeName

string

O nome do nó.

sql_node

ResGroupName

string

O nome do grupo de recursos.

Default Resource Group

BusinessId

integer

O ID do fluxo de trabalho.

123

DqcDescription

string

A string da regra de particionamento de DQC.

[{"projectName":"test_0923001","tableName":"test_table_001","partition":"ds\u003d$[yyyymmdd]"},{"projectName":"test_0923001","tableName":"test_table_002","partition":"NOTAPARTITIONTABLE"}]

CronExpress

string

A expressão CRON.

00 00 00 * * ?

NodeId

integer

O ID do nó.

1234

ResGroupIdentifier

string

O identificador exclusivo do grupo de recursos.

group_123

FileType

integer

O tipo de arquivo. Diferentes tipos de arquivo possuem códigos diferentes. Para mais informações, consulte Nós do DataWorks.

10

FileId

integer

O ID do arquivo.

Aviso Este campo está obsoleto.

123

FileVersion

integer

A versão do arquivo.

1

DeployDate

integer

A data de implantação.

O valor é um número de 13 dígitos, como 1727280000000.

1727280000000

CreateTime

integer

A hora de criação.

O valor é um número de 13 dígitos, como 1727280000000.

1727280000000

ModifyTime

integer

A hora da modificação.

O valor é um número de 13 dígitos, como 1727280000000.

1727280000000

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "RequestId": "E6F0DBDD-5AD****",
  "ErrorMessage": "The connection does not exist.",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "SchedulerType": "NORMAL",
    "RepeatInterval": 60,
    "Repeatability": "true",
    "RepeatMode": 1,
    "ProjectId": 1234,
    "ProgramType": "ODPS_SQL",
    "Priority": 1,
    "OwnerId": "17366294****",
    "Connection": "odps_source_dev",
    "ParamValues": "a=b",
    "RelatedFlowId": 123,
    "DqcType": 1,
    "BaselineId": 123456,
    "Description": "test",
    "NodeName": "sql节点",
    "ResGroupName": "默认资源组",
    "BusinessId": 123,
    "DqcDescription": "[{\"projectName\":\"test_0923001\",\"tableName\":\"test_table_001\",\"partition\":\"ds\\u003d$[yyyymmdd]\"},{\"projectName\":\"test_0923001\",\"tableName\":\"test_table_002\",\"partition\":\"NOTAPARTITIONTABLE\"}]",
    "CronExpress": "00 00 00 * * ?",
    "NodeId": 1234,
    "ResGroupIdentifier": "group_123",
    "FileType": 10,
    "FileId": 123,
    "FileVersion": 1,
    "DeployDate": 1727280000000,
    "CreateTime": 1727280000000,
    "ModifyTime": 1727280000000
  }
}

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.