Todos os produtos
Search
Central de documentação

DataWorks:ListSemanticJobRuns

Última atualização: Sep 03, 2026

Consulta os registros de execução de um nó criado por Nome com paginação. O JobRunId em cada registro é ativo para recuperar os resultados de uma execução específica, e o ExecutorJobId é ativo para consultar detalhes, recuperar logs ou interromper a execução.

Descrição da operação

Cenários

Visualizar os registros históricos de execução de um job semântico com paginação para obter o ID da execução, o ID do job executor, o status e as informações de horário de cada submissão.

Procedimento

  1. Use o nome do job de CreateSemanticJob.Data.Name ou ListSemanticJobs como o JobName.

  2. Use PageNumber e PageSize para ler os registros página por página.

  3. Use o JobRunId de um registro para chamar DownloadSemanticResults e use o ExecutorJobId para chamar as operações de detalhe, log ou interrupção.

Antes de começar

A paginação começa na página 1 por padrão. Cada página contém no máximo 200 registros.

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

JobName

string

Sim

O nome do job. Use o valor Data.Name da resposta de CreateSemanticJob ou o valor Name de um item da lista ListSemanticJobs.

semantic-job-demo

PageNumber

integer

Não

O número da página, começando em 1. Se este parâmetro não for especificado ou for definido com um valor menor ou igual a 0, a página 1 será retornada.

1

PageSize

integer

Não

O número de registros de execução a serem retornados por página. Se este parâmetro não for especificado ou for definido com um valor menor ou igual a 0, o valor padrão 50 será usado. Valor máximo: 200.

50

Construa os parâmetros da solicitação com base na descrição de cada campo de solicitação.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta padrão para consulta paginada de registros de execução. Cada item em Data.JobRuns corresponde a uma execução submetida.

RequestId

string

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

676271D6-53B4-57BE-89FA-72F7AE1418DF

Success

boolean

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

Data

object

Os resultados paginados dos registros de execução. Use o JobRunId para baixar os resultados de uma execução específica e use o ExecutorJobId para consultar detalhes, recuperar logs ou interromper uma execução.

TotalCount

integer

O número total de registros de execução que correspondem aos critérios atuais do job.

1

PageNumber

integer

O número da página retornada, começando em 1.

1

PageSize

integer

O número de registros por página na resposta atual.

50

JobRuns

array<object>

A lista de registros de execução.

object

O registro de uma única execução de job semântico.

JobRunId

string

O ID da execução do job semântico. Passe este valor para o parâmetro JobRunId de DownloadSemanticResults para baixar os resultados desta execução.

01H00000000000000000000000

ExecutorJobId

string

O ID do job executor. Passe este valor para o parâmetro ExecutorJobId de GetSemanticJobDetail, GetSemanticJobLog ou KillSemanticJob.

exec-job-demo

JobName

string

O nome do job ao qual esta execução pertence. Este valor pode ser usado para reexecutar o job, consultar registros de execução ou baixar resultados.

semantic-job-demo

UserId

string

O ID do usuário que enviou esta execução.

user-demo

GmtCreate

integer

A hora em que o registro de execução foi criado. O valor é um timestamp UNIX em milissegundos.

1700000000000

Para o significado de cada campo de resposta e as relações entre chamadas subsequentes, consulte as descrições individuais dos campos.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 50,
    "JobRuns": [
      {
        "JobRunId": "01H00000000000000000000000",
        "ExecutorJobId": "exec-job-demo",
        "JobName": "semantic-job-demo",
        "UserId": "user-demo",
        "GmtCreate": 1700000000000
      }
    ]
  }
}

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.