错误码
更新时间 2026-04-10 16:44:05
最近更新时间: 2026-04-10 16:44:05
错误响应消息格式
当服务端处理请求发生错误时,会返回包含错误信息的响应,其结构如下:
响应头部信息
Content-Type: application/xml(指明响应体为XML格式)
状态码:4xx(客户端错误)或5xx(服务端错误)
响应体示例
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>InvalidArgument</Code>
<RequestId>tx000000000000000000002-0068491d6f-5004d5-default</RequestId>
<HostId>5004d5-default-default</HostId>
</Error>其中响应消息体里的各元素的具体含义如下表所示:
| 元素名称 | 描述 |
|---|---|
| Error | 错误响应的根节点,包含所有错误相关信息 |
| Code | 错误代码,标识具体的错误类型(如InvalidArgument) |
| RequestId | 本次请求的唯一标识符,用于服务端日志追踪和问题定位 |
| HostId | 处理请求的服务端实例标识,在多节点部署时可用于定位具体出错的服务器 |
全局错误码
请求可能会返回相关错误,具体错误码编号及信息请参考下表。同一个错误码可能对应不同的错误码描述,具体由接口来决定。
| 状态码 | 错误码 | 错误信息 |
|---|---|---|
| 400 | InvalidArgument | 请求参数错误 |
| 400 | InvalidRequest | 请求无效 |
| 400 | InvalidDigest | 内容摘要无效 |
| 400 | BadDigest | 错误摘要 |
| 400 | InvalidLocationConstraint | 区域限制无效 |
| 400 | ZonegroupDefaultPlacementMisconfiguration | 默认放置策略配置错误 |
| 400 | InvalidTargetBucketForLogging | 日志目标桶无效 |
| 400 | InvalidBucketName | 桶名无效 |
| 400 | InvalidObjectName | 对象名无效 |
| 400 | UnresolvableGrantByEmailAddress | 无法通过邮箱解析授权 |
| 400 | InvalidPart | 无效的分片 |
| 400 | InvalidPartOrder | 分片顺序无效 |
| 400 | RequestTimeout | 请求超时 |
| 400 | EntityTooLarge | 实体过大 |
| 400 | EntityTooSmall | 实体过小 |
| 400 | TooManyBuckets | 桶数量过多 |
| 400 | MalformedXML | 错误的 XML |
| 400 | XAmzContentSHA256Mismatch | SHA256 校验失败 |
| 400 | MalformedPolicyDocument | 错误的策略文档 |
| 400 | InvalidTag | 标签无效 |
| 400 | MalformedACLError | 错误的 ACL |
| 400 | InvalidEncryptionAlgorithmError | 加密算法无效 |
| 400 | InvalidPrefix | 前缀无效 |
| 400 | InvalidRetentionPeriod | 保留期无效 |
| 400 | InvalidBackToSourceOrigin | 回源设置无效 |
| 400 | InvalidLCConfiguration | 生命周期配置错误 |
| 400 | MissingContentLength | 缺失内容长度 |
| 400 | InvalidSecretKey | 无效的 Secret Key |
| 400 | InvalidKeyType | 密钥类型无效 |
| 400 | InvalidCapability | 权限能力值无效 |
| 400 | InvalidTenantName | 租户名无效 |
| 400 | InvalidKMSEncryptionKeyId | KMS 密钥 ID 无效 |
| 400 | InvalidRenameAlgorithm | 重命名算法无效 |
| 400 | InvalidHashAlgorithm | 哈希算法无效 |
| 400 | CallBackRequestFailed | 回调请求失败 |
| 400 | NotSymlink | 不是符号链接 |
| 400 | InvalidTargetType | 目标类型无效 |
| 400 | ExtzoneSyncUnreachable | 跨区同步不可达 |
| 400 | NotMainSubRelation | 非主子账号关系 |
| 400 | InvalidStorageClass | 存储类别无效 |
| 400 | AccessMonitorDisableNotAllowed | 不允许禁用访问监控 |
| 403 | AccessDenied | 拒绝访问 |
| 403 | ObjectLocked | 对象处于合规保留状态 |
| 403 | SignatureDoesNotMatch | 签名不匹配 |
| 403 | InvalidAccessKeyId | Access Key 无效 |
| 403 | UserSuspended | 用户已暂停 |
| 403 | RequestTimeTooSkewed | 请求时间与服务器偏差过大 |
| 403 | QuotaExceeded | 超出配额 |
| 404 | NoSuchKey | 对象不存在 |
| 404 | NoSuchBucket | 桶不存在 |
| 404 | NoIvtDestBucket | 目标桶不存在 |
| 404 | NoSuchWebsiteConfiguration | 网站配置不存在 |
| 404 | NoSuchUpload | 上传任务不存在 |
| 404 | Not Found | 找不到资源 |
| 404 | NoSuchLifecycleConfiguration | 生命周期配置不存在 |
| 404 | NoSuchBucketInventory | 桶清单不存在 |
| 404 | NoSuchUnzipTask | 解压任务不存在 |
| 404 | InvalidUnzipTaskState | 解压任务状态无效 |
| 404 | NoSuchBucketPolicy | 桶策略不存在 |
| 404 | NoSuchUser | 用户不存在 |
| 404 | NoSuchEntity | 实体不存在 |
| 404 | NoSuchCORSConfiguration | CORS 配置不存在 |
| 404 | ObjectLockConfigurationNotFoundError | 对象锁配置不存在 |
| 404 | NoSuchSubUser | 子用户不存在 |
| 404 | NoSuchTagSetError | 标签集合不存在 |
| 404 | NoSuchEncryptionSetError | 加密配置不存在 |
| 404 | SymlinkTargetNotExist | 符号链接目标不存在 |
| 404 | MainUserNotExist | 主账号不存在 |
| 404 | NoSuchSubaccount | 子账户不存在 |
| 405 | MethodNotAllowed | 方法不被允许 |
| 409 | EntityAlreadyExists | 实体已存在 |
| 409 | BucketAlreadyExists | 桶已存在 |
| 409 | UserAlreadyExists | 用户已存在 |
| 409 | EmailExists | 邮箱已存在 |
| 409 | KeyExists | 密钥已存在 |
| 409 | PartExists | 分片已存在 |
| 409 | OperationAborted | 操作中止 |
| 409 | PositionNotEqualToLength | 上传位置与长度不符 |
| 409 | ObjectNotAppendable | 对象不可追加写入 |
| 409 | InvalidBucketState | 桶状态无效 |
| 409 | InvalidObjectState | 对象状态无效 |
| 409 | RestoreAlreadyInProgress | 正在恢复中 |
| 409 | GlacierObjectNotRestore | Glacier 对象尚未恢复 |
| 409 | NotGlacierObject | 非 Glacier 对象 |
| 409 | GlacierObjectNotExtzoneSync | Glacier 对象未进行跨区同步 |
| 409 | ObjectAlreadyExists | 对象已存在 |
| 409 | BucketNotEmpty | 桶非空 |
| 409 | SubaccountAlreadyExists | 子账户已存在 |
| 409 | InvalidBucketVersions | 桶版本不匹配 |
| 412 | PreconditionFailed | 前提条件失败 |
| 416 | InvalidRange | 范围请求无效 |
| 422 | UnprocessableEntity | 实体无法处理 |
| 423 | Locked | 资源被锁定 |
| 500 | InternalError | 内部错误 |
| 500 | InvalidStoragePool | 存储池无效 |
| 501 | NotImplemented | 功能未实现 |
| 503 | ServiceUnavailable | 服务不可用 |
| 503 | SlowDown | 请求过于频繁,请稍后重试 |