跳转到正文
皓量云擎文档

错误处理

按 HTTP 状态、错误标识和任务结果定位失败。

常见错误响应包含错误码、说明和请求标识:

{
  "error": {"code": "<错误标识>", "message": "<可读说明>"},
  "request_id": "<请求标识>"
}
HTTP含义
400参数或请求校验失败
401未登录、会话失效或认证方式不支持
403无权操作,或写请求的 CSRF/Origin 不满足
404目标不存在或在当前授权范围不可见
409资源状态、依赖关系或幂等冲突
429请求过于频繁
500 / 503内部失败或依赖服务不可用

各接口可能只声明其中部分状态。以该操作的参考页和实际响应为准,不仅根据中文说明编写错误分支。

已受理任务之后失败不一定改变原 HTTP 状态,需要查询任务及关联资源。超时不一定未执行,使用原幂等键并查询已有结果,避免重复创建。

向平台支持提供时间、接口、请求标识及任务/资源身份;移除 Cookie、密码、密钥和临时控制台 URL。