批量写入或更新上下文模型的语义元素内容
调试
您可以在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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。