Overview
This section describes the error codes and error information returned when requests fail.
Error Response
Content-Type:application/xml
This applies to HTTP status codes: 3XX, 4XX, and 5XX. For the PUT Object - Copy API, errors may still 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 Errors
HTTP Status Code | Error Code | Description |
400 Bad Request | ActionAccelerateNotSupported | This operation is not supported for the acceleration domain name. |
400 Bad Request | AttachmentFull | |
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 acceleration domain name is not enabled for this bucket. |
400 Bad Request | BucketNameTooLong | |
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 | |
400 Bad Request | EntityTooLarge | |
400 Bad Request | EntityTooSmall | The uploaded object size is less than the specified minimum, which is common in multipart uploads. For details, 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 has too many frames. |
400 Bad Request | ImageTooLarge | The image size exceeds the limit. |
400 Bad Request | IncompleteBody | |
400 Bad Request | IncorrectNumberOfFilesInPostRequest | A POST Object request allows uploading 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 | |
400 Bad Request | InvalidCopySource | The copy object source is invalid. |
400 Bad Request | InvalidDelimiter | The delimiter (delimiter) parameter is invalid. A delimiter must be a single character. |
400 Bad Request | InvalidDigest | |
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 | |
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 | |
400 Bad Request | InvalidRequest | The request is invalid. |
400 Bad Request | InvalidSHA1Digest | The request fails the SHA-1 verification. |
400 Bad Request | InvalidTag | |
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 upload objects using the JSON API. 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 upper limit for inventory tasks is 1,000. |
400 Bad Request | JsonAPINotSupportOnMAZBucket | The JSON API does not support operations on multi-AZ buckets. Use the XML API instead. |
400 Bad Request | KeyTooLong | |
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 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 be configured with one destination bucket. |
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 | |
400 Bad Request | OAZOperationNotSupportOnMAZBucket | Multi-AZ buckets do not support single-AZ operations. For details about the multi-AZ feature and usage restrictions, see Multi-AZ Feature Overview. The single availability zone operation is not supported by multiple availability zones bucket |
400 Bad Request | PolicyFull | |
400 Bad Request | PolicyVersionFull | The number of Policy versions has reached the limit. |
400 Bad Request | RequestTimeout | Request timeout. |
400 Bad Request | SsecDecryptHeaderInvalid | 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 specified server-side encryption header is not supported for this operation. |
400 Bad Request | TargetBucketNameInvalid | |
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. For more information, see Request Signatures and ACL Overview. |
403 Forbidden | AccessForbidden | The Cross-Origin Resource Sharing (CORS) request has been rejected. Check whether the request method or the Origin, Access-Control-Request-Method, and Access-Control-Request-Headers fields in the request headers are included in the configured CORS allowlist. |
403 Forbidden | DownloadForbidden | Access to apk and ipa files using default domains (including bucket default domain, static website domain, and global acceleration domain) is not allowed. Use custom domain. |
403 Forbidden | InvalidAccessKeyId | The SecretID does not exist. |
403 Forbidden | InvalidObjectState | The COS storage class conflicts with the operation request. |
403 Forbidden | NoProcessAuthority | You do not have permission to process images. |
403 Forbidden | RequestTimeTooSkewed | The local time deviates from the server time by more than 15 minutes. |
403 Forbidden | Request has expired | The request initiation time exceeds the signature's validity period, or the local system time is inconsistent with the time zone. For details, see Common Issues. |
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 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 non-archived objects is not allowed. |
405 Method Not Allowed | UploadIdNotSupported | The specified UploadId is generated by the JSON API and cannot be operated on using the XML API. |
405 AccessTimeNotSupported | AccessTimeNotSupported | Access time is not supported. For more limitations and descriptions, 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, such as 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 copying 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 | Quota conflict. |
409 Conflict | QuotaOperationConflict | The operation is not applicable to the bucket's current state. |
409 Conflict | RecordAlreadyExist | A DNS record conflict exists. 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 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 | |
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 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 check for any non-compliant content via Content Compliance. |
5XX Errors
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 accessing 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
Error Codes for Image Download Processing
Error Code | Description | Handling Measures |
-103 | The request is invalid; the request message cannot be recognized. | Please check the request content. |
-104 | The APPID is invalid. The APPID contained in the URL is invalid, or the domain name is not bound to the APPID. | Please check whether the APPID is correct. |
-105 | The style name is invalid. The style name or alias specified in the URL is not configured. | Please check the style configuration or the style name content. |
-106 | The URL is invalid. The URL format does not meet the format requirements. | Please check the URL format. |
-107 | Invalid Host header field. | Please check whether the Host is correct. |
-108 | Invalid Referer. | Please check the relevant Referer configuration. |
-109 | The style name ID is invalid. The image corresponding to this style name was not 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. | |
-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 resumable download may be set incorrectly. | Please check the configuration related to the resumable download offset. |
-154 | The original image protection mechanism prohibits downloading from this URL. | Please use the style to access. |
-156 | Enforce the 302 process. | - |
-162 | The service is configured as overdue, and image download is prohibited. | Please top up your account promptly. |
-163 | The service configuration does not exist. | Please check the relevant configuration items. |
-164 | Heatmap download is restricted. | |
-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 incompatible and cannot be compressed. | Use 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 requirements. | |
-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 | Compression timed out. | - |
-902 | The origin fetch timed out. The Mirror Storage feature forwarded the request to the developer's origin server but did not receive a response, 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. | |
-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 any regulations. |
-6101 | The image does not exist, has not been uploaded, or has been deleted. | Please check the request source data. |
-29033 | The download request does not contain a valid range. | - |
-29034 | The download offset exceeds the file size. | - |
-29214 | Frequency control has been triggered. | |
-40168 | The original image contains empty 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 yet complete. Download is prohibited. | Please wait until the file upload is successful before making the request. |
-46617 | It has been added to the blocklist. | Please check whether the image content violates any regulations. |
-46618 | Signature verification failed. | Please check whether the signature is accurate. |
-46619 | The signature has expired. | Please update the signature. |
-46620 | The Bucket has been blocked. | |
-46621 | The file has been blocked. | |
-46627 | The user is currently on the blocklist. | |
-46628 | The file does not exist. | Please confirm whether the requested file for download 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. | Contact the resource owner to grant you the permission. |
Error Codes for Image Persistence Processing
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. | Persistence 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 | Failed to obtain the image. | 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, submit a ticket to contact us. |
-60955 | Invalid URL. | Please 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. | 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. | |
-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 | Document type not supported. | 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 scope of a single task generation. |
-3075 | Document size exceeds the limit. | Document resources are limited. 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/request body parsing failed. |
-65003 | InvalidArgument | invalid params | Invalid parameter. |
| | missing Object | Missing value for Object. |
| | invalid DetectType | Invalid DetectType. |
| | Param CallbackVersion is illegal | Invalid CallbackVersion. |
| | No such bucket | The specified bucket does not exist. |
| | The image is empty file | The image content is empty. |
| | Param is illegal | Invalid parameter. |
-65004 | AuditingJobNotFound | JobId not found | The specified 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 | Download file 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. Activate the CI_QCSRole first. (CI role does not exist/is not authorized.) |
-65015 | InvalidArgument | There is not any label opened | No audit policy is in use. 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 | Write to bucket denied |
1145 | QueueNumLimit | Number of created queues exceeds the limit. |