GetThread - Simple Log Service: Central de Documentação do Alibaba Cloud

Consulta as informações básicas de um thread específico em um DataAgent especificado, incluindo o título, o status, os recursos associados do Simple Log Service, o número da versão e a hora.

Descrição da operação

Um thread é um contexto de conversação contínua de um DataAgent. Esta operação retorna apenas as informações básicas do thread, incluindo o título, o status, a propriedade personalizada, os recursos associados do Simple Log Service e os horários de criação e atualização. Para obter o conteúdo da conversação do thread, chame GetThreadData. Se o thread não existir ou tiver sido excluído, um erro 404 será retornado.

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

GET /dataagents/{name}/threads/{threadId} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
name	string	Não	O nome do DataAgent, que é passado no caminho da solicitação para especificar o DataAgent ao qual o thread pertence.	order-analysis-agent
threadId	string	Não	O ID do thread a ser consultado, que é passado no caminho da solicitação e retornado por CreateThread.	thread-tiirv9-irwdoal8t4rm

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta, que retorna as informações básicas do thread.
attributes	object	Os atributos personalizados do thread, em que tanto as chaves quanto os valores são strings. Esses atributos são passados por meio de CreateThread quando o thread é criado.
	string	O valor do atributo, que é uma string.	2026-08
createTime	string	A hora de criação do thread, no formato ISO 8601 com fuso horário.	2026-08-14T10:00:03+08:00
requestId	string	O ID da solicitação, usado para localizar a chamada durante a solução de problemas.	5B0A6B60BB6EE39764D458B5
status	string	O status do thread. Valores comuns: active (a conversação pode ser continuada), archived (o thread está arquivado), suspended (o thread está suspenso e aguardando entrada adicional), failed (a execução falhou) e cancelled (o thread foi cancelado).	active
threadId	string	O ID do thread.	thread-tiirv9-irwdoal8t4rm
title	string	O título do thread, que é gerado pelo serviço com base no conteúdo da conversação e pode ser modificado por meio de UpdateThread.	Troubleshooting order volume anomalies
updateTime	string	A hora em que o thread foi atualizado pela última vez, no mesmo formato de createTime.	2026-08-14T11:20:35+08:00
variables	object	As variáveis de contexto do thread.
project	string	O nome do projeto do Simple Log Service associado ao thread.	etl-dev
workspace	string	O nome do workspace associado ao thread.	order-workspace
version	integer	O número da versão do thread, que é usado para identificar a sequência de modificações no thread.	3

Exemplos

Resposta de sucesso

JSON formato

{
  "attributes": {
    "key": "2026-08"
  },
  "createTime": "2026-08-14T10:00:03+08:00",
  "requestId": "5B0A6B60BB6EE39764D458B5",
  "status": "active",
  "threadId": "thread-tiirv9-irwdoal8t4rm",
  "title": "订单量异常排查",
  "updateTime": "2026-08-14T11:20:35+08:00",
  "variables": {
    "project": "etl-dev",
    "workspace": "order-workspace"
  },
  "version": 3
}

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.