批量寫入或更新上下文模型的語意元素內容。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
log:UpsertContextModel |
update |
*ContextModel
|
無 | 無 |
請求文法
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"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。