tencent cloud

APIs

Error Codes

Unduh
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-06-02 10:55:52

Overview

This section describes the error codes and error information returned when requests fail.

Error Response

Content-Type:application/xml
This section covers HTTP status codes: 3XX, 4XX, and 5XX. For the PUT Object - Copy API, errors may be present in the response body even when the HTTP status code is 200.

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 detailed node descriptions are as follows:
Node Name (Keyword)
Parent Node
Description
Type
Error
None
Contains all error information.
Container
Content of Error in the Container Node:
Node Name (Keyword)
Parent Node
Description
Type
Code
Error
Error code, which is used to locate the unique error condition and determine the error scenario. For specific error codes, see the following section.
string
Message
Error
Detailed error information.
string
Resource
Error
Requested resource, which can be a bucket or object URL.
string
RequestId
Error
ID automatically generated by the server for each request. The ID can assist COS in locating encountered problems quickly.
string
TraceId
Error
When a request fails, the server automatically generates an ID for the error. This ID can be used to help COS locate problems more quickly.
string

Error Code List

4XX Error Codes

HTTP Status Code
Error Code
Description
400 Bad Request
ActionAccelerateNotSupported
This operation is not supported for accelerated domains.
400 Bad Request
AttachmentFull
The number of ACLs and Policies has reached the limit. For details, see Specifications and Limits.
400 Bad Request
BadDigest
The provided Content-MD5 value does not match the MD5 hash of the request body received by the server.
400 Bad Request
BadRequest
Invalid parameter.
400 Bad Request
BucketAccelerateNotEnabled
The bucket does not have an accelerated domain enabled.
400 Bad Request
BucketNameTooLong
The bucket name is too long. For details, see Bucket Naming Conventions.
400 Bad Request
BucketVersionNotOpen
Versioning is not enabled for the bucket.
400 Bad Request
DNSRecordVerifyFailed
DNS record verification failed. Add a CNAME or TXT record. DNS records may take up to 10 minutes to take effect.
400 Bad Request
EntitySizeNotMatch
The request body size does not match the Content-Length header.
400 Bad Request
EntityTooLarge
The uploaded object size exceeds the specified maximum. For details, see Specifications and Limits.
400 Bad Request
EntityTooSmall
The uploaded object size is less than the specified minimum, which commonly occurs in multipart uploads. For details, see Specifications and Limits.
400 Bad Request
ExpiredToken
The temporary Token has expired.
400 Bad Request
ImageResolutionExceed
The image resolution exceeds the limit, or the animated image has too many frames.
400 Bad Request
ImageTooLarge
The image exceeds the size limit.
400 Bad Request
IncompleteBody
The request body size is less than the Content-Length header.
400 Bad Request
IncorrectNumberOfFilesInPostRequest
A POST Object request can upload only one object at a time.
400 Bad Request
InvalidArgument
The request parameter is invalid. Confirm whether this request parameter is allowed.
400 Bad Request
InvalidBucketName
The bucket name is invalid. For details, see the bucket Naming Conventions.
400 Bad Request
InvalidCopySource
The copy source object is invalid.
400 Bad Request
InvalidDelimiter
The delimiter (delimiter) parameter is invalid. The delimiter must be a single character.
400 Bad Request
InvalidDigest
The provided Content-MD5 value 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 details, see the Object Key.
400 Bad Request
InvalidPart
Parts are missing.
400 Bad Request
InvalidPartOrder
The part numbers are not consecutive.
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 region name is invalid. For details, see Regions and Access Domains.
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 details, see Bucket Tag Overview.
400 Bad Request
InvalidTargetBucketForLogging
The target bucket for storing logs is invalid. The target bucket must be in the same region as the current bucket.
400 Bad Request
InvalidUploadStatus
When versioning is enabled, you cannot use the JSON API to upload objects. Use the XML API instead.
400 Bad Request
InvalidURI
The URI is invalid.
400 Bad Request
InventoryFull
The number of inventory tasks has reached the limit. The inventory task limit is 1000.
400 Bad Request
JsonAPINotSupportOnMAZBucket
The JSON API does not support operations on multi-AZ buckets. Use the XML API instead.
400 Bad Request
KeyTooLong
The object key is too long. For details, see the Object Key.
400 Bad Request
KmsException
Key Management Service exception.
400 Bad Request
KmsKeyDisabled
The provided key has been disabled.
400 Bad Request
KmsKeyNotExist
The provided key does not exist.
400 Bad Request
ListPartUploadIdIsEmpty
The UploadId is empty.
400 Bad Request
LoggingConfExists
The log configuration already exists.
400 Bad Request
LoggingPrefixInvalid
The log prefix parameter is invalid.
400 Bad Request
MalformedPolicy
The policy format is invalid.
400 Bad Request
MalformedPOSTRequest
The body content of the POST request is invalid.
400 Bad Request
MalformedXML
The XML format of the request body does not comply with the XML syntax.
400 Bad Request
MAZOperationNotSupportOnOAZBucket
Single-AZ buckets do not support multi-AZ operations. For details about the multi-AZ feature and its usage restrictions, see Multi-AZ Feature Overview.
The multiple availability zones operation is not supported by single availability zone bucket
400 Bad Request
MissingRequestBodyError
The request body is missing.
400 Bad Request
MultiAZFeatureNotSupport
The current region does not support multi-AZ.
400 Bad Request
MultiBucketNotSupport
Cross-region replication can only have one destination bucket configured.
400 Bad Request
NotifyRuleEventConflict
Notification rule Event conflict.
400 Bad Request
NotifyRulePrefixConflict
Notification rule Prefix conflict.
400 Bad Request
NotifyRuleSuffixConflict
Notification rule Suffix conflict.
400 Bad Request
NotSupportedStorageClass
The specified storage type is not supported.
400 Bad Request
OAZOperationNotSupportOnMAZBucket
Multi-AZ buckets do not support single-AZ operations. For details about the multi-AZ feature and its usage restrictions, see Multi-AZ Feature Overview.
The single availability zone operation is not supported by multiple availability zones bucket
400 Bad Request
PolicyFull
The number of ACLs and Policies has reached the limit. For details, see Specifications and Limits.
400 Bad Request
PolicyVersionFull
The number of Policy versions has reached the limit.
400 Bad Request
RequestTimeout
Request timeout.
400 Bad Request
SsecDecryptHeaderInvalid
If the source file is encrypted with SSE-C, you must provide the same key 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 server-side encryption header.
400 Bad Request
TargetBucketNameInvalid
The target bucket name is invalid. For details, see the bucket Naming Conventions.
400 Bad Request
TooManyBuckets
The number of buckets has reached the limit of 200.
400 Bad Request
UnexpectedContent
The request does not support the related content.
400 Bad Request
UserCnameInvalid
The CNAME specified by the user does not exist or is invalid.
400 Bad Request
UserNetworkTooSlow
The user's network speed is too slow.
400 Bad Request
VerifyAlgorithmNotSupported
The verification algorithm is not supported.
400 Bad Request
WebsiteURLInvalid
The custom domain name URL is invalid.
400 Bad Request
XMLSizeLimit
The XML length exceeds the limit.
402 Payment Required
PaymentRequired
The cost quota limit has been exceeded.
403 Forbidden
AccessDenied
Access is denied due to an incorrect signature or insufficient permissions. See Request Signatures and ACL Overview.
403 Forbidden
AccessForbidden
The Cross-Origin Resource Sharing (CORS) request was rejected. Check whether the request method or the Origin, Access-Control-Request-Method, and Access-Control-Request-Headers in the request headers are included in the configured CORS allowlist.
403 Forbidden
DownloadForbidden
Access to .apk and .ipa files using default domain names (including bucket default domain names, static website domain names, and global acceleration domain names) is not allowed. Use a custom domain name instead.
403 Forbidden
InvalidAccessKeyId
The SecretID does not exist.
403 Forbidden
InvalidObjectState
The COS storage type conflicts with the operation request.
403 Forbidden
NoProcessAuthority
You do not have permission to process images.
403 Forbidden
RequestTimeTooSkewed
The local time differs too much from the server time, exceeding 15 minutes.
403 Forbidden
Request has expired
The request initiation time exceeds the signature validity period, or the local system time is inconsistent with the time of the time zone. For details, see FAQs.
403 Forbidden
SignatureDoesNotMatch
The signature calculated by the client does not match the signature calculated by the COS server. Refer to the Request Signatures documentation and use the COS Request Signature Tool to check your own signature implementation 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 target bucket.
404 Not Found
InventoryConfigurationNotFoundError
The inventory configuration was not found.
404 Not Found
NoBucketQuotaPolicy
The bucket quota policy does not exist.
404 Not Found
NoSuchBucket
The specified bucket does not exist.
404 Not Found
NoSuchCopySource
The copied object source does not exist.
404 Not Found
NoSuchCORSConfiguration
The specified cross-origin resource sharing (CORS) configuration does not exist.
404 Not Found
NoSuchEncryptionConfiguration
The specified bucket encryption configuration does not exist.
404 Not Found
NoSuchJob
The specified batch processing task does not exist.
404 Not Found
NoSuchKey
The specified object key does not exist. To check whether the object exists, use the HEAD Object API.
404 Not Found
NoSuchLifecycleConfiguration
The specified lifecycle configuration does not exist.
404 Not Found
NoSuchObjectLockConfiguration
The specified object lock configuration does not exist.
404 Not Found
NoSuchPolicyVersion
The specified policy version does not exist.
404 Not Found
NoSuchTagSet
The specified tag collection does not exist.
404 Not Found
NoSuchUpload
The specified UploadId for multipart upload does not exist.
404 Not Found
NoSuchVersion
The specified version does not exist.
404 Not Found
NoSuchWebsiteConfiguration
The specified static website configuration does not exist.
404 Not Found
OriginConfigurationNotFoundError
The origin configuration was not found.
404 Not Found
ReplicationConfigurationNotFoundError
The cross-region replication configuration was not found.
405 Method Not Allowed
MethodNotAllowed
The resource does not support this HTTP method.
405 Method Not Allowed
RestoreNonArchiveObject
Restoring (thawing) non-archived objects is not allowed.
405 Method Not Allowed
UploadIdNotSupported
The specified UploadId was generated by the JSON API and cannot be operated on using the XML API.
405 AccessTimeNotSupported
AccessTimeNotSupported
Access time is not supported. For more restrictions and details, see Lifecycle Rules Based on Access Time.
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 was created by the current account.
409 Conflict
BucketLocked
The bucket is locked, so cross-region replication or lifecycle operations cannot be performed.
409 Conflict
BucketNotEmpty
The bucket is not empty.
409 Conflict
DomainConfigConflict
A domain name configuration conflict exists. Please delete the conflicting records.
409 Conflict
InvalidBucketState
The bucket status conflicts with the operation request, for example, a conflict between versioning management and cross-region replication.
409 Conflict
InvalidLockedTime
The object lock time is invalid.
409 Conflict
ObjectLocked
The object is locked. Overwriting, deleting, or modifying its metadata via copy operations is not allowed.
409 Conflict
InvalidObjectState
The object status conflicts with the operation request.
409 Conflict
PathConflict
Millisecond-level concurrency conflict occurs for objects with the same name.
409 Conflict
QuotaConflict
A quota conflict exists.
409 Conflict
QuotaOperationConflict
The bucket's current state is not applicable to this operation.
409 Conflict
RecordAlreadyExist
A DNS record conflict is detected. Please delete the conflicting records or add CNAME/TXT records.
409 Conflict
RestoreAlreadyInProgress
The object is being restored.
409 Conflict
UploadConflict
Frequent uploads to the same object key can cause conflicts.
409 Conflict
FileAlreadyExists
When an object is uploaded with the x-cos-forbid-overwrite:true header, if the object already exists, COS rejects the overwrite request and returns an error.
409 ObjectNotAppendable
ObjectNotAppendable
The specified object cannot be appended.
411 Length Required
MissingContentLength
The Content-Length request header is missing.
412 Precondition Failed
PreconditionFailed
Preconditions do not match.
416 Requested Range Not Satisfiable
InvalidRange
The requested object range is invalid.
424
Failed Dependency
MirrorFailed
The mirror source site returns 403.
451 Unavailable For Legal Reasons
DomainAuditFailed
The domain name is not registered.
451 Unavailable For Legal Reasons
UnavailableForLegalReasons
The service is currently unavailable. Please check whether your account has overdue payments. If there are no overdue payments, you can use Content Compliance to check for any non-compliant content.

5XX Error Codes

HTTP Status Code
Error Code
Description
500 Internal Server Error
InternalError
An internal server error occurs.
500 Internal Server Error
KmsInternalException
An internal server error occurred while querying the Key Management Service.
501 Not Implemented
NotImplemented
The request is not implemented.
503 Service Unavailable
KmsFreqControl
Please reduce the request frequency for using the Key Management Service.
503 Service Unavailable
ServiceUnavailable
The service is temporarily unavailable. Please try again.
503 Service Unavailable
SlowDown
Traffic control is triggered when the access bandwidth exceeds the threshold. Error message: Connection refused due to traffic overload.
Frequency control is triggered when the access frequency exceeds the threshold. Error message: Message: Reduce your request rate.

Data Processing Error Codes

Image Download Processing Error Codes

Error Code
Description
Handling Measures
-103
Invalid request. The request message cannot be recognized.
Please check the request content.
-104
Invalid APPID. The APPID in the URL is invalid, or the domain name is not bound to the APPID.
Please check whether the APPID is correct.
-105
Invalid style name. The style name or alias specified in the URL is not configured.
Please check the style configuration or the style name content.
-106
Invalid URL. The URL format does not meet the required specifications.
Please check the URL format.
-107
Invalid Host header.
Please check whether the Host is correct.
-108
Invalid Referer.
Please check the relevant Referer configuration.
-109
Invalid style name ID. No image corresponding to this style name was found. This may be because the style name was added after the image was uploaded, so the data corresponding to this style name could not be generated during the image upload.
-
-110
The image is on the blocklist.
-
-113
The document type is not supported.
For the input file types currently supported by document preview, see Rules and Restrictions.
-120
When data is fetched from the origin server, the data returned by the origin server is abnormal, and the image data cannot be obtained normally.
Please check the origin server data.
-124
Download offset error. The Range header offset for HTTP request resumption may be set incorrectly.
Please check the configuration related to the resumption offset.
-154
The original image protection mechanism prohibits downloading from this URL.
Please use a style to access.
-156
Force the execution of the 302 process.
-
-162
Image download is prohibited when the service is configured with an overdue payment status.
Please top up your account promptly.
-163
The service configuration does not exist.
Please check the relevant configuration items.
-164
Heatmap download is restricted.
Please reduce the request frequency, or submit a ticket to contact us for assistance.
-165
Aggressive download requests are restricted.
-
-166
The message format is incorrect.
-
-167
The file is too large to support image download.
Please reduce the image size.
-168
The file is too large to support image download.
Please reduce the image size.
-441
The image format is invalid and cannot be compressed.
Use the image formats supported by CI for Image Processing operations. The supported formats are jpg, bmp, gif, png, and webp.
-442
The image exceeds the size limit.
Limit the image dimensions to within 9999 pixels.
-443
The image format does not meet the processing restrictions.
Use supported image formats for processing. For details, see Rules and Restrictions.
-447
The image resolution exceeds the limit, or the animated image has too many frames.
Limit the image dimensions to within 9999 pixels. For animated images, limit the number of frames.
-901
The compression timed out.
-
-902
The origin fetch timed out. The Mirror Storage feature forwarded the request to the developer's origin server, but no response was received, resulting in a timeout.
Please check the origin server data or the origin fetch configuration.
-3006
The document is encrypted and cannot be parsed.
-
-3008
The file is empty and cannot be parsed.
-
-3011
The document type is not supported.
For the input file types currently supported by document preview, see Rules and Restrictions.
-3015
The requested page number does not exist.
-
-3075
The document exceeds 100 MB and cannot be parsed.
The input file size must be limited to within 100 MB.
-5062
The image is suspected of containing prohibited content.
Please check whether the image content violates the rules.
-6101
The image does not exist, has not been uploaded, or has been deleted.
Please check the request source data.
-29033
The download request contains no valid range.
-
-29034
The download offset exceeds the file size.
-
-29214
Frequency control is triggered.
Please reduce the request frequency, or submit a ticket to contact us for assistance.
-40168
The original image contains no data.
Please check the request source data.
-46152
Invalid bucketName.
Please check whether the bucket name is correct.
-46154
Invalid APPID.
Please check whether the APPID is correct.
-46614
The file upload is not complete. Download is prohibited.
Please wait until the file upload is complete before making the request.
-46617
It has been matched against the blocklist.
Please check whether the image content violates the rules.
-46618
Signature verification failed.
Please check whether the signature is accurate.
-46619
The signature has expired.
Please update the signature.
-46620
The Bucket is blocked.
Your Bucket has been blocked. Please submit a ticket to contact us for resolution.
-46621
The file is blocked.
Your resource has been blocked. Please submit a ticket to contact us for resolution.
-46627
The user is currently on the blocklist.
Your account has been blocked. Please submit a ticket to contact us for resolution.
-46628
The file does not exist.
Please confirm whether the requested file actually exists.
-46642
The APPID does not exist.
Please check whether the APPID is correct.
-46646
The file has been blocked.
The file has been blocked. Please check whether the file content violates any policies.
-46661
Access denied.
Please contact the resource owner to grant permissions.

Image Persistence Processing Error Codes

Error Code
Description
Handling Measures
-60998
The Image Processing parameters are invalid.
Please check whether the Image Processing rules are correct.
-60997
There are too many Image Processing rules.
Persistent processing currently supports a maximum of five rules. Please keep the number of rules within five.
-60996
The file is too large to be processed.
Keep the file size within 32 MB.
-60987
The image failed to be obtained.
Please check the image URL.
-60983
Invalid Host.
Please check the Host.
-60972
Invalid region.
Check whether the requested region supports CI. For the existing CI regions, see Regions and Domains.
-60967
The image style does not exist.
Please check the image style.
-60957
The number of styles exceeds the limit.
The current limit for the number of styles is 100. If you need more styles, please submit a ticket to contact us.
-60955
Invalid URL.
Please check whether the URL is correct.
-60950
No file is specified.
Please specify the file to be processed in the request.
-60949
The request frequency is too high.
Please reduce the request frequency. If needed, submit a ticket to contact us for raising the frequency limit.
-60948
The account is suspected of violating the rules.
Your APPID has been blocked. Please submit a ticket to contact us for resolution.
-60938
The signature information is incomplete.
Please check the required fields in the signature information.
-60936
The request is rejected.
AccessDenied.
-60932
The signature is incorrect.
The signature is invalid. Please check whether the signature information matches.
-62999
The image format is invalid.
Please check whether the image format is correct.

Document Preview Error Codes

Error Code
Description
Handling Measures
-3006
Encrypted document.
Use a decrypted document.
-3008
Document length is zero.
Please confirm whether the document is normal.
-3011
Unsupported document type
Confirm whether the document is within the supported scope. For details on supported document types, see Rules and Restrictions.
-3064
File parsing failed.
Document parsing failed. Check whether the resource is corrupted.
-3070
File processing timeout failure
Task processing timed out and failed. Adjust the single-task generation scope.
-3075
Document size exceeds the limit.
Document resources are restricted. Adjust the document size.

Content Moderation Error Codes

Error Code
Error Code
Error Message
Description
-65001
InternalError
internal error, please try again.
Internal error.
-65002
InvalidArgument
invalid params
Parameter/Message body parsing failed.
-65003
InvalidArgument
invalid params
Invalid parameter.
missing Object
Missing value for Object.
invalid DetectType
Incorrect DetectType value.
Param CallbackVersion is illegal
Incorrect CallbackVersion parameter value.
No such bucket
The bucket does not exist.
The image is empty file
The image content is empty.
Param is illegal
Incorrect parameter value.
-65004
AuditingJobNotFound
JobId not found
The job does not exist.
-65006
SlowDown
RequestLimitExceeded
Request frequency is too high.
-65007
ResourceNotSupported
Decode file failed
File decoding failed. Check whether the file is corrupted.
-65010
InvalidArgument
Download file failed
File download failed. Check whether the file is corrupted.
url unreachable
-65011
InvalidArgument
File is too large
The file is too large and cannot be audited.
File is too large or empty
ImageTooLarge
Input image's size exceeded limit
The image is too large and cannot be audited.
-65012
InvalidArgument
Resolution is too small
The image resolution is too low and cannot be audited.
-65014
CIRoleNotExist
No permission for CI_QCSRole
Audit failed. Enable the CI role first. (The CI role does not exist/is not authorized.)
-65015
InvalidArgument
There is not any label opened
No audit policy is used. Add an audit policy and try again.
-65016
InvalidArgument
The bizType provided does not exist
The provided BizType does not exist. Check and try again.
-65019
AccessDenied
No permission to do this
Authentication failed. No passrole permission.
-65020
ResourceNotFound
The file does not exist
The file does not exist.
No such key
No such object
-65023
InvalidArgument
File size is too small
The file size is too small.
-65024
InvalidArgument
Image aspect ratio is too large
The image aspect ratio is too large.
ImageTooLarge
Input image's width or height exceeded limit
The image width or height exceeds the limit.

MPS Error Codes

Error Code
Error Message
Description
1007
InternalError
Internal error.
1010
InvalidUrl
Invalid url
1011
InvalidContent
Invalid request body
1012
MissingAuthorization
Missing signature
1013
InvalidAuthorization
Invalid signature
1014
SignatureExpired
Signature expired.
1015
InvalidArgument
Invalid parameter
1016
MissingContent
Missing request body
1017
InvalidHost
Invalid host
1018
AccessDenied
Access denied
1019
SecretidNotExist
Key does not exist
1020
SlowDown
Rate limiting
1021
InvalidContentType
Invalid request body type.
1100
BucketAlreadyBinded
Bucket already bound.
1103
ResourceNotFound
Resource not found.
1106
QueueNotFound
Queue not found.
1107
TemplateNotFound
Template not found.
1109
BindedBucketNumLimit
Number of bound buckets exceeds the limit.
1110
CreatedTemplateNumLimit
Number of created templates exceeds the limit.
1111
MediaBucketUnBinded
Bucket not bound.
1112
TemplateNameDuplicate
Duplicate template name
1114
ActiveWorkflowForbiddenUpdate
Active workflows cannot be updated.
1120
WorkFlowNumLimit
Number of created workflows exceeds the limit.
1124
WriteTargetBucketDenied
Writing to bucket is prohibited.
1145
QueueNumLimit
Number of created queues exceeds the limit.

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan