ListContextModels - Simple Log Service

介面說明

請求說明

該介面用於查詢當前帳戶下的 ContextModel 資源，按更新時間倒序返回。
支援三類過濾，可任意疊加（AND 關係）：按名稱模糊過濾（name）、按名稱/顯示名稱/描述模糊過濾（keyword）、按引用的 Project 精確反查（projectName）。
分頁參數 page 從 1 開始；page / size 超出取值範圍時會被伺服器端截斷到邊界值，不報錯。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:ListContextModels

list

*All Resource

*

無

請求文法

GET /context-models HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
page	integer	否	查詢頁碼，從 1 開始。	1
size	integer	否	每頁返回的 ContextModel 數量，取值範圍為 1~1000。	20
name	string	否	用於模糊過濾的名稱關鍵字，僅匹配名稱、不匹配描述。可與 keyword 疊加。	order
keyword	string	否	用於模糊過濾的關鍵字，同時匹配名稱、顯示名與描述。	order
projectName	string	否	按引用關係查詢：只返回 `sources` 中引用了該 Project 的 ContextModel，用於檢視某個 Project 被哪些 ContextModel 引用。取值為完整的 Project 名，按精確匹配處理，不做模糊匹配 —— 例如傳入 `order-prod` 時，僅引用了 `order-prod-canary` 的模型不會被返回。取值需為合法的 Project 名，否則返回 400。	cn-hangzhou-app-logs

返回參數

名稱	類型	描述	樣本值
	object	回應主體。返回分頁的上下文模型摘要列表。
items	array<object>	當前頁的上下文模型摘要清單，按更新時間倒序排列；無命中或頁碼越界時返回空陣列 []。摘要中不含 sources 與 updatedAt，如需完整資訊請呼叫 GetContextModel。
	object	單個上下文模型的摘要資訊。
createdAt	string	模型建立時間，RFC3339 UTC 格式，形如 2026-07-09T05:33:37Z。	2026-07-09T05:33:37Z
description	string	模型描述，最長 1024 個字元；未填寫時返回空字串 ""。	End-to-end coverage from order creation to payment
displayName	string	顯示名稱。未設定時返回空字串 `""`（不會回填成 `name`），展示時請按 `displayName \|\| name` 回退。	Order Analysis Model
name	string	上下文模型的識別碼，在同一主帳號下唯一，建立後不可修改；可作為路徑參數傳給 GetContextModel 等介面。	orders
page	integer	本次實際生效的頁碼。頁碼小於 1 時按 1 處理。	1
size	integer	本次實際生效的每頁筆數。小於 1 時按預設值 20 處理，大於 1000 時按 1000 處理。	20
total	integer	滿足本次過濾條件的上下文模型總數，不受分頁影響。	4

樣本

正常返回樣本

JSON格式

{
  "items": [
    {
      "createdAt": "2026-07-09T05:33:37Z",
      "description": "End-to-end coverage from order creation to payment",
      "displayName": "訂單分析模型",
      "name": "orders"
    }
  ],
  "page": 1,
  "size": 20,
  "total": 4
}

錯誤碼

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

變更歷史

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