Error code

Updated at：2025-11-03

Error message format

When an error occurs while accessing BOS, the corresponding error code and information will be returned to help the user identify and address the issue appropriately.

The format of the error message returned is as follows:

                JSON
                
            

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

BOS error code

Code and message fields are defined as follows:

Error code (code)	Message (message)	Description	HTTP status code
success	success	Succeeded	200 OK
success	Both this request and DPF request executed successfully.	The request executed successfully	200 OK
success	This request executed successful, but the DPF request is failed.	The request executed successfully, but the DPF failed	203 Non-Authoritative Information
success	This request executed successful, but the third-party platform executed failed.	The request executed successfully, but the third-party execution failed	203 Non-Authoritative Information
success	This request executed successful, but your dpf format is invalid.	The request executed successfully, but your DPF format is invalid	203 Non-Authoritative Information
success	Callback failed.	Callback failed	203 Non-Authoritative Information
success	Encrypt failed.	Encrypt failed	203 Non-Authoritative Information
success	Payload too large.	Payload too large	203 Non-Authoritative Information
success			204 No Content
InvalidEncryptionAlgorithm	The specified encryption algorithm is invalid	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	The specified encryption customer key is invalid. The MD5 checksum of the customer key does not match for object encryption.	400 Bad Request
InvalidEncryptionKmsMkid	The specified encryption kms mkid is invalid, please check its status	The specified encryption KMS MKID is invalid, please check its status	400 Bad Request
InvalidTargetType	The specified object key is symlink, target object of symlink also is symlink.	The symlink file does not support the symlink setting any more	400 Bad Request
InvalidEncryptionScheme	The specified encryption scheme is invalid, encrypt object by customer key must use https request	The encryption object must use HTTPS request	400 Bad Request
success	This request executed successful, but the dpf executed failed because the assumerole configuration you set is invalid.	This request was executed successfully, but the DPF failed due to an issue with user permission processing.	203 Non-Authoritative Information
AccessDenied	Access Denied.	Access Denied	403 Forbidden
AccountOverdue	Your request is denied because there is an overdue bill of your account.	Overdue bill of your account	403 Forbidden
AccessDeniedBySourceUrl	Access Denied By Source Url.	Access denied by source 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.	BadDigest: The Content-MD5, x-bce-content-sha256, or x-bce-content-crc32 value you provided does not match the computation on the server side.	400 Bad Request
BadDigestMD5	The Content-MD5 you specified did not match what we received.	The Content-MD5 you specified did not match the accurately uploaded data MD5.	400 Bad Request
BadDigestSHA256	The x-bce-content-sha256 you specified did not match what we received.	The x-bce-content-sha256 you specified did not match the accurately uploaded data sha256.	400 Bad Request
BadDigestCRC32	The x-bce-content-crc32 you specified did not match what we received.	The x-bce-content-crc32 you specified did not match the accurately uploaded data 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 already exists	409 Conflict
ObjectLockAlreadyInProgress	The bucket lock status is already InProgress	The bucket lock status is already in progress	409 Conflict
BucketNotEmpty	The bucket you tried to delete is not empty.	The bucket you tried to delete is not empty	409 Conflict
ClientSocketError	clinet socket error, maybe client close connection.	Client socket error—possibly caused by the client closing the connection.	200 OK
CORSConfigurationDoesNotMatch	The CORS Options request is not allowed because the request does not match with the CORS Configuration of the resource.	The request does not match with the CORS Configuration of the resource	403 Forbidden
CORSNotEnabled	The CORS is not enabled for this resource.	The CORS is not enabled for this resource	403 Forbidden
ReplicationNotEnabled	The Bucket Replication is not enabled.	The bucket replication is not enabled	404 Not Found
UserQuotaNotConfigured	The user quota does not configured	The user quota is 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	The cross-region replication source bucket or target bucket has been specified in another cross-region replication rule	409 Conflict
ReplicationStatusNotEmpty	The bucket you tried to delete has an enabled replication conf or is a dest replication bucket of other bucket	The bucket you attempted to delete has an enabled replication configuration.	409 Conflict
InventoryStatusError	The Bucket Inventory Status is not correct. Please make sure dest bucket is same region!	The bucket inventory status is incorrect. Please ensure the destination bucket is in the same region.	409 Conflict
ReplicationApiUsedInvalid	The replication api must upgrade,because you have used multi rules	The replication API must update	409 Conflict
ReplicationConfDuplicate	The replication has exist with different id	The replication has existed with different ID	409 Conflict
EmptyHTTPAuthHeader	The HTTP authorization header is empty. We do not allow using Session Token with empty authorization header	The authorization request header is missing in the sts signature request	400 Bad Request
EntityTooSmall	Your proposed upload is smaller than the minimum allowed object size.	Uploaded data size is under the limit	400 Bad Request
EntityTooLarge	Your proposed upload exceeds the maximum allowed object size.	Uploaded data size exceeds the limit	400 Bad Request
CapacityExceeded	Your total upload bytes exceeds the maximum allowed in your account.	Exceeded account capacity limit	403 Forbidden
BucketObjectNumExceeded	Your total upload object number exceeds the maxinum in your bucket	Exceeded bucket file count limit	403 Forbidden
BucketCapacityExceeded	Your total upload bytes exceeds the maximum allowed in your bucket	Exceeded bucket capacity limit	403 Forbidden
ObjectNumExceeded	Your total upload object number exceeds the maxinum in your account	Exceeded account file count limit	403 Forbidden
BucketQuotaNotConfigured	The bucket quota does not configured	The bucket quota is not configured	404 Not Found
FetchObjectTaskIsRunning	The fetch object task you submit is running.	The fetch object task you submit is running	200 OK
FetchObjectFailed	Fetch object failed, please check argument.	Fetch object failed	400 Bad Request
FileAlreadyExists	The object you specified already exists and can not be overwritten.	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.	The JSON format in the request is correct, but it is semantically invalid. For example, a required item might be missing, or the value type might not match.	400 Bad Request
InappropriateXML	The XML you provided was well-formed and valid, but not appropriate for this operation.	The XML format in the request is correct, but it is semantically invalid. This applies to scenarios similar to InappropriateJSON.	400 Bad Request
InvalidAccessKeyId	The BCS Access Key Id you provided does not exist in our records.	Provided Access Key does not exist	403 Forbidden
InvalidArgument	Invalid Argument.	Invalid argument	400 Bad Request
InvalidBucketName	The specified bucket is not valid.	The specified bucket is not valid	400 Bad Request
InvalidCopyDestination	The copy destination is not valid	The copy destination is not valid	400 Bad Request
InvalidCORSRequest	The CORS request is not valid	The CORS request is not valid	400 Bad Request
InvalidDomain	The specified domain is not valid.	The specified domain is not valid	400 Bad Request
InvalidHTTPAuthHeader	The HTTP authorization header is invalid. Consult the service documentation for details.	The HTTP authorization header is invalid	400 Bad Request
InvalidImageFormat	Your image format is invalid.	Your image format is invalid	400 Bad Request
InvalidObjectName	Your object key is too long.	Your file name is too long	400 Bad Request
InvalidTrashDirectoryName	Your trash directory name is not valid.	Your trash directory name is not valid	400 Bad Request
InvalidDirectory	Directory file must be empty	Directory file must be empty	400 Bad Request
ObjectLockNotLocked	The object lock is not locked, can not extend retentionday	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.	One or more of the specified parts could not be located. The part may not have been uploaded, or the specified entity tag might not match the part's actual tag.	400 Bad Request
InvalidPartOrder	The list of parts was not in ascending order.Parts list must specified in order by part number.	The list of parts was not in ascending order	400 Bad Request
InvalidPolicyDocument	The content of the form does not meet the conditions specified in the policy document.	The content of the form does not meet the conditions specified in the policy document	400 Bad Request
InvalidRange	The requested range cannot be satisfied.	The requested range cannot be satisfied	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)	The STS Token you provided is not valid	400 Bad Request
InvalidURI	Could not parse the specified URI.	Invalid URI format	400 Bad Request
InvalidStaticWebSiteFormat	The format of index file or 404 file are not allowed.	The format of the index file or 404 file is not allowed. For example, the file format is invalid, or the index file has the same name as the 404 file.	400 Bad Request
InvalidJobStatus	The current job status does not supprot the operation.	The current job status does not support the operation	400 Bad Request
InvalidStorageClass	The storage class specified is invalid, please check argument and consult the service documentation.	The storage class specified is incorrect	400 Bad Request
NotSupportStorageClass	The storage class specified is not support, please check argument and consult the service documentation.	The storage class specified is incorrect	501 Not Implemented
NotAllowShortenRetentionday	Could not shorten retentionday	Could not shorten retentionday	400 Bad Request
InvalidVersion	The API version specified was invalid.	The API version specified is incorrect	404 Not Found
RequestRateLimitExceeded	Your request rate is too high. We have put limits on your bucket.	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.	The JSON you provided was not well-formed	400 Bad Request
MalformedXML	The XML you provided was not well-formed or did not validate against our published schema.	The XML you provided was not well-formed	400 Bad Request
MaxMessageLengthExceeded	Your request was too big.	Your request was too big	400 Bad Request
MetadataTooLarge	Your metadata headers exceed the maximum allowed metadata size.	Your metadata headers exceed the maximum allowed metadata size	400 Bad Request
MethodNotAllowed	The specified method is not allowed against this resource.	Request method error	405 Method Not Allowed
MirrorFailed	Mirroring failed, please check your mirror configuration.	Mirroring failed	424 Failed Dependency
MissingContentLength	You must provide the Content-Length HTTP header.	You must provide the Content-Length HTTP header	411 Length Required
MissingDateHeader	Request must have a "date" or "x-bce-date" header.	Request must have a "date" or "x-bce-date" header; if both date and x-bce-date are added, the priority of x-bce-date is higher than date. For their formats, please refer to: \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.	The specified bucket does not exist	404 Not Found
NoSuchInventoryConfiguration	The specified inventory configuration does not exist.	The specified inventory configuration does not exist	404 Not Found
NoSuchCORSConfiguration	The CORS configuration does not exist.	The CORS configuration does not exist	404 Not Found
NoLifecycleConfiguration	The lifecycle configuration does not exist.	The lifecycle configuration does not exist	404 Not Found
NoProcessConfiguration	The process configuration does not exist.	The process configuration does not exist	404 Not Found
NoNotificationConfiguration	The notification configuration does not exist.	The notification configuration does not exist	404 Not Found
NoReplicationConfiguration	The Replication configuration does not exist.	The replication configuration does not exist	404 Not Found
NoSuchKey	The specified key does not exist.	This object does not exist	404 Not Found
NoSuchStyle	The specified style does not exist.	The specified style does not exist	404 Not Found
NoSuchObjectLock	The specified object lock does not exist.	The specified object lock does not exist	404 Not Found
NoSuchJob	The job does not exist.	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.	The three-step upload associated with this uploadId does not exist. The uploadId is incorrect, or the three-step upload has been suspended or completed.	404 Not Found
NoCopyrightProtectionConfiguration	The copyright protection configuration does not exist.	The copyright protection configuration does not exist	404 Not Found
NoSuchBucketEncryption	The bucket is not encrypted.	The bucket is not encrypted.	404 Not Found
NoSuchBucketTrashDirectory	The bucket does not activate trash, or trash has been turned off	The bucket does not activate trash	404 Not Found
NoSuchBucketAlias	The bucket does not activate alias, or bucket alias has been turned off	The bucket alias does not exist	404 Not Found
NoSuchBucketDefaultStyle	The bucket does not activate default style, or bucket default style has been turned off	The default bucket form does not exist	404 Not Found
NoSuchBucketStaticWebSiteConfig	The static web site configuration does not exist.	The static web site configuration does not exist for the bucket	404 Not Found
StaticWebSiteIsDisable	Static web site is disabled or not implemented.	Static website functionality is disabled. For example, BOS might not allow buckets in this region to enable static website hosting, or the hosting service might not be online.	501 Not Implemented
NotImplemented	A header you provided implies functionality that is not implemented.	The system fails to implement	501 Not Implemented
NotSymlink	The specified object key is not symlink.	The specified object key is not symlink	400 Bad Request
SymlinkTargetNotExist	The specified object key is symlink, target object of symlink does not exist.	The target object of symlink does not exist	404 Not Found
PreconditionFailed	The specified If-Match header doesn't match the header you provided.	The If-Match request header you specified does not match the provided header.	412 Precondition Failed
OptInRequired	You must active bos service.	The BOS service is not enabled. Please activate the BOS service and ensure your account has no outstanding debt.	403 Forbidden
RequestExpired	Request has expired. Timestamp date is XXX.	The request timestamp has expired. The request is overdue; the value of XXX should match x-bce-date. If the request only contains Date, it must be converted into the format specified by this standard.	403 Forbidden
RequestTimeout	Your socket connection to the server was not read from or written to within the timeout period.	Request timeout	408 Request Timeout
RequestTimeTooSkewed	The difference between the request time and the server's time is too large.	The difference between the request time and the server's time is too large.	403 Forbidden
ObjectTooSmallToProcess	Object is too small to process.	File is too small to process	400 Bad Request
ObjectTooLargeToProcess	Object is too large to process.	File is too large to process	400 Bad Request
VideoSnapshotFail	Handle video snapshot fail	Handle video snapshot fail	400 Bad Request
VideoRealtimeCodecFail	Handle video codec fail	Handle video codec fail	400 Bad Request
VideoInfoFail	Handle video info fail	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.	Signature in the Authorization header doesn’t match server verification	403 Forbidden
ServiceUnavailable	Please reduce your request rate.	Service unavailable	503 Service Unavailable
SlowDown	Please reduce your request rate.	Requests too frequent	503 Service Unavailable
TooManyBuckets	You have attempted to create more buckets than allowed.	You have attempted to create more buckets than allowed	400 Bad Request
TooManyConfigurations	You have attempted to create more configurations than allowed.	You have attempted to create more configurations than allowed	400 Bad Request
TooManyStyles	You have attempted to create more styles than allowed.	You have attempted to create more styles than allowed	400 Bad Request
TooManyJobs	You are attempting to create too many jobs.	You are attempting to create too many jobs	400 Bad Request
TooManyMultiUploads	You have attempted to do more multipart uploads than allowed.	You have attempted to do more multipart uploads than allowed	400 Bad Request
InvalidContentLength	Invalid Content-Length or Transfer-Encoding.	Invalid Content-Length	400 Bad Request
ReadBodyError	Read http body error, please try again.	Read http body error, please try again	400 Bad Request
DomainAlreadyExists	The specified domain is bound to %s already.	The specified domain is bound to other bucket already	409 Conflict
TooManyDomains	You have attempted to bind to more buckets than allowed.	You have attempted to bind to more buckets than allowed	400 Bad Request
NoSuchDomain	The specified domain does not exist.	The specified domain does not exist	404 Not Found
NoSuchMirroring	The specified mirroring configuration does not exist.	The specified mirroring configuration does not exist	404 Not Found
OffsetIncorrect	Offset not equal to current object length	When adding the appendable object, the <OffsetSize> value is not equal to the size of the uploaded object or the <OffsetSize> value is not 0 but the object doesn’t exist	409 Conflict
ObjectUnappendable	The object can not be append	AppendObject operation is forbidden on non-Appendable objects	403 Forbidden
NotAllowCopy	This object not allow to copy to another one	This object not allow to copy to another one	400 Bad Request
NotAllowModify	Permission not match, not allow modify object data	Permission not match, not allow modify object data	403 Forbidden
ObjectIllegal	The Object is illegal	The object is illegal	403 Forbidden
OnlyAllowModify	Permission not match, you only have modify permission, so you can not upload a new object	Permission not match, you only have modify permission	403 Forbidden
ObjectAclNotPass	The object acl does not pass.	The object permission does not match	403 Forbidden
ObjectBanned	Your object contains sensitive information. We have restricted your resources.	The object is banned	403 Forbidden
ObjectLocked	Your object has been locked.	Your object has been locked and cannot be operated	423 Locked
ObjectLockConflict	You cannot lock/unlock a banned object.	The object is banned	403 Forbidden
ObjectAclNotExists	The object acl does not exist.	The object permission rule configuration does not exist	404 Not Found
InternalError	We encountered an internal error. Please try again.	Internal error	500 Internal Server Error
PartialContentError	Errors occurred at storage system and return partial content.	Errors occurred at storage system and return partial content	510 Not Extended
NoStorageAnalysisConf	No storage analysis conf is set.	No storage analysis configuration is set	404 Not Found
StorageAnalysisConfIdConflict	The confId you provide is confict with existing confs.	The storage analysis configuration ID conflicts with the existing configuration	409 Conflict
ObjectImmutable	The object is immutable	The retention is enabled so the object cannot be deleted or modified	409 Conflict
ObjectRenameConflict	Object rename conflict occurred, please retry it later or avoid concurrent update.	Object rename conflict occurred	409 Conflict
InvalidStorageAnalysisPrefix	The storage analysis prefix you provide is invalid.	The storage analysis prefix you provide is invalid	400 Bad Request
StorageAnalysisConfigNumExceeded	Storage analysis confs have exceeded the max allow num.	Storage analysis configurations have exceeded the max allow number	400 Bad Request
SqlSyntaxError	The sql expression in SelectRequest is invalid, it contains unsupported syntax or incorrect syntax.	The SQL expression is incorrect	400 Bad Request
InvalidSqlFields	The field in sql expression is invalid, it contains operators or other literals in SELECT clause.	The field in SQL expression is invalid	400 Bad Request
InvalidSqlBinaryExpr	The binary expression in sql is invalid, left operand is incompatible with right operand.	The SQL is incorrect	400 Bad Request
SqlFieldsNumExceedLimit	The number of fields in sql expression exceed the maximum allowable number limit.	The number of fields in SQL expression exceed the maximum allowable number limit	400 Bad Request
AggregateInvalidField	The field of aggregate function in the sql is invalid, it is not numeric data type.	The aggregate function field in the SQL is incorrect; it must be a numeric data type.	400 Bad Request
InvalidSqlJsonPathDepth	The depth of json path is invalid, it exceed the maximum limit or less than 1.	The SQL query is invalid due to the JSON path depth exceeding the maximum limit or being less than 1.	400 Bad Request
SqlSourceNumExceedLimit	Only one source is supported in sql expression.	Only one data source is supported in the SQL expression	400 Bad Request
RecordTooLarge	The length of record in csv file exceeds limit.	CSV file is too long	400 Bad Request
FieldNotExist	The field in SQL not exist in file	The field in SQL not exist in file	400 Bad Request
InappropriateJson	The format of json object is inappropriate.	The format of JSON object is inappropriate	400 Bad Request
HeaderNotExist	No valid header info is found in csv file.	The format CSV file is incorrect	400 Bad Request
DecompressError	Error occurred when decompress object.	Error occurred when decompress object	400 Bad Request
InvalidFileType	The type of file is invalid, only JSON and CSV are supported.	The type of file is incorrect, only JSON and CSV are supported	400 Bad Request
DataOverflowsType	The aggregate result of data overflows data type limit.	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.	Please check the SQL source format of CSV or JSON object	400 Bad Request
InvalidSqlLimitValue	The value of LIMIT clause in sql expression is invalid, it must greater than zero.	The value of LIMIT clause in sql expression is invalid, it must greater than zero	400 Bad Request
InvalidSqlNotOperator	The operand of NOT operator is invalid, NOT operator only can be followed by BETWEEN/IN/LIKE.	The SQL query contains an error; the "NOT" operation must follow "BETWEEN/IN/LIKE."	400 Bad Request
InvalidSqlBetweenOperator	The operand of BETWEEN operator is invalid, BETWEEN should with AND.	The use of "BETWEEN” in SQL is incorrect	400 Bad Request
InvalidSqlInOperator	The values of IN operator are invalid, check values in (……).	The use of "IN” in SQL is incorrect	400 Bad Request
InvalidSqlIsOperator	The operand of IS operator is invalid, IS operator can only be followed by NULL or NOT NULL.	The use of "IS” in SQL is incorrect	400 Bad Request
InvalidSqlLikeOperator	The operand of LIKE operator is invalid, LIKE operator can only be followed by string.	The use of "LIKE” in SQL is incorrect	400 Bad Request
InvalidSqlFunction	The function in sql expression is invalid, check the function parameters number and type.	The function in SQL expression is invalid; check the function parameters number and type.	400 Bad Request
InvalidExpressionParameter	The value of expression parameter in SelectRequest is invalid, please base64 decode it and do not exceed max length limit.	The value of the expression parameter in SelectRequest is incorrect. Please decode it using base64 and ensure it does not exceed the maximum length limit.	400 Bad Request
InvalidExpressionTypeParameter	The value of expressionType parameter in SelectRequest is invalid, only SQL expressions are supported.	The value of expressionType parameter in SelectRequest is incorrect	400 Bad Request
InvalidCompressionTypeParameter	The value of compressionType parameter in SelectRequest is invalid, only GZIP and NONE are supported.	The value of compressionType parameter in SelectRequest is incorrect	400 Bad Request
InvalidJsonTypeParameter	The value of Json type parameter in SelectRequest is invalid, only DOCUMENT/LINES are supported.	The value of json type parameter in SelectRequest is incorrect	400 Bad Request
InvalidQuoteFieldsParameter	The value of quote fields parameter in SelectRequest is invalid, only ALWAYS/ASNEEDED are supported.	The value of quote fields parameter in SelectRequest is incorrect	400 Bad Request
InvalidSelectRequestJsonBody	Some parameters in SelectRequest json body is invalid, please check all optional and required parameters.	Some parameters in SelectRequest are incorrect	400 Bad Request
StorageAnalysisConfigNumExceeded	Storage analysis confs have exceeded the max allow num.	Storage analysis configurations have exceeded the max allow number	400 Bad Request
NotArchiveObject	Object is not archive storage class.	The current object is not archive storage class file	400 Bad Request
DuplicationRequest	Duplication request.	Duplication request	400 Bad Request
RestoreAlreadyInProgress	The object is restoring.Don't restore the object again.	You have successfully invoked the RestoreObject API, and the BOS server is processing the restoration. Please refrain from executing RestoreObject again.	409 Conflict
RestoreAlready	The object is restored.	The archive file is restored status, so there is no need to call again	409 Conflict
ObjectLockAlreadyLocked	The object lock status is locked.	The object lock status is locked	409 Conflict
ObjectLockAlreadyExpired	The object lock status is expired.	The object lock status is expired	409 Conflict
CasUpdateConflict	An update conflict occurred, please retry it later or avoid concurrent update.	An update conflict has occurred. Please try again later or avoid concurrent updates.	409 Conflict
InvalidObjectState	The object is freezed or restoring.	The object status is invalid as it is either frozen or being restored.	403 Forbidden

Introduction

Upload callback