错误代码
任何请求:校验与服务器故障
此类别中的每个代码:其含义、最常见的原因、应如何处理以及由谁处理。
validation_failed
- 含义
- 请求的正文或参数与该路由接受的内容不符,因此没有执行任何操作。响应中的
error描述问题;如涉及具体字段,field会指出该字段。 - 最常见的原因
- 缺少必填字段、值的类型错误或超出范围,或使用了未知选项——通常是按旧版 API 编写的客户端。
- 如何处理
- 发送的某个值不被接受。请更正所指出的字段,然后重新发送。
- 由谁处理
- 调用方代码的开发者
internal_error
- 含义
- 请求在 Azoth 一侧失败,原因未在响应中给出:请求本身没有问题。该故障已记录,供 Azoth 团队处理。
- 最常见的原因
- 短暂的数据库或网络问题,或程序缺陷。
- 如何处理
- Azoth 一侧出现了故障。请稍后重试;如果仍然失败,请联系支持团队。
- 由谁处理
- Azoth,或此部署的运营方
not_found
- 含义
- 请求所指的对象在此工作区中不存在——或者存在,但此调用方无权读取。
- 最常见的原因
- 手动输入或取自另一工作区的 ID、此后已删除的项目,或由另一个 API 密钥发出的请求。
- 如何处理
- 在此工作区中未找到具有此 ID 的内容:它可能已被删除,或属于另一个工作区。请重新加载,或检查该 ID。
- 由谁处理
- 工作区的任何成员
unknown_tool
- 含义
- 没有任何助手工具使用此名称。响应中的
tools列出了现有的名称。 - 最常见的原因
- 名称拼写错误,或某个旧名称的过渡期已结束。
- 如何处理
- 没有使用此名称的工具:请使用响应中 tools 下列出的名称之一。
- 由谁处理
- 调用方代码的开发者
not_configured
- 含义
- 此部署缺少该请求所需的一项设置(某个密钥,或某个供应商的账户或密钥),因此未执行任何操作。在设置之前,重试不会改变结果。
- 最常见的原因
- 在 Azoth 的服务上,是 Azoth 团队会修复的配置错误;在您自己的部署上,是其运维方尚未设置的一项设置,服务器日志中会写明其名称。
- 如何处理
- 此功能在本部署上尚未配置,未执行任何操作。请联系支持团队或本部署的运维方:缺少它所需的一项设置。
- 由谁处理
- Azoth,或此部署的运营方
migration_missing
- 含义
- 此功能需要一项尚未应用的数据库更新,因此未执行任何操作。
- 最常见的原因
- 在 Azoth 的服务上,有一项更新尚未应用;在您自己的部署上,其运营方尚未应用最新的数据库更新。
- 如何处理
- 此功能需要一项尚未应用的数据库更新,未执行任何操作。请联系支持团队或本部署的运维方。
- 由谁处理
- Azoth,或此部署的运营方
action_not_offered
- 含义
- 此队列项不提供该操作。
- 最常见的原因
- 屏幕显示的是该项较早的状态。
- 如何处理
- 请重新加载队列,然后选择其提供的操作之一。
- 由谁处理
- 工作区的任何成员 · 打开相关页面
item_not_waiting
- 含义
- 此项已不在队列中等待。
- 最常见的原因
- 有人已对其采取行动,或其等待的事项已解决。
- 如何处理
- 请重新加载队列以查看最新状态。
- 由谁处理
- 工作区的任何成员 · 打开相关页面
not_allowed
- 含义
- 您不能对此队列项采取行动。
- 最常见的原因
- 该项在等待另一个人,或是您自己提出的请求(四眼原则)。
- 如何处理
- 请交由其等待的人,或由所有者或管理员处理。
- 由谁处理
- 工作区的任何成员 · 打开相关页面
delegate_to_self
- 含义
- 不能将事项委派给自己。
- 最常见的原因
- 在列表中选择了您自己的名字。
- 如何处理
- 请选择另一位成员。
- 由谁处理
- 工作区的任何成员 · 打开相关页面
delegate_not_allowed
- 含义
- 所选成员不能处理此事项,因此无法委派给他。
- 最常见的原因
- 该成员没有所需角色,或正是提出请求的人。
- 如何处理
- 请选择所有者、管理员,或该事项指明的成员。
- 由谁处理
- 工作区的任何成员 · 打开相关页面
worker_secret_invalid
- 含义
- 部署的某个计划任务或内部路由在未携带其密钥的情况下被调用,因此没有运行任何内容。
- 最常见的原因
- 调用并非来自部署的调度器或其自有工具,或调度器配置的密钥与服务器的不同。
- 如何处理
- 此路由只由部署的调度器携带其密钥调用。如果您运营此部署,请为调度器配置与服务器相同的密钥。
- 由谁处理
- Azoth,或此部署的运营方
already_exists
- 含义
- 请求要添加的内容已存在:所给的名称、地址或值已被占用,因此未添加任何内容。
- 最常见的原因
- 同一表单提交了两次,或该名称或值已被工作区中的其他项使用。
- 如何处理
- 已存在同名或同值的项,因此未添加任何内容。请另选一个,或使用已存在的那个。
- 由谁处理
- 工作区的任何成员
operation_in_progress
- 含义
- 同一操作已在为此工作区运行,因此本次请求未做任何事。
- 最常见的原因
- 双击,或两个人或进程同时启动了它。
- 如何处理
- 此工作区已在执行该操作。请稍等一分钟并重新加载,如仍需要再重试。
- 由谁处理
- 工作区的任何成员
method_not_allowed
- 含义
- 该路由不接受此 HTTP 方法;响应的
Allow头给出它接受的方法。 - 最常见的原因
- 链接或脚本向需要 POST 的路由发送了 GET——例如,退出登录从不通过链接完成。
- 如何处理
- 此操作不能通过链接完成。请使用应用中的对应按钮,或发送该路由接受的方法。
- 由谁处理
- 调用方代码的开发者
integration_not_connected
- 含义
- 此操作所需的集成——GitHub、Slack、Microsoft Teams、单点登录或模型端点——尚未为此工作区设置。
- 最常见的原因
- 它从未连接,或之后已被移除。
- 如何处理
- 此集成尚未为此工作区设置。请由所有者或管理员在“设置”中设置,然后重试。
- 由谁处理
- 工作区的所有者或管理员
integration_failed
- 含义
- 某个集成的服务——GitHub、Slack、Microsoft Teams——拒绝或未能处理 Azoth 发出的请求,因此未执行任何操作。响应给出其 HTTP 状态(
vendorStatus)和其自身的错误代码(vendorCode),从不包含其文本。 - 最常见的原因
- 其应用已被卸载或失去某项权限,所请求的项已不存在,或该服务出现故障。
- 如何处理
- 该集成的服务拒绝了此请求。请确认其应用仍已安装并保有所需权限,然后稍后重试。
- 由谁处理
- 工作区的所有者或管理员