Error Codes

Last updated: 2019-06-14 18:48:24

PDF

Overview

This document describes the error codes and the error messages returned when requests fail.

Format of Returned Error Message

Response headers

Content-Type:application/xml

HTTP status codes: 3xx, 4xx, or 5xx

Response content

Syntax format

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>[Error code]</Code>
  <Message>[Error message]</Message>
  <Resource>[Resource address]</Resource>
  <RequestId>[Request ID]</RequestId>
  <TraceId>[Error ID]</TraceId>
</Error>

Element description

Element Name Description Type
Error Contains all error information Container
Code Error code, which uniquely identifies an error condition and determines the error scenario. Error codes are described in detail below. String
Message Contains detailed error message String
Resource Resource address: Bucket address or Object address String
RequestId The unique ID generated automatically by the server when a request is sent. It can be used to quickly locate any problem occurred. String
TraceId The unique ID generated automatically by the server when an error occurs with the request. It can be used to quickly locate any problem occurred. One trace-id corresponds to one request-id. String

Error Codes

3XX errors

Error Code Description HTTP Status Code
PermanentRedirect This resource has been moved to another location permanently. Redirect to a new location by using HTTP Location. 301 Moved Permanently
TemporaryRedirect This resource has been moved to another location temporarily. Redirect to a new location by using HTTP Location. 302 Moved Temporarily
Redirect Temporary redirection 307 Moved Temporarily
TemporaryRedirect You are redirected temporarily during DNS update 307 Moved Temporarily

4XX Errors

Error Code Description HTTP Status Code
InvalidSHA1Digest sha1 of the request content is invalid 400 Bad Request
NoSuchUpload The uploadid specified for the multipart upload does not exist 400 Bad Request
InvalidPart One or more parts cannot be found 400 Bad Request
InvalidPartOrder The list of parts was not in ascending order 400 Bad Request
ObjectNotAppendable Specified file is not appendable 400 Bad Request
AppendPositionErr The length of the file is inconsistent with the append position 400 Bad Request
NoSuchVersion Specified version does not exist 400 Bad Request
NoLifecycle Lifecycle does not exist 400 Bad Request
PreconditionFailed At least one of the preconditions you specified did not hold 400 Bad Request
UnexpectedContent The content is not supported for the request 400 Bad Request
MultiBucketNotSupport Only one destination Bucket can be configured in cross-origin replication 400 Bad Request
NotSupportedStorageClass The specified storage type is invalid 400 Bad Request
BadDigest The x-cos-SHA-1 value you provided does not match that received by the server 400 Bad Request
EntityTooSmall Your proposed upload is smaller than the minimum allowed object size, which usually happens in multipart uploads. 400 Bad Request
EntityTooLarge Your proposed upload exceeds the maximum allowed object size 400 Bad Request
ImcompleteBody The actual content length of the request is inconsistent with the specified Content-Lengt. 400 Bad Request
IncorrectNumberOfFilesInPostRequest Only one file is allowed to be uploaded at a time for a Post request 400 Bad Request
InlineDataTooLarge Inline data exceeds the maximum allowed size 400 Bad Request
InvalidArgument The request parameter is invalid 400 Bad Request
InvalidBucketName The Bucket name is invalid 400 Bad Request
InvalidDigest The x-cos-SHA-1 value is invalid 400 Bad Request
InvalidPart One or more parts cannot be found or SectionID is invalid 400 Bad Request
InvalidPolicyDocunment Policy configuration file is invalid 400 Bad Request
InvalidURI The URI is invalid 400 Bad Request
KeyTooLong Custom header is too long 400 Bad Request
MalformedACLError The specified ACL policy does not comply with XML syntax 400 Bad Request
MalformedPOSTRequest The body content of the POST request is invalid 400 Bad Request
MalformedXML The body in XML format does not comply with XML syntax 400 Bad Request
MaxMessageLengthExceeded Request is too long 400 Bad Request
MaxPostPreDataLengthExceededError The POST request fields preceding the upload file were too large, which usually happens in multipart upload operations. 400 Bad Request
MatadataTooLarge The size of metadata exceeds the maximum allowed size 400 Bad Request
MissingRequestBodyError Request body is missing 400 Bad Request
MissingSecurityHeader Required header is missing 400 Bad Request
MissingContentMD5 Content-MD5 is missing in request header 400 Bad Request
MissingAppid Appid is missing in request header 400 Bad Request
MissingHost Host is missing in request header 400 Bad Request
RequestIsNotMultiPartContent The Content-Type of the POST request is invalid 400 Bad Request
RequestTimeOut Read timed out. Check your network speed or reduce the number of concurrent uploads. 400 Bad Request
TooManyBucket The number of Buckets exceeds the limit of 200 400 Bad Request
UnexpectedContent The content is not supported for the request 400 Bad Request
UnresolvableGrantByUID The provided UID does not exist 400 Bad Request
UserKeyMustBeSpecified The path must be specified for the POST operation performed against a Bucket 400 Bad Request
ExpiredToken Signature string expired 403 Forbidden
AccessDenied Access denied due to invalid signature or permission 403 Forbidden
AccountProblem This operation has been denied by your account 403 Forbidden
InvaildAccessKeyId AccessKey does not exist 403 Forbidden
InvalidObjectState Request content conflicts with the attribute of the Object 403 Forbidden
InvalidSecurity Signature string is invalid 403 Forbidden
RequestTimeTooSkewed The difference between the request time and the server's time is too large 403 Forbidden
SignatureDoesNotMatch Incorrect signature 403 Forbidden
NoSuchBucket The specified Bucket does not exist 404 Not Found
NoSuchUpload The specified multipart upload does not exist 404 Not Found
NoSuchBucket The specified Bucket policy does not exist 404 Not Found
MethodNotAllowed The HTTP method is not supported for this resource 405 Method Not Allowed
BucketAlreadyExists BucketName specified by CreateBucket is already in use. Select another BucketName. 409 Conflict
BucketNotEmpty Delete files and unfinished multipart upload tasks before performing DeleteBucket operation 409 Conflict
InvalidBucketState Bucket status conflicts with operation request. For example, multi-version management conflicts with cross-origin replication. 409 Conflict
OperationAborted The operation is not supported for the specified resource, or the resource being downloaded is incomplete or damaged during transfer. 409 Conflict
MissingContentLength The header "Content-Length" is missing 411 Length Required
PreconditionFailed Precondition matching failed 412 Precondition
InvalidRange Requested file range is invalid 416 Requested Range Not Satisfiable

5XX Errors

Error Code Description HTTP Status Code
InternalError Internal error occurred with the server 500 Internal Server
NotImplemented A method in the Header cannot be implemented 501 Not Implemented
ServiceUnavailable Internal error occurred with the server. Try again. 503 Service Unavailable
SlowDown Reduce your request rate 503 Slow Down

Other Errors

Error Code Description HTTP Status Code
InvaildAddressingHeader Anonymous access is required N/A