更新时间:2025-08-18 15:32:58
本文档是一份 API 错误代码参考指南,主要涵盖对象存储及多媒体处理服务的异常状态码体系。
| 接口 | 返回代码 | 返回消息 | 返回代码描述 |
| 通用 | 200 | OK | 操作成功 |
| 304 | Not Modified | 文件是最新的 | |
| 401 | Authorization Required | 请求头中需要认证 | |
| 401 | AK/SK Not Found | 找不到AK/SK | |
| 401 | Token Invalid | 请求令牌不正确 | |
| 401 | ExpireTime Is Null | ExpireTime为空 | |
| 401 | Token Format Invalid | 请求令牌格式不正确 | |
| 404 | Bucket Not Found | Bucket不存在 | |
| 404 | File Not Found | 资源未找到 | |
| 404 | bucketErrorPage | 资源未找到 | |
| 405 | Token Required | 需要令牌 | |
| 406 | File Already Exist | 文件已存在 | |
| 401 | The Persistent File Already Exists | 持久化文件已存在 | |
| 406 | File Is Busy, Please Retry Later | 文件处理中,请稍后重试 | |
| 404 | Bucket Not Binding Mirror | Bucket未绑定镜像源 | |
| 401 | Bucket Access Denied | 空间拒绝访问 | |
| 500 | Internal Server Error | 服务器内部错误 | |
| 上传文件 | 401 | Token Expired | 请求令牌过期 |
| 401 | Unsupported PutPolicy Decoding | PutPolicy解码异常 | |
| 401 | PutPolicy Invalid | putpolicy不合法 | |
| 401 | PutPolicy Is Null | Putpolicy为空 | |
| 401 | Deadline Is Empty | Deadline为空 | |
| 401 | Deadline Invalid | Deadline无效 | |
| 401 | Scope Format Is Invalid | Scope格式不合法 | |
| 401 | Scope Is Empty | Scope为空 | |
| 401 | Putpolicy Scope Invalid | Bucket名与文件名拼接格式不合法 | |
| 401 | The BucketName In Scope Is Empty | Bucket名为空 | |
| 401 | File Name Invalid | 文件名不合法 | |
| 401 | Param Invalid, ReturnUrl Can’t Exist With CallbackUrl | 参数不合法,returnUrl和callbackUrl不能同时存在 | |
| 401 | CallbackUrl Invalid | ReturnUrl Invalid | PersistentNotifyUrl Invalid | CallbackUrl | ReturnUrl | PersistentNotifyUrl 必须以http://或https://开头 | |
| 401 | ReturnBody Invalid | ReturnBody不正确 | |
| 401 | CallbackBody Invalid | callbackBody不正确 | |
| 401 | Saveas String Invalid | 自定义操作时Bucket名与文件名拼接格式不合法 | |
| 400 | File Transmission Fail | 文件传输失败 | |
| 401 | FileName Invalid | 文件名不合法 | |
| 401 | Upload File Cannot be Empty | 未指定上传文件 | |
| 401 | PersistentOps Invalid | persistentOps不合法 | |
| 401 | CallbackUrl Is Not Public Address | ReturnUrl Is Not Public Address | PersistentNotifyUrl Is Not Public Address | CallbackUrl | ReturnUrl | PersistentNotifyUrl 不是公网地址 | |
| 401 | CallbackUrl Invalid | ReturnUrl Invalid | CallbackUrl不合法 | ReturnUrl | |
| 401 | File Too Large | 上传文件超出大小限制 | |
| 401 | Saveas String Invalid | 自定义操作后持久化处理时Bucket名与文件名拼接格式不合法 | |
| 579 | Callback Failed | 文件上传成功,回调失败 | |
| 追加上传 | 409 | ObjectNotAppendable | 对常规对象进行追加操作 |
| 403 | ObjectTypeNotSupport | 对追加对象进行Put/copy/move操作 | |
| 409 | PositionNotEqualToLength | 追加时位置与追加对象的大小不一致 | |
| 413 | EntityTooLarge | 追加内容超过2G | |
| 409 | MissingPosition | 追加对象缺少位置 | |
| 400 | InvalidLocalFile | 追加对象缺少本地对象 | |
| 400 | InvalidObjectName | 追加对象缺少服务器对象 | |
| mkblk | 401 | Block Too Large | 上传块大于系统默认值 |
| bput | 401 | nextChunkOffset is not correct | ctx信息不正确,未找到当前切片的起始偏移位置 |
| 401 | Block Cannot find by ctx | ctx信息不正确,未找到对应块 | |
| 401 | ctx can not be null | ctx字段不能为空 | |
| 412 | Cannot find upload block file | 上传块未找到 | |
| mkfile | 400 | Make file Fail | 生成服务器块文件失败 |
| 401 | Check the block is complete upload. | 验证上传块的完整性 | |
| 401 | save db error | 重复上传文件,保存数据失败 | |
| 412 | Check the blocks are all upload. | 有块未上传,所有块需要上传 | |
| 图像处理 | 404 | Watermark Image Url Invalid | 无效的水印图片Url |
| 404 | WaterMark Image Not Found | 水印图片未找到 | |
| 401 | Bucket Open Image Protect Function,Unable To Get Original Image | 启用原图保护,无法访问原图 | |
| 401 | Non-standard Type Of Op | 操作类型不合法 | |
| 401 | Image Process Param Error | 图像操作参数错误 | |
| 579 | Get WaterMark Image Fail | 水印图片下载失败 | |
| 文件转码 | 400 | Tranfer Parameters Error | 转码参数有误 |
| 401 | Ops Invalid | Ops不合法 | |
| 404 | Video Persistent Progress Info Not Found | 未找到视频持久化处理进度 | |
| 579 | Json callback | 回调服务服务器响应异常 |