全部產品
Search
文件中心

Simple Log Service:UpsertContextModel

更新時間:Nov 03, 2026

批量寫入或更新上下文模型的語意元素內容。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:UpsertContextModel

update

*ContextModel

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

無 無

請求文法

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

路徑參數

名稱

類型

必填

描述

樣本值

name

string

否

待寫入元素的上下文模型識別碼,取自請求路徑 /context-models/{name}/upsert,須為當前帳號下已建立的模型名;僅支援大小寫字母、數字、底線(_)與短橫線(-)。模型不存在時返回 404。

orders

請求參數

名稱

類型

必填

描述

樣本值

body

object

否

請求主體。本次要寫入的元素集合,不能為空。

elements

array<object>

否

要新增或更新的元素清單。類型、網域、名稱完全相同的元素會被整條取代,而不是逐欄位合併;本介面只寫入,不會刪除任何元素。

object

否

單一元素,由 kind(元素類型)、metadata(名稱與所屬網域等識別資訊)、schema(結構宣告)和 spec(該類型的具體定義)組成。

any

否

元素的各個組成部分,例如 kind、metadata、schema、spec。kind 可選值包括 log_set、metric_set、runbook_set、event_set、sls_logstore、storage_link;metadata.domain 約定填寫 sls。

{"kind":"log_set","metadata":{"name":"orders_log","domain":"sls"},"spec":{"fields":[{"name":"order_id","type":"string"},{"name":"amount","type":"double"}]}}

返回參數

名稱

類型

描述

樣本值

object

回應主體。本次元素寫入的結果。

status

string

呼叫結果狀態。寫入成功時固定返回 success。單個模型最多 50000 個元素、單次請求最多 2000 個元素,超限時本次不會寫入任何元素。

success

樣本

正常返回樣本

JSON格式

{
  "status": "success"
}

錯誤碼

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

變更歷史

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