Todos os produtos
Search
Central de documentação

DataWorks:ListInstanceHistory

Última atualização: Jul 31, 2026

Obtém todos os registros de histórico de uma instância. Um registro de histórico é gerado sempre que um nó é reexecutado.

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

InstanceId

integer

Sim

O ID da instância. Você pode chamar ListInstances para obter o ID.

1234

ProjectEnv

string

Não

O ambiente do workspace. Valores válidos: PROD (ambiente de produção) e DEV (ambiente de desenvolvimento). Valor padrão: PROD.

PROD

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

RequestId

string

O ID da solicitação. Usado para localizar logs e solucionar problemas.

E6F0DBDD-5AD****

Success

boolean

Indica se a chamada foi bem-sucedida. Valores válidos:\n- true: A chamada foi bem-sucedida.\n- false: A chamada falhou.

true

Instances

array<object>

A lista de instâncias.

object

Os detalhes da instância.

Status

string

O status do nó. Valores válidos:\n\n- NOT_RUN: O nó não foi executado.\n- WAIT_TIME: O nó está aguardando o horário agendado (DueTime ou CycTime) chegar.\n- WAIT_RESOURCE: O nó está aguardando recursos.\n- RUNNING: O nó está em execução.\n- CHECKING: O nó foi enviado ao Data Quality para verificação de dados.\n- CHECKING_CONDITION: O nó está passando por verificação de condição de ramificação.\n- FAILURE: O nó falhou na execução.\n- SUCCESS: O nó foi executado com sucesso.

NOT_RUN

CycTime

integer

O horário de execução agendada do nó, no formato de timestamp.

1590422400000

BeginRunningTime

integer

O horário em que a instância começou a ser executada, no formato de timestamp.

1590416703313

FinishTime

integer

O horário em que o nó agendado terminou a execução, no formato de timestamp.

1590416703313

ErrorMessage

string

[Descontinuado] A mensagem de erro retornada quando a instância falhou na execução. Este campo está descontinuado. Você pode chamar a operação GetInstanceLog para obter as informações de erro do nó.

error message

CreateTime

integer

O horário em que a instância foi criada.\n\nO valor é um número de 13 dígitos, como 1590416703313.

1590416703313

DagId

integer

O ID do fluxo de trabalho.

33845

TaskType

string

O tipo de agendamento da instância do nó. Valores válidos:\n\n- NORMAL(0): Um nó de agendamento normal. O nó é agendado diariamente.\n- MANUAL(1): Um nó manual. O nó não é agendado diariamente.\n- PAUSE(2): Um nó congelado. O nó é agendado diariamente, mas é definido como falha quando o agendamento começa.\n- SKIP(3): Um nó de dry-run. O nó é agendado diariamente, mas é definido como sucesso quando o agendamento começa.\n- SKIP_UNCHOOSE(4): Um nó que não foi selecionado em um fluxo de trabalho temporário. Este tipo de nó existe apenas em fluxos de trabalho temporários e é definido como sucesso quando o agendamento começa.\n- SKIP_CYCLE(5): Um nó semanal ou mensal que não atingiu seu ciclo de execução. O nó é agendado diariamente, mas é definido como sucesso quando o agendamento começa.\n- CONDITION_UNCHOOSE(6): Um nó downstream que não foi selecionado por um nó de ramificação (IF) upstream. O nó é diretamente definido como dry-run.\n- REALTIME_DEPRECATED(7): Uma instância periódica expirada gerada em tempo real. Este tipo de nó é diretamente definido como sucesso.

NORMAL(0)

DagType

string

O tipo de Verificação de Qualidade de Dados (DQC). Valores válidos:\n\n- 0: associado ao DQC.\n- 1: não associado ao DQC.

1

ModifyTime

integer

O horário em que o nó agendado foi modificado pela última vez.\n\nO valor é um número de 13 dígitos, como 1590416703313.

1590416703313

InstanceId

integer

O ID da instância.

1234

BeginWaitResTime

integer

O horário em que a instância começou a aguardar recursos.\n\nO valor é um número de 13 dígitos, como 1590416703313.

1590416703313

Bizdate

integer

A data de negócios em que o nó agendado foi executado. Este valor é tipicamente um dia antes do horário de execução do nó.\n\nO valor é um número de 13 dígitos, como 1590336000000.

1590336000000

NodeName

string

O nome do nó.

kzh

BeginWaitTimeTime

integer

O horário em que a instância começou a aguardar o agendamento.\n\nO valor é um número de 13 dígitos, como 1590416703313.

1590416703313

NodeId

integer

O ID do nó.

33115

InstanceHistoryId

integer

O ID do arquivo de histórico da instância.

1

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "E6F0DBDD-5AD****",
  "Success": true,
  "Instances": [
    {
      "Status": "NOT_RUN",
      "CycTime": 1590422400000,
      "BeginRunningTime": 1590416703313,
      "FinishTime": 1590416703313,
      "ErrorMessage": "error message",
      "CreateTime": 1590416703313,
      "DagId": 33845,
      "TaskType": "NORMAL(0)",
      "DagType": "1",
      "ModifyTime": 1590416703313,
      "InstanceId": 1234,
      "BeginWaitResTime": 1590416703313,
      "Bizdate": 1590336000000,
      "NodeName": "kzh",
      "BeginWaitTimeTime": 1590416703313,
      "NodeId": 33115,
      "InstanceHistoryId": 1
    }
  ]
}

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.