接口描述
删除 Agent 及其版本、路由配置,删除后不可恢复。
DELETE /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
agentId | string | 等价于请求体字段 AgentId |
查询参数
无
请求体
无(GET / DELETE 不带请求体,条件走路径与查询参数)
输出参数
204 无响应体。
示例
输入示例
DELETE /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}Authorization: Bearer pt_<YOUR_APP_KEY>
错误码
说明:
错误码 | 说明 |
FailedOperation.AgentPrivateLinkReclaimFailed | 该 Agent 的私有网络接入资源回收失败,Agent 未被删除;请重试,或先关闭私网访问再删除 |
FailedOperation.RoutingInvalidVersion | 路由项必须引用同一 Agent 下未停用的 prod 版本 |
InternalError.AgentOperationFailed | Agent 操作失败 |
InvalidParameter.AgentIDRequired | 缺少 AgentId |
InvalidParameter.InvalidRequestBody | 请求体不合法 |
MissingParameter.UinRequired | 公共参数中缺少 Uin |
ResourceInUse.AgentIDConflict | Agent ID 冲突 |
ResourceNotFound.Agent | Agent 不存在 |
ResourceUnavailable.RuntimeAPIUnavailable | 未配置 agentos 运行时 API |
UnauthorizedOperation.UnprovisionedTenant | 租户未开通,或企业不存在 |