跳转到正文
皓量云擎文档

失败、重试与审计关联

处理认证、权限、冲突和底层失败,不把受理当成功。

HTTP 失败与异步任务失败分开处理。请求返回 2xx 后仍需跟踪任务;查询成功也不表示客户机内部服务已经可用。

状态建议处理
400校验参数,修正后提交,不原样自动重试
401登录失效或认证方式不支持,停止授权操作并重新认证
403权限、租户或 CSRF/Origin 不满足,按错误上下文处理
404资源不存在或不可见,不据此推断跨租户资源详情
409状态、依赖或幂等冲突,先查询当前资源和任务
429降低调用频率,遵循响应提供的限制信息
503依赖或服务未就绪,保留业务身份并检查原任务

保存 request_id、任务 UUID 与资源 UUID,便于平台审计关联。避免记录请求中的密码、私钥、会话 Cookie、控制台票据或渠道 Webhook。

对网络超时先确认是否已受理,同一业务动作使用同一幂等键。扩容、重装、恢复等出现部分成功时,依靠原任务重试和确认状态,不在第三方系统中直接删除数据库记录或磁盘文件。