Error Codes

Last updated: 2019-12-16 14:42:37

    Overview

    This document describes the error codes and corresponding error messages returned when a request fails.

    Error Response

    Content-Type: application/xml

    Corresponding HTTP status code: 3XX, 4XX, or 5XX. Please note that for the PUT Object - Copy API, even if the HTTP status code is 200, the response body may still include an error.

    Response Body

    <?xml version='1.0' encoding='utf-8' ?>
    <Error>
        <Code>string</Code>
        <Message>string</Message>
        <Resource>string</Resource>
        <RequestId>string</RequestId>
        <TraceId>string</TraceId>
    </Error>

    The nodes are described in details below:

    Node Name (Keyword) Parent Node Description Type
    Error None Contains all error information Container

    Content of the Container node Error :

    Node Name (Keyword) Parent Node Description Type
    Code Error Error codes used to locate unique error conditions and determine error scenarios. See below for specific error codes string
    Message Error Specific error message string
    Resource Error Requested resource: bucket address or object address string
    RequestId Error An ID automatically generated by the server for each request; COS can use the ID to quickly locate problems string
    TraceId Error An ID automatically generated by the server for each error; COS can use the ID to quickly locate problems string

    Error Code List

    3XX errors

    Error Code Description HTTP Status Code
    PermanentRedirect This resource has been permanently relocated. Please use the HTTP Location response header to get redirected to the correct location 301 Moved Permanently
    TemporaryRedirect This resource has been temporarily relocated. Please use the HTTP Location response header to get redirected to the correct location 302 Moved Temporarily
    Redirect Temporarily redirected 307 Moved Temporarily
    TemporaryRedirect You will be temporarily redirected during the DNS update 307 Moved Temporarily

    4XX errors

    Error Code Description HTTP Status Code
    AppendPositionErr The object length doesn't match the position during the Append operation 400 Bad Request
    AttachmentFull The number of ACLs and policies has reached the upper limit 400 Bad Request
    BadDigest The provided Content-MD5 value is different from the MD5 hash of the request body received by the server 400 Bad Request
    EntityTooLarge The size of the uploaded object exceeds the specified maximum value 400 Bad Request
    EntityTooSmall The size of the uploaded object is below the specified minimum value. This error often occurs in multipart uploads 400 Bad Request
    IncorrectNumberOfFilesInPostRequest Only one object can be uploaded in one POST request 400 Bad Request
    InvalidArgument Invalid request parameter 400 Bad Request
    InvalidBucketName Invalid bucket name 400 Bad Request
    InvalidCopySource Invalid source for object copy 400 Bad Request
    InvalidDigest The given Content-MD5 value is invalid 400 Bad Request
    InvalidPart Missing part 400 Bad Request
    InvalidPartOrder Part numbers are not continuous 400 Bad Request
    InvalidRegionName Invalid region name 400 Bad Request
    InvalidRequest Invalid request 400 Bad Request
    InvalidSHA1Digest Invalid SHA1 checksum of the request content 400 Bad Request
    InvalidURI Invalid URI 400 Bad Request
    KeyTooLong The object key is too long 400 Bad Request
    LifeCycleIdNotUnique The lifecycle ID is not unique 400 Bad Request
    LifeCycleRuleConflicted There is a conflict in the lifecycle settings 400 Bad Request
    MalformedPOSTRequest The request body content of this POST request is invalid 400 Bad Request
    MalformedXML The XML format of the request body does not conform to the XML syntax 400 Bad Request
    MissingAppid APPID is missing in the request headers 400 Bad Request
    MissingContentMD5 Content-MD5 is missing in the request headers 400 Bad Request
    MissingHost Host is missing in the request headers 400 Bad Request
    MissingRequestBodyError Missing request body 400 Bad Request
    MultiBucketNotSupport Only one destination bucket can be set for cross-region replication 400 Bad Request
    NoSuchVersion The specified version does not exist 400 Bad Request
    NotSupportedStorageClass The specified storage class is not supported 400 Bad Request
    ObjectNotAppendable The specified object cannot be appended 400 Bad Request
    PolicyFull The number of ACLs and policies has reached the upper limit 400 Bad Request
    RequestTimeOut Data read timed out. Check your network speed or reduce the number of concurrent uploads 400 Bad Request
    TooManyBuckets The number of buckets has reached the upper limit (200) 400 Bad Request
    UnexpectedContent The request does not support the content 400 Bad Request
    VerifyAlgorithmNotSupported The verification algorithm is not supported 400 Bad Request
    WebsiteURLInvalid Invalid custom domain name URL 400 Bad Request
    XMLSizeLimit The length of XML has exceeded the limit 400 Bad Request
    AccessDenied Access denied due to wrong signature or permission 403 Forbidden
    ExpiredToken The signature string has expired 403 Forbidden
    InvalidAccessKeyId The SecretID does not exist 403 Forbidden
    InvalidObjectState The request content conflicts with the object attributes 403 Forbidden
    InvalidObjectStorage Invalid storage class 403 Forbidden
    RequestTimeTooSkewed The gap between the local time and the server time is over 15 minutes 403 Forbidden
    SignatureDoesNotMatch The signature calculated by the client does not match that calculated by the COS server 403 Forbidden
    NoSuchBucket The specified bucket does not exist 404 Not Found
    NoSuchCopySource The object copy source does not exist 404 Not Found
    NoSuchCORSConfiguration The specified CORS configuration does not exist 404 Not Found
    NoSuchKey The specified object key does not exist 404 Not Found
    NoSuchLifecycleConfiguration The specified lifecycle configuration does not exist 404 Not Found
    NoSuchTagSet The specified tag set does not exist 404 Not Found
    NoSuchUpload The UploadId specified for the multipart upload does not exist 404 Not Found
    NoSuchWebsiteConfiguration The static website configuration does not exist 404 Not Found
    MethodNotAllowed This resource does not support this HTTP method 405 Method Not Allowed
    RestoreNonArchiveObject It is not allowed to restore a non-archived object 405 Method Not Allowed
    BucketAlreadyExists The specified bucket already exists. 409 Conflict
    BucketAlreadyOwnedByYou The specified bucket already exists and was created by the current account. 409 Conflict
    BucketNotEmpty The bucket is not empty 409 Conflict
    InvalidBucketState The bucket state conflicts with the operational request; for example, versioning configuration conflicts with cross-region replication 409 Conflict
    PathConflict Millisecond-level concurrence conflict occurred for objects with the same name 409 Conflict
    RestoreAlreadyInProgress This object is being restored 409 Conflict
    MissingContentLength The Content-Length request header is missing 411 Length Required
    PreconditionFailed Precondition match failed 412 Precondition
    InvalidRange The requested object range is invalid 416 Requested Range Not Satisfiable
    UnavailableForLegalReasons Unavailable for legal reasons 451 Unavailable For Legal Reasons

    5XX errors

    Error Code Description HTTP Status Code
    InternalErrror Internal server error 500 Internal Server
    NotImplemented The request has not been implemented yet 501 Not Implemented
    ServiceUnavailable The service is temporarily unavailable. Please try again 503 Service Unavailable
    SlowDown Please reduce the access frequency 503 Slow Down

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help