Responses
Successful response
If there are no errors, Object Storage returns a 2xx HTTP code. The response code and body are request-specific and given in request descriptions.
Error response
In case of an error, Object Storage returns a message with the relevant HTTP code and its additional description in XML format.
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult
xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<KeyCount>1</KeyCount>
<Name>my-sample-bucket</Name>
<Prefix></Prefix>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>text.txt</Key>
<LastModified>2025-05-15T07:23:08.030Z</LastModified>
<Owner>
<ID>ajegtlf2q28a********</ID>
<DisplayName>ajegtlf2q28a********</DisplayName>
</Owner>
<ETag>"f75a361db63aa4722fb8e083********"</ETag>
<Size>103</Size>
<StorageClass>STANDARD</StorageClass>
<TagSet></TagSet>
</Contents>
</ListBucketResult>
| Tag | Description |
|---|---|
Code |
Error code. You can find a list of codes below. |
Message |
Error description in English. |
RequestId |
ID of the request that resulted in an error. It equals the X-Amz-Request-Id header value. |
Resource |
Bucket or object the error occurred with. |
Error codes
|
HTTP |
Error code |
Description |
|
301 |
|
The specified bucket should always be accessed using the address returned in the response. |
|
307 |
|
The specified bucket should temporarily be accessed using the address returned in the response. |
|
307 |
|
Redirect while the DNS is being updated. |
|
400 |
|
The hash provided in the |
|
400 |
|
After uploading the object, the quota will be exceeded. Request a quota increase or delete the objects you do not need and then upload the object again. |
|
400 |
|
Credentials are not supported. |
|
400 |
|
The size of an object to upload is smaller than the minimum allowed size. |
|
400 |
|
The size of an object to upload is greater than the maximum allowed size. |
|
400 |
|
The token is expired. |
|
400 |
|
The sent data size is smaller than stated in the |
|
400 |
|
The POST method requires exactly one file upload per request. |
|
400 |
|
The request data exceeds the maximum allowed size. |
|
400 |
|
The hash provided in the |
|
400 |
|
The argument is invalid. |
|
400 |
|
The name of the bucket is invalid. |
|
400 |
|
One or more parts of a multipart upload were not found. Make sure the list is correct. The missing parts may not have been uploaded. |
|
400 |
|
The list of parts of a multipart upload is incorrect. The parts must be sorted by number in ascending order. |
|
400 |
|
Use |
|
400 |
|
Attempt to exceed the maximum bucket size. |
|
400 |
|
The storage class is invalid. |
|
400 |
|
The bucket does not exist, or you are not the owner of the bucket, or the log delivery group does not have sufficient permissions. |
|
400 |
|
The token is malformed or otherwise invalid. |
|
400 |
|
Failed to parse the provided URI. |
|
400 |
|
The key is too long. |
|
400 |
|
The provided XML document is malformed or does not match the schema. |
|
400 |
|
The request body does not match the |
|
400 |
|
The provided XML document is malformed or does not match the schema. |
|
400 |
|
The maximum allowed request length is exceeded. |
|
400 |
|
The HTTP message header exceeded the allowed length. |
|
400 |
|
The metadata headers exceed the allowed size. |
|
400 |
|
The request body is empty. |
|
400 |
|
The required header is missing. |
|
400 |
|
There is no logging status for the key. |
|
400 |
|
The request must contain data of the |
|
400 |
|
Read/write timeout. |
|
400 |
|
Refresh your token. |
|
400 |
|
After creating the object, the quota will be exceeded. Request a quota increase or delete the buckets you do not need and then create the bucket again. |
|
400 |
|
There should be no content in the request. |
|
400 |
|
The email address does not match any recorded account. |
|
400 |
|
The request must contain the header specified in the error description. |
|
403 |
|
Access is denied. |
|
403 |
|
There is an account problem preventing successful completion of the operation. |
|
403 |
|
Unknown key. |
|
403 |
|
The request cannot be executed for the current state of the object. |
|
403 |
|
Access to the object is blocked. |
|
403 |
|
The provided secret keys are not valid. |
|
403 |
|
This account is not allowed to use Object Storage. |
|
403 |
|
The difference between the request sending time and the time on the server is too big. |
|
403 |
|
The provided request signature does not match the one calculated by Object Storage. |
|
404 |
|
The specified bucket does not exist. |
|
404 |
|
The specified key does not exist. |
|
404 |
|
The specified multipart upload does not exist. |
|
404 |
|
The specified bucket does not have any tag assigned. |
|
405 |
|
The HTTP method is not allowed for the specified resource. |
|
409 |
|
A bucket with the same name already exists. Choose a different name. |
|
409 |
|
The bucket you are trying to delete is not empty. |
|
409 |
|
The request cannot be executed for the current state of the bucket. |
|
409 |
|
Conflicting conditional operations. |
|
411 |
|
Add |
|
412 |
|
One of the conditions specified in the request is not satisfied. |
|
416 |
|
Invalid range in the |
|
429 |
|
Too many requests to Object Storage. Reduce the request rate. |
|
500 |
|
Internal error in Object Storage. Repeat the request. |
|
501 |
|
The provided header is not processed by Object Storage. |
|
503 |
|
Object Storage is not available. |
|
503 |
|
Reduce your request rate. |