GetThread - - 阿里雲

介面說明

對話串（Thread）是 DataAgent 的一次連續對話上下文。本介面僅返回對話串的基本資訊，包括標題、狀態、自訂屬性、關聯的日誌服務資源與建立、更新時間；對話串的內容請透過 GetThreadData 取得。對話串不存在或已被刪除時返回 404。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:GetThread

get

*DataAgent

acs:log:{#regionId}:{#accountId}:dataagent/{#name}/thread/{#threadId}

無

請求文法

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

路徑參數

名稱	類型	必填	描述	樣本值
name	string	否	DataAgent 的名稱，透過請求路徑傳入，用於指定會話所屬的 DataAgent。	order-analysis-agent
threadId	string	否	要查詢的對話串 ID，透過請求路徑傳入，由 CreateThread 返回。	thread-tiirv9-irwdoal8t4rm

請求參數

名稱

類型

必填

描述

樣本值

當前API無需請求參數

返回參數

名稱	類型	描述	樣本值
	object	回應主體。返回該會話的基本資訊。
attributes	object	對話串的自訂屬性，鍵與值均為字串；建立對話串時透過 CreateThread 傳入。
	string	屬性值，字串類型。	2026-08
createTime	string	會話的建立時間，採用帶時區的 ISO 8601 格式。	2026-08-14T10:00:03+08:00
requestId	string	本次請求的 ID，用於問題排查時定位本次呼叫。	5B0A6B60BB6EE39764D458B5
status	string	會話狀態。常見取值：active（可繼續對話）、archived（已封存）、suspended（已暫停，等待補充輸入）、failed（執行失敗）、cancelled（已取消）。	active
threadId	string	會話 ID。	thread-tiirv9-irwdoal8t4rm
title	string	對話串標題，由服務根據對話內容產生，可透過 UpdateThread 修改。	訂單量異常排查
updateTime	string	對話串最近一次更新的時間，格式同 createTime。	2026-08-14T11:20:35+08:00
variables	object	會話的上下文變數。
project	string	會話關聯的日誌服務 Project 名稱。	etl-dev
workspace	string	會話關聯的工作空間（Workspace）名稱。	order-workspace
version	integer	會話的版本號，用於標識會話被修改的先後次序。	3

樣本

正常返回樣本

JSON格式

{
  "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
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。