UpdateContextModel - Simple Log Service

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:UpdateContextModel

update

*ContextModel

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

無

請求文法

PUT /context-models/{name} HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
name	string	否	待更新的上下文模型標識，取自請求路徑 /context-models/{name}，須為當前帳號下已建立的模型名；僅支援大小寫字母、數字、底線（_）與短橫線（-）。模型不存在時返回 404。模型標識本身不可修改。	orders

請求參數

名稱	類型	必填	描述	樣本值
body	object	否	請求體。JSON 物件，本次要更新的欄位。欄位均為可選：不傳表示保持原值，顯式傳空字串表示清空該欄位。
description	string	否	模型描述。不傳該欄位表示保持原值。	End-to-end coverage from order creation to payment
displayName	string	否	顯示名，長度上限 256 個字元（按字元數計），可含中文。不傳該欄位表示保持原值；顯式傳空字串則清空為未設定。	訂單分析模型
sources	object	否	引用的來源：以 Project 名稱為 key（故同一 Project 不會重複出現），值為該 Project 下框選的 Logstore 名稱陣列。結構與建立時完全一致：`[""]` 表示該 Project 下全部 Logstore；否則為精確的 Logstore 名稱清單；空陣列 `[]`、`[""]` 與具體名稱混寫、名稱中含 `` 一律被拒絕（400）。不傳該欄位表示保持原值（本介面為部分更新，只改傳入的欄位）。與建立不同：傳入空物件 `{}` 會被拒絕（400）* —— 若需解除綁定全部來源，請刪除該模型後重建。生效時機：新增 Project/Logstore 後，內容通常數秒內更新；移除後，此前同步進來的元素會保留一段時間，由自動定期同步清理，期間仍可查詢到。	{"cn-hangzhou-app-logs": ["*"], "cn-hangzhou-order-logs": ["accesslog", "errorlog"]}
	array	否	該 Project 下要框選的 Logstore 名稱清單，須為非空陣列。["*"] 表示該 Project 下的全部 Logstore，不可與具體 Logstore 名稱混寫。
	string	否	Project 下的 Logstore 名稱，須為真實存在的 Logstore，且其所屬 Project 必須屬於當前帳號。不支援萬用字元與前綴匹配，名稱中包含 * 會被拒絕。	order-log

返回參數

名稱	類型	描述	樣本值
	object	響應體。返回更新後的上下文模型資訊。
description	string	更新後的模型描述，最長 1024 個字元；本次未傳 description 時回顯保持不變的原值，清空後返回空字串 ""。	End-to-end coverage from order creation to payment
displayName	string	更新後的顯示名稱；本次未傳 `displayName` 時回顯的是保持不變的原值。未設定時返回空字串 `""`。	訂單分析模型
name	string	上下文模型的標識，與請求路徑中的 name 一致；在同一主帳號下唯一，建立後不可修改。	orders
sources	object	更新後模型引用的來源，結構同請求；本次未傳 `sources` 時回顯的是保持不變的原值。未引用任何來源時返回空物件 `{}`。	{"cn-hangzhou-app-logs": ["*"], "cn-hangzhou-order-logs": ["accesslog", "errorlog"]}
	array	該 Project 下已框選的 Logstore 名稱清單，為字串陣列。["*"] 表示該 Project 下的全部 Logstore，不可與具體 Logstore 名稱混寫。
	string	該 Project 下已框選的 Logstore 名稱；取值為 "*" 時表示該 Project 下的全部 Logstore。	order-log
updatedAt	string	模型最近一次更新時間，RFC3339 UTC 格式，形如 2026-07-09T05:33:37Z；修改顯示名、描述或 sources 後更新。	2026-07-09T05:33:37Z

樣本

正常返回樣本

JSON格式

{
  "description": "End-to-end coverage from order creation to payment",
  "displayName": "訂單分析模型",
  "name": "orders",
  "sources": {
    "key": [
      "order-log"
    ]
  },
  "updatedAt": "2026-07-09T05:33:37Z"
}

錯誤碼

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

變更歷史

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