j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ 观测/ / trace数据标注 - tagopstracelabel
更新时间：2026-07-10 gmt 08:00
查看pdf

trace数据标注 -j9九游会登录

功能介绍

该接口用于给调用链数据进行数据标注。

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts::tagopstracelabel

write

-

-

-
  • apm:apm2traceevents:get
  • apm:apm2service:get

uri

post /v1/ops/observation/traces/{trace_id}/label

表1 路径参数

参数

是否必选

参数类型

描述

trace_id

是

string

参数解释：

调用链id，可通过查询trace列表接口（listopstrace）获取。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求body参数

参数

是否必选

参数类型

描述

session_id

否

string

参数解释：

会话id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

trace_type

否

string

参数解释：

调用链类型。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

span_id

否

string

参数解释：

spanid。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

label

否

map

参数解释：

标注的过滤条件，map类型，其中key表示标签名称，value表示标签值。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应body参数

参数

参数类型

描述

code

string

响应码

message

string

响应描述

请求示例

post https://api.example.com/v1/ops/observation/traces/5af65999f08e136b0963253064a2f693/label
{
  "trace_type" : "root_span",
  "span_id" : "018e8d4f16496b9a",
  "label" : {
    "key" : "aaa"
  }
}

响应示例

状态码：200

参数解释：

响应码，用于标识接口调用结果。

取值范围：

200表示成功，其他值表示失败，具体参见错误码文档。

{
  "code" : "200",
  "message" : null
}

状态码

状态码

描述

200

参数解释：

响应码，用于标识接口调用结果。

取值范围：

200表示成功，其他值表示失败，具体参见错误码文档。

错误码

请参见错误码。

父主题：

相关文档

网站地图