tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageAPI DocumentationError Codes
Error Codes
Download PDF
Last updated: 2024-03-28 15:36:00
Error Codes
Last updated: 2024-03-28 15:36:00
Download PDF

Overview

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

Error Response

Content-Type: application/xml
HTTP status codes could be 3xx, 4xx, or 5xx. 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 as follows:
Node Name (Keyword)
Parent Node
Description
Type
Error
None
All error messages
Container
Error has the following sub-nodes:
Node Name (Keyword)
Parent Node
Description
Type
Code
Error
Error code, which uniquely identifies an error condition and determines the error scenario. Error codes are described in detail below.
string
Message
Error
Specific error message
string
Resource
Error
Requested resource, which can be a bucket or object URL
string
RequestId
Error
An ID automatically generated by the server when a request is sent. COS can use it to quickly locate faults
string
TraceId
Error
An ID automatically generated by the server when a request error occurs. COS can use it to quickly locate faults
string

Error Codes

4xx errors

HTTP Status Code
Error Code
Description
400 Bad Request
ActionAccelerateNotSupported
The acceleration endpoint does not support this operation.
400 Bad Request
AttachmentFull
The number of ACLs and policies has exceeded the upper threshold. For more information, please see Specifications and Limits.
400 Bad Request
BadDigest
Value of the provided Content-MD5 is not the same as the MD5 hash value the server received.
400 Bad Request
BadRequest
Parameter error.
400 Bad Request
BucketAccelerateNotEnabled
The acceleration endpoint is not enabled for the bucket
400 Bad Request
BucketNameTooLong
The bucket name is too long. For more information, please see Naming Conventions in Bucket Overview
400 Bad Request
BucketVersionNotOpen
Versioning is not enabled for the bucket
400 Bad Request
DNSRecordVerifyFailed
The DNS record fails to be verified. Please add a CNAME or TXT record. The DNS record takes effect within 10 minutes
400 Bad Request
EntitySizeNotMatch
The size of the request body is not the same as that specified in the Content-Length request header
400 Bad Request
EntityTooLarge
The size of the uploaded object exceeds the upper threshold. For more information, please see Specifications and Limits
400 Bad Request
EntityTooSmall
The size of the uploaded object does not reach the lower threshold. This error is often seen in multipart uploads. For more information, please see Specifications and Limits
400 Bad Request
ExpiredToken
The temporary key token has expired
400 Bad Request
ImageResolutionExceed
The image resolution exceeds the limit, or the animated image contains too many frames
400 Bad Request
ImageTooLarge
The image is too large
400 Bad Request
IncompleteBody
The size of the request body is smaller than that specified in the Content-Length request header
400 Bad Request
IncorrectNumberOfFilesInPostRequest
Only one object can be uploaded in a POST Object request
400 Bad Request
InvalidArgument
The argument is invalid. Please check whether the request can take this argument
400 Bad Request
InvalidBucketName
The bucket name is invalid. For more information, please see Naming Conventions
400 Bad Request
InvalidCopySource
The source for object replication is invalid
400 Bad Request
InvalidDelimiter
The delimiter parameter is invalid. It should be one character
400 Bad Request
InvalidDigest
The provided value of Content-MD5 is invalid
400 Bad Request
InvalidImageFormat
The image format is invalid
400 Bad Request
InvalidImageSource
The image source is invalid
400 Bad Request
InvalidLocationConstraint
The specified location is invalid
400 Bad Request
InvalidObjectName
The object name is invalid. For more information, please see ObjectKey
400 Bad Request
InvalidPart
One or more parts are missing
400 Bad Request
InvalidPartOrder
The part numbers are not continuous
400 Bad Request
InvalidPicOperations
The Pic-Operations request header is invalid
400 Bad Request
InvalidPolicyDocument
The policy in the POST Object request is invalid
400 Bad Request
InvalidRegionName
The endpoint is invalid. For more information, please see Regions and Access Endpoints
400 Bad Request
InvalidRequest
The request is invalid
400 Bad Request
InvalidSHA1Digest
The request fails the SHA-1 verification
400 Bad Request
InvalidTag
The bucket tag is invalid. For more information, please see Bucket Tag Overview
400 Bad Request
InvalidTargetBucketForLogging
The destination bucket for logging is invalid. The destination bucket must be in the same region as the current bucket
400 Bad Request
InvalidUploadStatus
If versioning is enabled, you cannot call a JSON API to upload objects. Please use an XML API
400 Bad Request
InvalidURI
The URI is invalid
400 Bad Request
InventoryFull
The number of inventory jobs has exceeded the upper threshold (1,000)
400 Bad Request
JsonAPINotSupportOnMAZBucket
JSON APIs do not support operations on MAZ buckets. Please use XML APIs
400 Bad Request
KeyTooLong
The object key is too long. For more information, please see “ObjectKey” in Object Overview
400 Bad Request
KmsException
A Key Management Service (KMS) exception occurs
400 Bad Request
KmsKeyDisabled
The provided key is disabled
400 Bad Request
KmsKeyNotExist
The provided key does not exist
400 Bad Request
ListPartUploadIdIsEmpty
UploadId is empty
400 Bad Request
LoggingConfExists
The logging configuration already exists
400 Bad Request
LoggingPrefixInvalid
The logging prefix is invalid
400 Bad Request
MalformedPolicy
The policy format is invalid
400 Bad Request
MalformedPOSTRequest
The request body content of the current POST request is invalid
400 Bad Request
MalformedXML
The XML syntax of the request body is incorrect
400 Bad Request
MAZOperationNotSupportOnOAZBucket
OAZ buckets do not support multi-AZ operations. For the multi-AZ feature and its use limits, see Overview of Multi-AZ Feature
400 Bad Request
MissingRequestBodyError
The request body is missing
400 Bad Request
MultiAZFeatureNotSupport
The current region does not support the MAZ feature
400 Bad Request
MultiBucketNotSupport
Only one destination bucket can be set for cross-region replication
400 Bad Request
NotifyRuleEventConflict
Notification rules (event) conflict
400 Bad Request
NotifyRulePrefixConflict
Notification rule prefixes conflict
400 Bad Request
NotifyRuleSuffixConflict
Notification rule suffixes conflict
400 Bad Request
NotSupportedStorageClass
The specified Storage Class is not supported
400 Bad Request
OAZOperationNotSupportOnMAZBucket
Multi-AZ buckets do not support OAZ operations. For the multi-AZ feature and its use limits, see Overview of Multi-AZ Feature
400 Bad Request
PolicyFull
The number of ACLs and policies exceeds the upper threshold. For more information, please see Specifications and Limits
400 Bad Request
PolicyVersionFull
The number of policy versions exceeds the limit
400 Bad Request
RequestTimeout
The request timed out
400 Bad Request
SsecDecryptHeaderInvalid
The source object is encrypted with SSE-C. Therefore, the same key should be provided in the request header
400 Bad Request
SSEContentNotSupported
The encryption method is not supported
400 Bad Request
SSEHeaderNotAllowed
The operation does not support the specified SSE header
400 Bad Request
TargetBucketNameInvalid
The destination bucket is invalid. For more information, please see Naming Conventions
400 Bad Request
TooManyBuckets
The number of buckets exceeds the upper limit (200)
400 Bad Request
UnexpectedContent
The request does not support the related content
400 Bad Request
UserCnameInvalid
The specified CNAME does not exist or is invalid
400 Bad Request
UserNetworkTooSlow
The network speed is too slow
400 Bad Request
VerifyAlgorithmNotSupported
The verification algorithm is not supported
400 Bad Request
WebsiteURLInvalid
The custom URL is invalid
400 Bad Request
XMLSizeLimit
The length of XML exceeds the limit
402 Payment Required
PaymentRequired
The cost quota is used up
403 Forbidden
AccessDenied
The access is denied due to an incorrect signature or permission. For more information, please see Request Signature and ACL Overview
403 Forbidden
AccessForbidden
The cross-origin resource sharing (CORS) request is denied. Please check whether Origin, Access-Control-Request-Method, and Access-Control-Request-Headers in the request method or request header are in the configured CORS allowlist
403 Forbidden
InvalidAccessKeyId
The SecretID does not exist
403 Forbidden
InvalidObjectState
The storage class and requested operation conflict
403 Forbidden
NoProcessAuthority
You do not have permission to process images
403 Forbidden
RequestTimeTooSkewed
The difference between the local time and server time is more than 15 minutes
403 Forbidden
Request has expired
The signature has expired when you initiate the request, or your system time is out of sync with the time in your time zone. For more information, please see FAQs
403 Forbidden
SignatureDoesNotMatch
The client-calculated signature is inconsistent with that calculated on the COS server. You can refer to Request Signature and use COS's request signature tool to check the signature generation process
403 Forbidden
UserNotSourceBucketOwner
The current user is not the owner of the source bucket
403 Forbidden
UserNotTargetBucketOwner
The current user is not the owner of the destination bucket
404 Not Found
InventoryConfigurationNotFoundError
The list of inventory configurations is not found
404 Not Found
NoBucketQuotaPolicy
The bucket quota policy is not found
404 Not Found
NoSuchBucket
The specified bucket is not found
404 Not Found
NoSuchCopySource
The source object to replicate is not found
404 Not Found
NoSuchCORSConfiguration
The specified CORS configuration is not found
404 Not Found
NoSuchEncryptionConfiguration
The specified bucket encryption configuration is not found
404 Not Found
NoSuchJob
The specified Batch Operation job is not found
404 Not Found
NoSuchKey
The specified object key is not found. You can call HEAD Object to check whether the object exists
404 Not Found
NoSuchLifecycleConfiguration
The specified lifecycle configuration is not found
404 Not Found
NoSuchObjectLockConfiguration
The specified object lock configuration is not found
404 Not Found
NoSuchPolicyVersion
The specified policy version is not found
404 Not Found
NoSuchTagSet
The specified tag set is not found
404 Not Found
NoSuchUpload
The UploadId specified in a multipart upload is not found
404 Not Found
NoSuchVersion
The specified version is not found
404 Not Found
NoSuchWebsiteConfiguration
The specified static website configuration is not found
404 Not Found
OriginConfigurationNotFoundError
The origin-pull configuration is not found
404 Not Found
ReplicationConfigurationNotFoundError
The configuration for cross-region replication is not found
405 Method Not Allowed
MethodNotAllowed
The resource does not support this HTTP method
405 Method Not Allowed
RestoreNonArchiveObject
Non-ARCHIVED objects cannot be restored
405 Method Not Allowed
UploadIdNotSupported
The specified UploadId is generated by a JSON API. Therefore, you cannot operate with an XML API
409 Conflict
AppendPositionErr
The object length does not match position during the append operation
409 Conflict
BucketAlreadyExists
The specified bucket already exists
409 Conflict
BucketAlreadyOwnedByYou
The specified bucket already exists and is owned by the current account
409 Conflict
BucketLocked
The bucket is locked. In this case, cross-region replication and lifecycle are not supported
409 Conflict
BucketNotEmpty
The bucket is not empty
409 Conflict
DomainConfigConflict
The endpoint configurations conflict. Please delete the conflicting records
409 Conflict
InvalidBucketState
The bucket state conflicts with the request. For example, versioning configuration conflicts with cross-region replication
409 Conflict
InvalidLockedTime
The object lock time is invalid
409 Conflict
ObjectLocked
The object is locked. In this case, you cannot overwrite upload or delete the object, or modify the object metadata through copying
409 Conflict
InvalidObjectState
The object state conflicts with the request
409 Conflict
PathConflict
Millisecond-level concurrency conflict occurs for objects with the same name
409 Conflict
QuotaConflict
Quota conflict
409 Conflict
QuotaOperationConflict
The bucket state does not support this operation
409 Conflict
RecordAlreadyExist
The DNS record conflicts. Please delete the conflicting record, or add a CNAME/TXT record
409 Conflict
RestoreAlreadyInProgress
The object is being restored
409 Conflict
UploadConflict
Uploading the same object key too many times causes a conflict
409 ObjectNotAppendable
ObjectNotAppendable
The specified object is not appendable
411 Length Required
MissingContentLength
The Content-Length request header is missing
412 Precondition Failed
PreconditionFailed
The precondition matching failed
416 Requested Range Not Satisfiable
InvalidRange
The requested object range is invalid
451 Unavailable For Legal Reasons
DomainAuditFailed
The domain name does not have an ICP license
451 Unavailable For Legal Reasons
UnavailableForLegalReasons
The service is unavailable. Please check whether your account has overdue payments. If not, check whether there are restricted files by referring to Content Compliance

5xx errors

HTTP Status Code
Error Code
Description
500 Internal Server Error
InternalError
Internal error of the server occurs
500 Internal Server Error
KmsInternalException
KMS internal error occurs
501 Not Implemented
NotImplemented
The request has not been implemented
503 Service Unavailable
KmsFreqControl
The KMS access frequency is too high
503 Service Unavailable
ServiceUnavailable
The service is unavailable. Please retry
503 Service Unavailable
SlowDown
The access frequency should be slowed down

Data processing errors

Image download errors

Error Code
Description
Solution
-103
Invalid request. The request packet cannot be recognized
Check the content of the request
-104
Invalid APPID. The APPID contained in the URL is invalid, or the domain name is not bound to the APPID
Check whether the APPID is correct
-105
Invalid style name. The style name or alias specified in the URL is not set
Check the style configuration or style name
-106
Invalid URL. The URL format is invalid
Check the URL format
-107
Invalid Host header field
Check whether Host is correct
-108
Invalid Referer
Check the Referer configuration
-109
Invalid style name ID. The image corresponding to the style name is not found. This style name may have been added after the image was uploaded, and therefore data corresponding to this style name could not be generated when the image was uploaded
-
-110
The image is on the blocklist
-
-113
The file type is not supported
For the input file types supported by file preview, see Rules and Restrictions
-120
Data returned by the origin server is exceptional during origin-pull, and consequently image data cannot be properly retrieved
Check the data on the origin server
-124
A download offset error has occurred. The setting of Range (checkpoint restart offset) for the HTTP request may be incorrect
Check the checkpoint restart offset setting
-154
Download is prohibited for this URL by the original image protection mechanism
Use style access
-156
Forcible execution of the 302 process
-
-162
Image downloading is not allowed due to overdue payment
Top up your account promptly
-163
The business configuration does not exist
Check related configuration items
-164
The request frequency is too high
Reduce the request frequency or submit a ticket to contact us
-165
Aggressive download requests are restricted
-
-166
The message format is invalid
-
-167
The image file is too large and cannot be downloaded
Reduce the size of the file
-168
The image file is too large and cannot be downloaded
Reduce the size of the file
-441
Unsupported image format. The image cannot be compressed
Use a CI supported image format for image processing. Valid formats: JPG, BMP, GIF, PNG, WEBP
-442
The image size exceeds the limit
Ensure that image dimensions are equal to or less than 9,999 pixels
-443
Unsupported image format
Use a supported image format. For details, see Rules and Restrictions
-447
Image resolution exceeds the limit or the GIF file contains too many frames
Limit image dimensions to 9999 pixels (limit the frame number of GIF files)
-901
Compression timeout
-
-902
Origin-pull times out. Specifically, when the image storage feature forwards a request to the developer's origin server, the timer expires before a response is received
Check the origin server data or origin-pull configuration
-3006
The file is encrypted and cannot be parsed
-
-3008
The file is empty and cannot be parsed
-
-3011
The file type is not supported
For the input file types supported by file preview, see Rules and Restrictions
-3015
The requested page number does not exist
-
-3075
This file exceeds 100 MB and cannot be parsed
Ensure that the file size is equal to or less than 100 MB
-5062
The image may be illegal
Check whether the content of the image is illegal
-6101
The image does not exist, is not uploaded, or has been deleted
Check the source data of the request
-29033
The download request does not contain a valid range
-
-29034
The download offset is greater than the file size
-
-29214
Frequency control is triggered
Reduce the request frequency, or submit a ticket to contact us
-40168
The original image is null
Check the raw data of the request
-46152
The bucket name is invalid
Check whether the bucket name is valid
-46154
The APPID is invalid
Check whether the APPID is valid
-46614
Downloading is not allowed for a file that is being uploaded
Send the download request after the file upload is completed
-46617
An entry on the blocklist is hit
Check whether the content of the image is illegal
-46618
Signature authentication fails
Check whether the signature is correct
-46619
The signature has expired
Update the signature
-46620
The bucket is blocked
Your bucket is blocked. Submit a ticket for further assistance
-46621
The bucket is blocked
Your bucket is blocked. Submit a ticket for further assistance
-46627
The user is currently on the blocklist
Your account is blocked. Submit a ticket for further assistance
-46628
The file does not exist
Check whether the file to be downloaded exists
-46642
The APPID does not exist
Check whether the APPID is correct
-46646
The file is blocked
The file is blocked. Check whether the content of the file is illegal
-46661
No access permission
Contact the resource owner for permission

Image persistence processing errors

Error Code
Description
Solution
-60998
An image processing parameter is invalid
Check whether image processing rules are correct
-60997
The number of image processing rules exceeds the limit
Persistence processing currently supports a maximum of five rules. Therefore, ensure that at most five rules are configured
-60996
The file is too large to process
Ensure that the file size is less than or equal to 32 MB
-60987
Failed to retrieve the image
Check the URL of the image
-60983
Invalid host
Check the host
-60972
Invalid region
Check if the region in the request supports CI. For more information on regions that support CI, see Regions and Domain Names
-60967
The image style does not exist
Check the image style
-60957
The number of used styles exceeds the limit
Currently, a maximum of 100 styles are supported. If you need more styles, submit a ticket to contact us
-60955
Invalid URL
Check whether the URL is correct
-60950
No file is specified
Specify the file to be processed in the request
-60949
The request frequency is too high
Reduce the request frequency. To increase the frequency limit, submit a ticket
-60948
The account is suspected of violation
Your APPID is blocked. Submit a ticket for further assistance
-60938
Incomplete signing information
Check the required items in the signing information
-60936
The request is rejected
Access denied
-60932
Signature error
The signature is invalid. Check whether the signing information matches
-62999
Invalid image format
Check whether the image format is valid

File preview errors

Error Code
Description
Solution
-3006
The file is encrypted
Use a decrypted file
-3008
The file length is 0
Check whether the file is normal
-3011
The file type is not supported
Check whether the file type is supported. For the supported file types, see Rules and Restrictions
-3015
The number of requested page is greater than the total number of document pages
Check whether the number of the requested page is correct

Content moderation errors

Error Code
Description
Solution
-61011
The file does not exist
Check whether the file exists
-65007
File content error. Decoding failed
Check whether the file format is correct
-65010
File download failed
Check whether the file link is correct. For a file with private read permission, the file link must be signed
-65011
The file is too large to process
Currently, an excessively large file cannot be moderated
-65012
The image resolution is too low to process
Currently, images with excessively low resolution are not supported
-65013
The file is not processed because it does not meet requirements (e.g., unsupported file suffix or excessively large size)
Check whether the file meets requirements
-65014
No CI role (CI_QCSRole)
Bind a CI role
-65015
No moderation scenario is used
Use at least one moderation scenario for moderation
-65016
BizType used does not exist
Enter a correct BizType
Other
Internal error
None
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon