错误码

更新时间：2023-07-28

错误信息格式

当用户访问BOS出现错误时，BOS会返回给用户相应的错误码和错误信息，便于用户定位问题，并做出适当的处理。

系统返回错误信息格式如下：

{
    "code":"NoSuchKey",
    "message":"The resource you requested does not exist",
    "requestId":" 4db2b34d-654d-4d8a-b49b-3049ca786409"
}

BOS错误码

其中code、message字段定义如下：

错误码（code）	消息（message)	描述	HTTP状态码
success	success	成功	200 OK
success	Both this request and DPF request executed successfully.	请求执行成功	200 OK
success	This request executed successful, but the DPF request is failed.	请求执行成功，但DPF执行失败	203 Non-Authoritative Information
success	This request executed successful, but the third-party platform executed failed.	请求执行成功，第三方执行失败	203 Non-Authoritative Information
success	This request executed successful, but your dpf format is invalid.	请求执行成功，DPF格式无效	203 Non-Authoritative Information
success	Callback failed.	回调失败	203 Non-Authoritative Information
success	Encrypt failed.	加密失败	203 Non-Authoritative Information
success	Payload too large.	有效载荷过大	203 Non-Authoritative Information
InvalidEncryptionAlgorithm	The specified encryption algorithm is invalid	加密算法无效	400 Bad Request
InvalidEncryptionCustomerKey	The specified encryption customer-key is invalid, encrypt object by customer key md5 not match	加密密钥无效，密钥md5不匹配。	400 Bad Request
InvalidEncryptionKmsMkid	The specified encryption kms mkid is invalid, please check its status	指定的加密KMS MKID无效，请检查其状态	400 Bad Request
InvalidTargetType	The specified object key is symlink, target object of symlink also is symlink.	软链接文件不支持再次设置软链接	400 Bad Request
InvalidEncryptionScheme	The specified encryption scheme is invalid, encrypt object by customer key must use https request	加密Object必须使用HTTPS请求	400 Bad Request
success	This request executed successful, but the dpf executed failed because the assumerole configuration you set is invalid.	请求执行成功，但DPF执行失败,因为处理用户权限失败。	203 Non-Authoritative Information
AccessDenied	Access Denied.	拒绝访问	403 Forbidden
AccountOverdue	Your request is denied because there is an overdue bill of your account.	用户欠费	403 Forbidden
AccessDeniedBySourceUrl	Access Denied By Source Url.	源URL拒绝访问	403 Forbidden
BadDigest	The Content-MD5 or x-bce-content-sha256 or x-bce-content-crc32 you specified did not match what we received.	摘要错误，用户指定的md5或者sha256或者crc32与服务端计算不一致。	400 Bad Request
BadDigestMD5	The Content-MD5 you specified did not match what we received.	错误的Content-MD5字段，与实际上传的数据MD5不符	400 Bad Request
BadDigestSHA256	The x-bce-content-sha256 you specified did not match what we received.	错误的x-bce-content-sha256字段，与实际上传的数据sha256不符	400 Bad Request
BadDigestCRC32	The x-bce-content-crc32 you specified did not match what we received.	错误的x-bce-content-crc32字段，与实际上传的数据crc32不符	400 Bad Request
BucketAlreadyExists	The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.	Bucket已经存在	409 Conflict
ObjectLockAlreadyInProgress	The bucket lock status is already InProgress	Bucket已经为锁定状态	409 Conflict
BucketNotEmpty	The bucket you tried to delete is not empty.	试图删除一个不为空的bucket	409 Conflict
ClientSocketError	clinet socket error, maybe client close connection.	客户端连接失败,可能是客户端关闭了连接。	200 OK
CORSConfigurationDoesNotMatch	The CORS Options request is not allowed because the request does not match with the CORS Configuration of the resource.	请求资源与CORS配置不匹配	403 Forbidden
CORSNotEnabled	The CORS is not enabled for this resource.	未配置允许跨域访问	403 Forbidden
ReplicationNotEnabled	The Bucket Replication is not enabled.	跨区域数据同步未开启	404 Not Found
UserQuotaNotConfigured	The user quota does not configured	未配置用户配额	404 Not Found
ReplicationStatusError	The Bucket Replication Status is not correct. Please make sure both the source and dest bucket have no enabled replication conf and both are not the dest replication bucket of other bucket	跨区域复制源Bucket或目标Bucket已经在另一条跨区域复制规则中被指定	409 Conflict
ReplicationStatusNotEmpty	The bucket you tried to delete has an enabled replication conf or is a dest replication bucket of other bucket	待删除的Bucket开启了跨区域复制功能。	409 Conflict
InventoryStatusError	The Bucket Inventory Status is not correct. Please make sure dest bucket is same region!	文件清单状态异常。请确保目的bucket在同地域。	409 Conflict
ReplicationApiUsedInvalid	The replication api must upgrade,because you have used multi rules	跨区域复制API版本需要更新	409 Conflict
ReplicationConfDuplicate	The replication has exist with different id	跨区域复制配置重复	409 Conflict
EmptyHTTPAuthHeader	The HTTP authorization header is empty. We do not allow using Session Token with empty authorization header	sts签名请求中，缺少authorization请求header	400 Bad Request
EntityTooSmall	Your proposed upload is smaller than the minimum allowed object size.	上传的数据小于限制	400 Bad Request
EntityTooLarge	Your proposed upload exceeds the maximum allowed object size.	上传的数据大于限制	400 Bad Request
CapacityExceeded	Your total upload bytes exceeds the maximum allowed in your account.	超出账号容量限制	403 Forbidden
BucketObjectNumExceeded	Your total upload object number exceeds the maxinum in your bucket	超出Bucket文件数量限制	403 Forbidden
BucketCapacityExceeded	Your total upload bytes exceeds the maximum allowed in your bucket	超出Bucket容量限制	403 Forbidden
ObjectNumExceeded	Your total upload object number exceeds the maxinum in your account	超出账号文件数量限制	403 Forbidden
BucketQuotaNotConfigured	The bucket quota does not configured	未配置Bucket配额	404 Not Found
FetchObjectTaskIsRunning	The fetch object task you submit is running.	FetchObject进行中	200 OK
FetchObjectFailed	Fetch object failed, please check argument.	文件抓取失败	400 Bad Request
FileAlreadyExists	The object you specified already exists and can not be overwritten.	指定的文件已存在，无法覆盖	409 Conflict
InappropriateJSON	The JSON you provided was well-formed and valid, but not appropriate for this operation.	请求中的JSON格式正确，但语义上不符合要求。如缺少某个必需项，或者值类型不匹配等。	400 Bad Request
InappropriateXML	The XML you provided was well-formed and valid, but not appropriate for this operation.	请求中的XML格式正确，但语义上不符合要求。适用场景同InappropriateJSON	400 Bad Request
InvalidAccessKeyId	The BCS Access Key Id you provided does not exist in our records.	提供的Access Key不存在	403 Forbidden
InvalidArgument	Invalid Argument.	无效参数	400 Bad Request
InvalidBucketName	The specified bucket is not valid.	Bucket名称不正确	400 Bad Request
InvalidCopyDestination	The copy destination is not valid	复制的目标对象无效	400 Bad Request
InvalidCORSRequest	The CORS request is not valid	跨域请求错误	400 Bad Request
InvalidDomain	The specified domain is not valid.	域名不正确	400 Bad Request
InvalidHTTPAuthHeader	The HTTP authorization header is invalid. Consult the service documentation for details.	请求头Authorization无效	400 Bad Request
InvalidImageFormat	Your image format is invalid.	图片格式不正确	400 Bad Request
InvalidObjectName	Your object key is too long.	文件名长度超过限制	400 Bad Request
InvalidTrashDirectoryName	Your trash directory name is not valid.	回收站路径不正确	400 Bad Request
InvalidDirectory	Directory file must be empty	目录文件必须为空	400 Bad Request
ObjectLockNotLocked	The object lock is not locked, can not extend retentionday	文件未被锁定，无法延长保留期限	400 Bad Request
InvalidPart	One or more of the specified parts could not be found. The part might not have been uploaded, or the specified entity tag might not have matched the part's entity tag.	找不到指定的分块。该分块可能未上传或指定的etag与分块不匹配。	400 Bad Request
InvalidPartOrder	The list of parts was not in ascending order.Parts list must specified in order by part number.	分块列表未按升序排列	400 Bad Request
InvalidPolicyDocument	The content of the form does not meet the conditions specified in the policy document.	Policy格式错误	400 Bad Request
InvalidRange	The requested range cannot be satisfied.	请求的Range范围无效	416 Range Not Satisfiable
InvalidSessionToken	The Session Token you provided is not valid. Please double check that you are using the correct Session Token obtained from STS (Security Token Service)	STS Token无效	400 Bad Request
InvalidURI	Could not parse the specified URI.	URI形式不正确	400 Bad Request
InvalidStaticWebSiteFormat	The format of index file or 404 file are not allowed.	不允许的index或者404文件名或格式。比如：文件格式不允许，或者index与404文件同名。	400 Bad Request
InvalidJobStatus	The current job status does not supprot the operation.	当前任务状态不支持操作	400 Bad Request
InvalidStorageClass	The storage class specified is invalid, please check argument and consult the service documentation.	指定的存储类型错误	400 Bad Request
NotSupportStorageClass	The storage class specified is not support, please check argument and consult the service documentation.	指定的存储类型错误	501 Not Implemented
NotAllowShortenRetentionday	Could not shorten retentionday	不允许缩短合规保留期限	400 Bad Request
InvalidVersion	The API version specified was invalid.	API版本错误	404 Not Found
RequestRateLimitExceeded	Your request rate is too high. We have put limits on your bucket.	请求速度太快并触发限速	429 Too Many Requests
MalformedJSON	The JSON you provided was not well-formed.	JSON格式不正确	400 Bad Request
MalformedXML	The XML you provided was not well-formed or did not validate against our published schema.	XML格式不正确	400 Bad Request
MaxMessageLengthExceeded	Your request was too big.	请求体过大	400 Bad Request
MetadataTooLarge	Your metadata headers exceed the maximum allowed metadata size.	超出metadata大小限制	400 Bad Request
MethodNotAllowed	The specified method is not allowed against this resource.	请求方法错误	405 Method Not Allowed
MirrorFailed	Mirroring failed, please check your mirror configuration.	镜像回源失败	424 Failed Dependency
MissingContentLength	You must provide the Content-Length HTTP header.	未提供Content-Length	411 Length Required
MissingDateHeader	Request must have a "date" or "x-bce-date" header.	请求中找不到date和x-bce-date两者之一；如果同时添加了date和x-bce-date，则x-bce-date的优先级高于date，二者的格式请参考：\ndate: Wed, 06 Apr 2016 06:34:40 GMT\nx-bce-date: 2016-04-06T08:23:49Z	400 Bad Request
NoSuchBucket	The specified bucket does not exist.	Bucket不存在	404 Not Found
NoSuchInventoryConfiguration	The specified inventory configuration does not exist.	清单配置不存在	404 Not Found
NoSuchCORSConfiguration	The CORS configuration does not exist.	未配置跨域规则	404 Not Found
NoLifecycleConfiguration	The lifecycle configuration does not exist.	未配置生命周期规则	404 Not Found
NoProcessConfiguration	The process configuration does not exist.	数据处理配置不存在	404 Not Found
NoNotificationConfiguration	The notification configuration does not exist.	未配置事件通知规则	404 Not Found
NoReplicationConfiguration	The Replication configuration does not exist.	未配置跨区域复制	404 Not Found
NoSuchKey	The specified key does not exist.	不存在该Object	404 Not Found
NoSuchStyle	The specified style does not exist.	图片样式不存在	404 Not Found
NoSuchObjectLock	The specified object lock does not exist.	合规保留配置不存在	404 Not Found
NoSuchJob	The job does not exist.	批处理任务不存在	404 Not Found
NoSuchUpload	The specified multipart upload does not exist. The upload ID might be invalid, or the multipart upload might have been aborted or completed.	该uploadId所对应的三步上传不存在。uploadId错误或者三步上传已中止或者已完成。	404 Not Found
NoCopyrightProtectionConfiguration	The copyright protection configuration does not exist.	未配置版权保护	404 Not Found
NoSuchBucketEncryption	The bucket is not encrypted.	该Bucket未加密	404 Not Found
NoSuchBucketTrashDirectory	The bucket does not activate trash, or trash has been turned off	未开启回收站	404 Not Found
NoSuchBucketAlias	The bucket does not activate alias, or bucket alias has been turned off	Bucket别名不存在	404 Not Found
NoSuchBucketDefaultStyle	The bucket does not activate default style, or bucket default style has been turned off	Bucket默认样式不存在	404 Not Found
NoSuchBucketStaticWebSiteConfig	The static web site configuration does not exist.	Bucket 没有开启静态托管	404 Not Found
StaticWebSiteIsDisable	Static web site is disabled or not implemented.	静态网站托管功能被禁止。如：即BOS不允许此region的bucket 开启静态网站托管功能，或者静态网站托管功能未上线。	501 Not Implemented
NotImplemented	A header you provided implies functionality that is not implemented.	系统未实现	501 Not Implemented
NotSymlink	The specified object key is not symlink.	文件不是软链接类型	400 Bad Request
SymlinkTargetNotExist	The specified object key is symlink, target object of symlink does not exist.	软链接目标文件不存在	404 Not Found
PreconditionFailed	The specified If-Match header doesn't match the header you provided.	指定的If-Match请求头与用户提供的不匹配。	412 Precondition Failed
OptInRequired	You must active bos service.	BOS服务未开启，请开通BOS服务且确保账户未欠费。	403 Forbidden
RequestExpired	Request has expired. Timestamp date is XXX.	请求的时间戳过期。请求超时，XXX要改成x-bce-date的值。如果请求中只有Date，则需要将Date转换为本规范指定的格式。	403 Forbidden
RequestTimeout	Your socket connection to the server was not read from or written to within the timeout period.	请求超时	408 Request Timeout
RequestTimeTooSkewed	The difference between the request time and the server's time is too large.	请求时间与服务器时间差异过大	403 Forbidden
ObjectTooSmallToProcess	Object is too small to process.	文件过小，无法进行处理	400 Bad Request
ObjectTooLargeToProcess	Object is too large to process.	文件过大，无法进行处理	400 Bad Request
VideoSnapshotFail	Handle video snapshot fail	视频截帧失败	400 Bad Request
VideoRealtimeCodecFail	Handle video codec fail	视频转码失败	400 Bad Request
VideoInfoFail	Handle video info fail	获取视频信息失败	400 Bad Request
SignatureDoesNotMatch	The request signature we calculated does not match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details.	Authorization头域中附带的签名和服务端验证不一致	403 Forbidden
ServiceUnavailable	Please reduce your request rate.	服务不可用	503 Service Unavailable
SlowDown	Please reduce your request rate.	请求过于频繁	503 Service Unavailable
TooManyBuckets	You have attempted to create more buckets than allowed.	创建的Bucket数量超过限制	400 Bad Request
TooManyConfigurations	You have attempted to create more configurations than allowed.	创建配置超过限制	400 Bad Request
TooManyStyles	You have attempted to create more styles than allowed.	创建样式数量超过限制	400 Bad Request
TooManyJobs	You are attempting to create too many jobs.	创建批处理任务数量超过限制	400 Bad Request
TooManyMultiUploads	You have attempted to do more multipart uploads than allowed.	上传的分块数量超过限制	400 Bad Request
InvalidContentLength	Invalid Content-Length or Transfer-Encoding.	Content-Length不正确	400 Bad Request
ReadBodyError	Read http body error, please try again.	读取请求内容错误，请重试	400 Bad Request
DomainAlreadyExists	The specified domain is bound to %s already.	域名已被绑定到其他bucket	409 Conflict
TooManyDomains	You have attempted to bind to more buckets than allowed.	域名数据超过限制	400 Bad Request
NoSuchDomain	The specified domain does not exist.	域名不存在	404 Not Found
NoSuchMirroring	The specified mirroring configuration does not exist.	未配置镜像回源规则	404 Not Found
OffsetIncorrect	Offset not equal to current object length	追加Appendable Object时，<OffsetSize>值不等于已上传的Object的大小或者<OffsetSize>值不为0但Object不存在	409 Conflict
ObjectUnappendable	The object can not be append	不能对非Appendable的Object做AppendObject操作	403 Forbidden
NotAllowCopy	This object not allow to copy to another one	文件不允许复制	400 Bad Request
NotAllowModify	Permission not match, not allow modify object data	文件不允许修改	403 Forbidden
ObjectIllegal	The Object is illegal	文件不合规	403 Forbidden
OnlyAllowModify	Permission not match, you only have modify permission, so you can not upload a new object	权限不匹配，仅支持修改	403 Forbidden
ObjectAclNotPass	The object acl does not pass.	文件权限不匹配	403 Forbidden
ObjectBanned	Your object contains sensitive information. We have restricted your resources.	文件已被封禁	403 Forbidden
ObjectLocked	Your object has been locked.	文件已被锁定，无法进行操作	423 Locked
ObjectLockConflict	You cannot lock/unlock a banned object.	文件已被封禁	403 Forbidden
ObjectAclNotExists	The object acl does not exist.	未配置文件权限规则	404 Not Found
InternalError	We encountered an internal error. Please try again.	内部错误	500 Internal Server Error
PartialContentError	Errors occurred at storage system and return partial content.	请求时发生错误并返回部分内容	510 Not Extended
NoStorageAnalysisConf	No storage analysis conf is set.	未设置存储分析配置	404 Not Found
StorageAnalysisConfIdConflict	The confId you provide is confict with existing confs.	存储分析配置ID与现有配置冲突	409 Conflict
ObjectImmutable	The object is immutable	已经开启合规保留，文件无法进行删除或修改操作	409 Conflict
ObjectRenameConflict	Object rename conflict occurred, please retry it later or avoid concurrent update.	重命名文件冲突	409 Conflict
InvalidStorageAnalysisPrefix	The storage analysis prefix you provide is invalid.	存储分析配置中的文件前缀无效	400 Bad Request
StorageAnalysisConfigNumExceeded	Storage analysis confs have exceeded the max allow num.	存储分析配置数量超出限制	400 Bad Request
SqlSyntaxError	The sql expression in SelectRequest is invalid, it contains unsupported syntax or incorrect syntax.	SQL语法错误	400 Bad Request
InvalidSqlFields	The field in sql expression is invalid, it contains operators or other literals in SELECT clause.	SQL表达式中字段无效	400 Bad Request
InvalidSqlBinaryExpr	The binary expression in sql is invalid, left operand is incompatible with right operand.	SQL错误	400 Bad Request
SqlFieldsNumExceedLimit	The number of fields in sql expression exceed the maximum allowable number limit.	SQL中的字段数量超过了允许的最大数量限制	400 Bad Request
AggregateInvalidField	The field of aggregate function in the sql is invalid, it is not numeric data type.	SQL中聚合函数错误，使用字段非数值类型。	400 Bad Request
InvalidSqlJsonPathDepth	The depth of json path is invalid, it exceed the maximum limit or less than 1.	SQL错误，json路径的深度无效，超过最大限制或者小于1。	400 Bad Request
SqlSourceNumExceedLimit	Only one source is supported in sql expression.	SQL表达式中仅支持一个数据源	400 Bad Request
RecordTooLarge	The length of record in csv file exceeds limit.	CSV文件长度超过限制	400 Bad Request
FieldNotExist	The field in SQL not exist in file	SQL字段不存在	400 Bad Request
InappropriateJson	The format of json object is inappropriate.	JSON格式错误	400 Bad Request
HeaderNotExist	No valid header info is found in csv file.	CSV文件格式错误	400 Bad Request
DecompressError	Error occurred when decompress object.	文件解压失败	400 Bad Request
InvalidFileType	The type of file is invalid, only JSON and CSV are supported.	文件类型错误，仅支持JSON及CSV	400 Bad Request
DataOverflowsType	The aggregate result of data overflows data type limit.	数据聚合结果超出了数据类型的限制	400 Bad Request
InvalidSqlSource	Invalid data source in sql expression SELECT clause, check the sql source format of csv or json object.	请检查CSV或JSON对象的SQL源格式	400 Bad Request
InvalidSqlLimitValue	The value of LIMIT clause in sql expression is invalid, it must greater than zero.	SQL表达式中LIMIT值无效，必须大于零	400 Bad Request
InvalidSqlNotOperator	The operand of NOT operator is invalid, NOT operator only can be followed by BETWEEN/IN/LIKE.	SQL错误,"NOT"操作需要跟随"BETWEEN/IN/LIKE"之后。	400 Bad Request
InvalidSqlBetweenOperator	The operand of BETWEEN operator is invalid, BETWEEN should with AND.	SQL中"BETWEEN"使用错误	400 Bad Request
InvalidSqlInOperator	The values of IN operator are invalid, check values in (……).	SQL中"IN"操作使用错误	400 Bad Request
InvalidSqlIsOperator	The operand of IS operator is invalid, IS operator can only be followed by NULL or NOT NULL.	SQL中"IS"操作使用错误	400 Bad Request
InvalidSqlLikeOperator	The operand of LIKE operator is invalid, LIKE operator can only be followed by string.	SQL中"LIKE"操作使用错误	400 Bad Request
InvalidSqlFunction	The function in sql expression is invalid, check the function parameters number and type.	SQL表达式中的函数无效，请检查函数参数的数量和类型	400 Bad Request
InvalidExpressionParameter	The value of expression parameter in SelectRequest is invalid, please base64 decode it and do not exceed max length limit.	Select扫描请求expression参数错误，请进行base64编码并不超过长度限制。	400 Bad Request
InvalidExpressionTypeParameter	The value of expressionType parameter in SelectRequest is invalid, only SQL expressions are supported.	Select扫描请求expressionType参数错误	400 Bad Request
InvalidCompressionTypeParameter	The value of compressionType parameter in SelectRequest is invalid, only GZIP and NONE are supported.	Select扫描请求compressionType参数错误	400 Bad Request
InvalidJsonTypeParameter	The value of Json type parameter in SelectRequest is invalid, only DOCUMENT/LINES are supported.	Select扫描请求json type参数错误	400 Bad Request
InvalidQuoteFieldsParameter	The value of quote fields parameter in SelectRequest is invalid, only ALWAYS/ASNEEDED are supported.	Select扫描请求quote fields参数错误	400 Bad Request
InvalidSelectRequestJsonBody	Some parameters in SelectRequest json body is invalid, please check all optional and required parameters.	Select扫描请求参数错误	400 Bad Request
StorageAnalysisConfigNumExceeded	Storage analysis confs have exceeded the max allow num.	存储分析配置超过最大限制	400 Bad Request
NotArchiveObject	Object is not archive storage class.	当前object不是归档类型文件	400 Bad Request
DuplicationRequest	Duplication request.	重复请求	400 Bad Request
RestoreAlreadyInProgress	The object is restoring.Don't restore the object again.	您已经成功调用过RestoreObject接口，BOS服务端正在执行解冻操作。请不要重复执行RestoreObject	409 Conflict
RestoreAlready	The object is restored.	归档文件处于解冻状态，无需重重复调用	409 Conflict
ObjectLockAlreadyLocked	The object lock status is locked.	合规保留已开启	409 Conflict
ObjectLockAlreadyExpired	The object lock status is expired.	合规保留已过期	409 Conflict
CasUpdateConflict	An update conflict occurred, please retry it later or avoid concurrent update.	并发更新冲突，请稍后重试或者避免并发更新。	409 Conflict
InvalidObjectState	The object is freezed or restoring.	归档类型文件状态不合法，归档文件冰冻中或取回中。	403 Forbidden

接口规范

访问控制

百度智能云

对象存储 BOS

对象存储 BOS

错误码

错误信息格式

BOS错误码