全部產品
Search
文件中心

Simple Log Service:QueryContextModel

更新時間:Nov 03, 2026

SPL 查詢 Semantic Model 內容。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:QueryContextModel

list

*ContextModel

acs:log:{#regionId}:{#accountId}:contextmodel/{#name}

無 無

請求文法

POST /context-models/{name}/query HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

name

string

否

待查詢的上下文模型標識,取自請求路徑 /context-models/{name}/query,僅支援大小寫字母、數字、底線(_)與短橫線(-)。

orders

請求參數

名稱

類型

必填

描述

樣本值

body

object

否

請求主體。JSON 物件,攜帶一條針對該模型元素定義的 SPL 查詢。

query

string

是

SPL 查詢語句,必填且不可為空字串,否則回傳 400。以 .umodel 作為資料來源查詢該模型的元素定義,支援 where、project、limit 等管線操作,例如 .umodel | where kind = 'log_set' | limit 50。

.umodel | where kind = 'log_set' | limit 50

返回參數

名稱

類型

描述

樣本值

object

回應主體。回傳本次查詢命中的欄名與資料列。

data

array

結果列陣列,每列是與 header 按順序一一對應的陣列;無命中時回傳空陣列 []。

array

一列結果,元素順序與 header 中的欄名一一對應。

string

儲存格值,恆為字串;其中 metadata、schema、spec 三欄的內容本身是 JSON 字串,需要呼叫端自行解析。

log_set

header

array

欄名陣列,隨 SPL 的投影而變;未顯式投影時預設為 kind、metadata、schema、spec。

string

單個欄名。

kind

樣本

正常返回樣本

JSON格式

{
  "data": [
    [
      "log_set"
    ]
  ],
  "header": [
    "kind"
  ]
}

錯誤碼

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

變更歷史

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