Todos os produtos
Search
Central de documentação

DataWorks:ListCrawlerRuns

Última atualização: Sep 03, 2026

Consulta os registros de execução de um rastreador de metadados especificado por paginação, com filtragem opcional por intervalo de tempo e status de execução.

Descrição da operação

Cenários

Consulta os registros de execução de um rastreador de metadados especificado nos últimos 30 dias por paginação, com filtragem opcional por hora de início da execução e status.

Fluxo de trabalho recomendado

  1. Invoque ListCrawlers para obter o ID do rastreador.

  2. Invoque esta operação para consultar os registros de execução e os IDs das instâncias de nó.

  3. Para operações assíncronas, como iniciar ou parar, use o status final retornado por esta operação como a fonte da verdade.

Requisitos de edição

É necessário o DataWorks Basic Edition ou uma edição superior.

Precauções

Se nenhum intervalo de tempo for especificado, o sistema consulta os registros dos últimos 30 dias por padrão.

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.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Id

integer

Sim

O ID do rastreador de metadados. Você pode chamar ListCrawlers para obter o ID.

1234

StartTimeFrom

integer

Não

O limite inferior da hora de início da execução, em timestamp UNIX em milissegundos. O valor deve estar dentro dos últimos 30 dias. Se não for especificado, o valor padrão é 30 dias antes da hora atual.

1710239005403

StartTimeTo

integer

Não

O limite superior da hora de início da execução, em timestamp UNIX em milissegundos. O valor deve estar dentro dos últimos 30 dias. Se não for especificado, o valor padrão é a hora atual.

1710325405403

Status

string

Não

O status de execução. Valores válidos: WAITING, RUNNING, SUCCESS, ERROR, SHUTDOWN.

SUCCESS

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: 20. Valor máximo: 100.

20

StartTimeFrom e StartTimeTo usam timestamps UNIX em milissegundos. Ambos devem estar dentro dos últimos 30 dias, e StartTimeFrom não pode ser posterior a StartTimeTo.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros da resposta.

RequestId

string

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

9252F32F-D855-549E-8898-61CF5A733050

Success

boolean

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

PagingInfo

object

As informações de paginação.

TotalCount

integer

O número total de registros que atendem às condições de consulta.

1

PageNumber

integer

O número da página atual.

1

PageSize

integer

O número de entradas por página.

20

CrawlerRuns

array<object>

A lista de registros de execução do rastreador de metadados.

object

Um único registro de execução do rastreador de metadados.

Status

string

SUCCESS

TaskInstanceId

integer

1234

StartedTime

integer

1710239005403

FinishedTime

integer

1710239065403

Duration

number

60

TotalTableCount

integer

42

CrawlerRuns retorna os registros de execução na página atual. Você pode usar TaskInstanceId para associar uma execução específica.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "9252F32F-D855-549E-8898-61CF5A733050",
  "Success": false,
  "PagingInfo": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 20,
    "CrawlerRuns": [
      {
        "Status": "SUCCESS",
        "TaskInstanceId": 1234,
        "StartedTime": 1710239005403,
        "FinishedTime": 1710239065403,
        "Duration": 60,
        "TotalTableCount": 42
      }
    ]
  }
}

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.