文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 观测/ 智能体管理/ 将智能体信息在观测页面删除 - DeleteOpsAgentObservation
更新时间:2026-08-27 GMT+08:00
分享

将智能体信息在观测页面删除 - DeleteOpsAgentObservation

功能介绍

删除智能体后在观测页面无法查看该智能体上报的信息。

调用方法

请参见如何调用API

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::deleteOpsAgentObservation

Write

-

-

-

-

URI

DELETE /v1/ops/observation/agents/{agent_id}

表1 路径参数

参数

是否必选

参数类型

描述

agent_id

String

参数解释

智能体ID,获取方式通过查询智能体列表接口获取。

约束限制

长度限制为1~64个字符。

取值范围

不涉及。

默认取值

不涉及。

请求参数

响应参数

状态码:200

删除成功。

状态码:400

表2 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码。

取值范围

不涉及。

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

状态码:403

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码。

取值范围

不涉及。

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

encoded_authorization_message

String

参数解释

编码后的授权信息,用于客户端解析权限问题。

取值范围

不涉及。

details

Array of OpsObserverCommonError objects

参数解释

赖的下游服务错误信息列表。

取值范围

不涉及。

表4 OpsObserverCommonError

参数

参数类型

描述

error_code

String

参数解释

错误码。

取值范围

不涉及。

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

状态码:500

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码。

取值范围

不涉及。

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

请求示例

DELETE https://api.example.com/v1/ops/observation/agents/000b2b01-6279-4c7a-a4e5-08fdca69cc66

响应示例

状态码:400

参数解释

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

取值范围

400表示请求参数不正确。

{
  "error_code" : "AgentArts.05001003",
  "error_msg" : "请求参数不正确"
}

状态码:403

参数解释

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

取值范围

403表示权限不足,拒绝访问。

{
  "error_code" : "AgentArts.05004003",
  "error_msg" : "权限不足,拒绝访问",
  "encode_authorization_message" : "eyJIcnJvciI6ICJVbmF1dGhvcm16ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.05001003"
  }, {
    "error_msg" : "请求参数不正确"
  } ]
}

状态码:500

参数解释

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

取值范围

500表示内部服务器错误。

{
  "error_code" : "AgentArts.05005000",
  "error_msg" : "内部服务器错误"
}

状态码

状态码

描述

200

删除成功。

400

参数解释

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

取值范围

400表示请求参数不正确。

403

参数解释

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

取值范围

403表示权限不足,拒绝访问。

500

参数解释

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

取值范围

500表示内部服务器错误。

错误码

请参见错误码

相关文档