Overview
This section describes the error codes and error information returned when requests fail.
Error Response
Content-Type: application/xml
HTTP status codes are 3XX, 4XX, and 5XX. Specifically, for the PUT Object - Copy API, the response body may contain errors even if 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>
Specific node descriptions are as follows:
| Node Name (Keyword) | Parent Node | Description | Type |
|---|---|---|---|
| Error | No | 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 | ID automatically generated by the server for each request error. The ID can assist COS in locating encountered problems quickly. | string |
Error Code List
3XX Errors
| Error Code | Description | HTTP Status Code |
|---|---|---|
| PermanentRedirect | The resource location is changed permanently. Use the HTTP Location response header to redirect to the correct new location. | 301 Moved Permanently |
| TemporaryRedirect | The resource location is changed temporarily. Use the HTTP Location response header to redirect to the correct new location. | 302 Moved Temporarily |
| Redirect | Temporary redirection is performed. | 307 Moved Temporarily |
| TemporaryRedirect | During the DNS update period, you are temporarily redirected. | 307 Moved Temporarily |
4XX Errors
| Error Code | Description | HTTP Status Code |
|---|---|---|
| AppendPositionErr | The object length does not match position during the append operation. | 400 Bad Request |
| AttachmentFull | The number of ACLs and policies reached the limit. | 400 Bad Request |
| BadDigest | The provided Content-MD5 value is inconsistent with the MD5 hash value in 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 less than the specified minimum value, commonly seen in multipart uploads. | 400 Bad Request |
| IncorrectNumberOfFilesInPostRequest | Only one object can be uploaded at a time in a POST request. | 400 Bad Request |
| InvalidArgument | The request parameter is invalid. | 400 Bad Request |
| InvalidBucketName | The bucket name is invalid. | 400 Bad Request |
| InvalidCopySource | Object source copying is invalid. | 400 Bad Request |
| InvalidDigest | The given Content-MD5 value is invalid. | 400 Bad Request |
| InvalidPart | Parts are missing. | 400 Bad Request |
| InvalidPartOrder | The numbers of parts for the multipart upload are not sequential. | 400 Bad Request |
| InvalidRegionName | The region name is invalid. | 400 Bad Request |
| InvalidRequest | The request is invalid. | 400 Bad Request |
| InvalidSHA1Digest | The request fails the SHA-1 verification. | 400 Bad Request |
| InvalidURI | The URI is invalid. | 400 Bad Request |
| KeyTooLong | The object key is too long. | 400 Bad Request |
| LifeCycleIdNotUnique | The lifecycle ID is not unique. | 400 Bad Request |
| LifeCycleRuleConflicted | Lifecycle setting conflicts exist. | 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 |
| MissingAppid | APPID is missing in the request header. | 400 Bad Request |
| MissingContentMD5 | Content-MD5 is missing in the request header. | 400 Bad Request |
| MissingHost | Host is missing in the request header. | 400 Bad Request |
| MissingRequestBodyError | The request body is missing. | 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 type is not supported. | 400 Bad Request |
| ObjectNotAppendable | The specified object cannot be appended. | 400 Bad Request |
| PolicyFull | The number of ACLs and policies reached the limit. | 400 Bad Request |
| RequestTimeOut | Data reading times out. Check whether the network speed is slow or the upload concurrency is too large. | 400 Bad Request |
| TooManyBuckets | The number of buckets exceeds the upper limit of 200. | 400 Bad Request |
| UnexpectedContent | The request does not support the related content. | 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. | 400 Bad Request |
| AccessDenied | The signature or permission is incorrect, and the access is denied. | 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 | The storage type is invalid. | 403 Forbidden |
| RequestTimeTooSkewed | The difference between the local time and server time is too large, exceeding 15 minutes. | 403 Forbidden |
| SignatureDoesNotMatch | The signature calculated by the client does not match the signature calculated by the COS server. | 403 Forbidden |
| NoSuchBucket | The specified bucket does not exist. | 404 Not Found |
| NoSuchCopySource | The copied object source does not exist. | 404 Not Found |
| NoSuchCORSConfiguration | The specified CORS settings do not exist. | 404 Not Found |
| NoSuchKey | The specified object key does not exist. | 404 Not Found |
| NoSuchLifecycleConfiguration | The specified lifecycle settings do 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 |
| NoSuchWebsiteConfiguration | The static website configuration does not exist. | 404 Not Found |
| MethodNotAllowed | The resource does not support this HTTP method. | 405 Method Not Allowed |
| RestoreNonArchiveObject | Non-ARCHIVED objects cannot be restored. | 405 Method Not Allowed |
| BucketAlreadyExists | The specified bucket already exists. | 409 Conflict |
| BucketAlreadyExistsDiffRegion | The specified bucket already exists in another region. | 409 Conflict |
| BucketAlreadyOwnedByYou | The specified bucket already exists. | 409 Conflict |
| BucketNotEmpty | The bucket is not empty. | 409 Conflict |
| InvalidBucketState | The bucket status conflicts with the operation request, such as conflicts between multi-version management and cross-region replication. | 409 Conflict |
| PathConflict | Millisecond-level concurrency conflict occurs for objects with the same name. | 409 Conflict |
| RestoreAlreadyInProgress | The object is being recovered. | 409 Conflict |
| MissingContentLength | The Content-Length request header is missing. | 411 Length Required |
| PreconditionFailed | Precondition matching failed. | 412 Precondition |
| InvalidRange | The requested object range is invalid. | 416 Requested Range Not Satisfiable |
| UnavailableForLegalReasons | Service is unavailable due to legal reasons. | 451 Unavailable For Legal Reasons |
5XX Errors
| Error Code | Description | HTTP Status Code |
|---|---|---|
| InternalErrror | An internal server error occurs. | 500 Internal Server |
| NotImplemented | The request is not implemented. | 501 Not Implemented |
| ServiceUnavailable | The service is temporarily unavailable. Please try again. | 503 Service Unavailable |
| SlowDown | The access frequency needs to be reduced. | 503 Slow Down |