ListNodeDependencies - DataWorks: Central de Documentação do Alibaba Cloud

Obtém os nós dependentes de um nó de desenvolvimento de dados especificado de forma paginada.

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:*

list

*All Resource

*

Nenhuma

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 de configuração do workspace para obter o ID do workspace. Este parâmetro especifica o workspace do DataWorks usado para esta chamada de API.	10001
Id	string	Sim	O identificador exclusivo do nó de desenvolvimento de dados. Importante Este campo é do tipo Long em 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. O parâmetro ainda é retornado com base no tipo de dados definido no SDK. A alteração de tipo pode causar falhas na compilação do projeto apenas quando você atualiza o SDK para uma versão posterior à 8.0.0. Nesse caso, é necessário corrigir manualmente o tipo de dados.	860438872620113XXXX
PageNumber	integer	Não	O número da página. As páginas começam em 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valor padrão: 10. Valor máximo: 100.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação. Você pode usar o ID para localizar logs e solucionar problemas.	204EAF68-CCE3-5112-8DA0-E7A60F02XXXX
PagingInfo	object	As informações de paginação.
TotalCount	string	O número total de entradas que atendem às condições especificadas.	90
PageSize	string	O número de entradas retornadas por página.	10
PageNumber	string	O número da página retornada.	1
Nodes	array<object>	A lista de nós dependentes consultados.
	array<object>	O nó dependente.
Description	string	A descrição do nó.	Node description
Name	string	O nome do nó de desenvolvimento de dados.	Node name
ProjectId	integer	O ID do workspace ao qual o nó de desenvolvimento de dados pertence.	65133
Owner	string	O proprietário do nó de desenvolvimento de dados.	110755000425XXXX
CreateTime	integer	O carimbo de data/hora em que o nó de desenvolvimento de dados foi criado.	1724505917000
ModifyTime	integer	O carimbo de data/hora em que o nó de desenvolvimento de dados foi modificado pela última vez.	1724505917000
DataSource	object	A fonte de dados.
Name	string	O nome da fonte de dados.	odps_first
Type	string	O tipo da fonte de dados.	odps
TaskId	integer	O ID da tarefa de agendamento.	580667964888595XXXX
Tags	array<object>	As informações da tag. Este campo não é utilizado.
	object	As informações da tag. Este campo não é utilizado.
Key	string	A chave da tag.	null
Value	string	O valor da tag.	null
Strategy	object	A política de agendamento.
Timeout	integer	O tempo limite, em milissegundos.	0
InstanceMode	string	O modo pelo qual as instâncias são geradas. Valores válidos: T+1 Immediately	T+1
RerunMode	string	O modo de reexecução. Valores válidos: Allowed Denied FailureAllowed	Allowed
RerunTimes	integer	O número de tentativas após uma falha.	3
RerunInterval	integer	O tempo de nova tentativa após a falha, em milissegundos.	180000
Outputs	object	A saída do nó.
Variables	array<object>	A lista de variáveis.
	array<object>	A variável.
Name	string	O nome da variável.	output
ArtifactType	string	O tipo do artefato.	Variable
Scope	string	O escopo da variável. Valores válidos: NodeParameter NodeContext Workflow Workspace	NodeParameter
Type	string	O tipo da variável. Valores válidos: NoKvVariableExpression Constant PassThrough System NodeOutput	Constant
Value	string	O valor da variável.	111
Node	object	O nó ao qual a variável pertence.
Output	string	A saída do nó que corresponde à variável.	463497880880954XXXX
Id	string	O ID da variável. Importante Este campo era do tipo Long antes do SDK 8.0.0 e é do tipo String no SDK 8.0.0 e versões posteriores. Essa alteração não afeta o uso normal do SDK. O parâmetro ainda é retornado com base no tipo definido no SDK. A alteração de tipo pode causar falhas na compilação do projeto apenas quando você atualiza o SDK para uma versão posterior à 8.0.0. Nesse caso, você deve corrigir manualmente o tipo de dados.	543217824470354XXXX
NodeOutputs	array<object>	A lista de saídas do nó.
	object	O item de saída do nó.
Data	string	A saída do nó.	463497880880954XXXX
RefTableName	string	O nome da tabela de dados de destino gerada pelo nó. Este campo fornece um nome semântico fácil de entender para ajudar você a identificar rapidamente o conteúdo de saída. Ele é usado apenas para fins de exibição e referência e não possui restrições lógicas reais.	testProject.testTableName
Tables	array<object>	A lista de tabelas.
	object	O item de saída da tabela.
Guid	string	O ID da tabela.	odps.autotest.test_output_table_1
Inputs	object	A entrada do nó.
Variables	array<object>	A lista de variáveis.
	array<object>	A variável.
Name	string	O nome da variável.	input
ArtifactType	string	O tipo do artefato.	Variable
Scope	string	O escopo. Valores válidos: NodeParameter NodeContext Workflow Workspace	NodeParameter
Type	string	O tipo. Valores válidos: NoKvVariableExpression Constant PassThrough System NodeOutput	Constant
Value	string	O valor da variável.	111
Node	object	O nó ao qual a variável pertence.
Output	string	A saída do nó.	860438872620113XXXX
Id	string	O ID da variável. Importante Este campo era do tipo Long antes do SDK 8.0.0 e é do tipo String no SDK 8.0.0 e versões posteriores. Essa alteração não afeta o uso normal do SDK. O parâmetro ainda é retornado com base no tipo definido no SDK. A alteração de tipo pode causar falhas na compilação do projeto apenas quando você atualiza o SDK para uma versão posterior à 8.0.0. Nesse caso, você deve corrigir manualmente o tipo de dados.	543218872620113XXXX
NodeOutputs	array<object>	A lista de saídas do nó.
	object	O item de saída do nó.
Data	string	A saída do nó.	860438872620113XXXX
RefTableName	string	O nome da tabela de dados de destino gerada pelo nó. Este campo fornece um nome semântico fácil de entender para ajudar você a identificar rapidamente o conteúdo de saída. Ele é usado apenas para fins de exibição e referência e não possui restrições lógicas reais.	testProject.testTableName
Tables	array<object>	A lista de tabelas.
	object	O item de saída da tabela.
Guid	string	O ID da tabela.	odps.autotest.test_output_table_1
Trigger	object	O gatilho.
Type	string	O tipo de gatilho. Valores válidos: Scheduler: Agendamento periódico. Manual: Agendamento manual. Streaming: Agendador de streaming.	Scheduler
Cron	string	A expressão Cron para agendamento.	00 00 00 * * ?
StartTime	string	A hora de início em que o agendamento entra em vigor. O formato é yyyy-MM-dd HH:mm:ss.	1970-01-01 00:00:00
EndTime	string	A hora de término de vigência do agendamento. O formato é yyyy-MM-dd HH:mm:ss.	9999-01-01 00:00:00
Timezone	string	O fuso horário.	Asia/Shanghai
Id	string	O identificador exclusivo do gatilho. Importante Este campo é do tipo Long antes do SDK 8.0.0 e do tipo String no SDK 8.0.0 e versões posteriores. Essa alteração não afeta o uso normal do SDK, e o parâmetro ainda é retornado com base no tipo definido no SDK. A alteração de tipo pode causar falhas de compilação do projeto apenas quando você atualiza o SDK para uma versão posterior à 8.0.0. Nesse caso, você deve corrigir manualmente o tipo de dados.	543680677872062XXXX
Script	object	As informações do script.
Path	string	O caminho do script.	root/demo
Runtime	object	O runtime.
Command	string	O comando usado para distinguir os tipos de nó.	ODPS_SQL
Id	string	O ID do script. Importante Este campo é do tipo Long antes do SDK 8.0.0 e do tipo String no SDK 8.0.0 e versões posteriores. Essa alteração não afeta o uso normal do SDK, e o parâmetro ainda é retornado com base no tipo definido no SDK. A alteração de tipo pode causar falhas de compilação do projeto apenas quando você atualiza o SDK para uma versão posterior à 8.0.0. Nesse caso, você deve corrigir manualmente o tipo de dados.	853573334108680XXXX
RuntimeResource	object	As informações do grupo de recursos.
ResourceGroupId	string	O ID do grupo de recursos.	S_res_group_XXXX_XXXX
Recurrence	string	O tipo de agendamento. Valores válidos: Normal: O nó é executado normalmente. Pause: O nó é pausado e a execução de nós downstream que dependem do nó atual é bloqueada. Skip: O nó é definido para dry run. O sistema retorna diretamente uma resposta de sucesso com uma duração de execução de 0 segundos. Isso não bloqueia a execução de nós downstream nem consome recursos.	Normal
Id	string	O identificador exclusivo do nó de desenvolvimento de dados. Importante Este campo é do tipo Long antes do SDK 8.0.0 e do tipo String no SDK 8.0.0 e versões posteriores. Essa alteração não afeta o uso normal do SDK, e o parâmetro ainda é retornado com base no tipo definido no SDK. A alteração de tipo pode causar falhas de compilação do projeto apenas quando você atualiza o SDK para uma versão posterior à 8.0.0. Nesse caso, você deve corrigir manualmente o tipo de dados.	723932906364267XXXX

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "204EAF68-CCE3-5112-8DA0-E7A60F02XXXX",
  "PagingInfo": {
    "TotalCount": "90",
    "PageSize": "10",
    "PageNumber": "1",
    "Nodes": [
      {
        "Description": "Node description",
        "Name": "Node name",
        "ProjectId": 65133,
        "Owner": "110755000425XXXX",
        "CreateTime": 1724505917000,
        "ModifyTime": 1724505917000,
        "DataSource": {
          "Name": "odps_first",
          "Type": "odps"
        },
        "TaskId": 0,
        "Tags": [
          {
            "Key": "null",
            "Value": "null"
          }
        ],
        "Strategy": {
          "Timeout": 0,
          "InstanceMode": "T+1",
          "RerunMode": "Allowed",
          "RerunTimes": 3,
          "RerunInterval": 180000
        },
        "Outputs": {
          "Variables": [
            {
              "Name": "output",
              "ArtifactType": "Variable",
              "Scope": "NodeParameter",
              "Type": "Constant",
              "Value": "111",
              "Node": {
                "Output": "463497880880954XXXX"
              },
              "Id": "543217824470354XXXX"
            }
          ],
          "NodeOutputs": [
            {
              "Data": "463497880880954XXXX",
              "RefTableName": "testProject.testTableName"
            }
          ],
          "Tables": [
            {
              "Guid": "odps.autotest.test_output_table_1"
            }
          ]
        },
        "Inputs": {
          "Variables": [
            {
              "Name": "input",
              "ArtifactType": "Variable",
              "Scope": "NodeParameter",
              "Type": "Constant",
              "Value": "111",
              "Node": {
                "Output": "860438872620113XXXX"
              },
              "Id": "543218872620113XXXX"
            }
          ],
          "NodeOutputs": [
            {
              "Data": "860438872620113XXXX",
              "RefTableName": "testProject.testTableName"
            }
          ],
          "Tables": [
            {
              "Guid": "odps.autotest.test_output_table_1"
            }
          ]
        },
        "Trigger": {
          "Type": "Scheduler",
          "Cron": "00 00 00 * * ?",
          "StartTime": "1970-01-01 00:00:00",
          "EndTime": "9999-01-01 00:00:00",
          "Timezone": "Asia/Shanghai",
          "Id": "543680677872062XXXX"
        },
        "Script": {
          "Path": "root/demo",
          "Runtime": {
            "Command": "ODPS_SQL"
          },
          "Id": "853573334108680XXXX"
        },
        "RuntimeResource": {
          "ResourceGroupId": "S_res_group_XXXX_XXXX"
        },
        "Recurrence": "Normal",
        "Id": "723932906364267XXXX"
      }
    ]
  }
}

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.