Responses

Successful response

If there are no errors, Yandex Object Storage returns HTTP code 200. The response body depends on the request and is given in the request descriptions.

Error response

In case of an error, Object Storage returns a message with the appropriate HTTP code and its additional description in XML format.

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchKey</Code>
  <Message>The resource you requested does not exist</Message>
  <Resource>/mybucket/myfoto.jpg</Resource> 
  <RequestId>4442587FB7D0A2F9</RequestId>
</Error>
Tag Description
Code Error code.

A list of codes is given below.
Message Error description in English.
RequestId ID of the request that caused the error.

Equal to the value of the x-amz-request-id header.
Resource The bucket or object the error occurred with.

Error codes

Code Description HTTP code
AccessDenied Access is denied. 403 Forbidden
AccountProblem There is a problem with the account that prevents the operation from completing successfully.

Contact the Yandex.Cloud support service.
403 Forbidden
BadDigest The hash passed in the Content-MD5 header does not match the one calculated on the Object Storage side. 400 Bad Request
BucketAlreadyExists A bucket with the same name already exists. Choose a different name. 409 Conflict
BucketNotEmpty The bucket you are trying to delete is not empty. 409 Conflict
CredentialsNotSupported Credentials are not supported. 400 Bad Request
EntityTooSmall The size of an uploaded object is smaller than the minimum allowed. 400 Bad Request
EntityTooLarge The size of an uploaded object is greater than the maximum allowed. 400 Bad Request
ExpiredToken The provided token has expired. 400 Bad Request
IncompleteBody The size of the sent data is smaller than the size indicated in the Content-Length header. 400 Bad Request
IncorrectNumberOfFilesInPostRequest The POST method requires that only one file is sent. 400 Bad Request
InlineDataTooLarge Request data exceeds the maximum allowed size. 400 Bad Request
InternalError Object Storage internal error. Repeat the request. 500 Internal Server Error
InvalidAccessKeyId Unknown key. 403 Forbidden
InvalidArgument Invalid argument. 400 Bad Request
InvalidBucketName Invalid bucket name. 400 Bad Request
InvalidBucketState The request cannot be executed for the current state of the bucket. 409 Conflict
InvalidDigest The hash passed in the Content-MD5 header is not valid. 400 Bad Request
InvalidObjectState The request cannot be executed for the current state of the object. 403 Forbidden
InvalidPart One or more parts of multipart upload not found. Check whether the list is correct. The missing parts may not have been uploaded. 400 Bad Request
InvalidPartOrder The list of multipart upload parts is incorrect. The parts must be sorted by number in ascending order. 400 Bad Request
InvalidPayer Access to the object is blocked. 403 Forbidden
InvalidRange Invalid range in the Range header. 416 Requested Range Not Satisfiable
InvalidRequest Use AWS4-HMAC-SHA256. 400 Bad Request
InvalidRequest Attempt to exceed the maximum bucket size.

Error description in the response:

You have attempted to exceed the max size configured for the bucket.
400 Bad Request
InvalidSecurity The provided secret keys are not valid. 403 Forbidden
InvalidStorageClass Invalid storage class. 400 Bad Request
InvalidTargetBucketForLogging 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 Bad Request
InvalidToken The token is malformed or otherwise invalid. 400 Bad Request
InvalidURI Failed to parse the passed URI. 400 Bad Request
KeyTooLongError The key is too long. 400 Bad Request
MalformedACLError The provided XML document is malformed or does not conform to the schema. 400 Bad Request
MalformedPOSTRequest The body of the request does not match the multipart/form-data format. 400 Bad Request
MalformedXML The provided XML document is malformed or does not conform to the schema. 400 Bad Request
MaxMessageLengthExceeded The maximum allowed request length is exceeded. 400 Bad Request
MaxPostPreDataLengthExceededError The HTTP message header has exceeded the allowed length. 400 Bad Request
MetadataTooLarge The metadata headers exceeded the allowed size. 400 Bad Request
MethodNotAllowed The HTTP method is not allowed for the specified resource. 405 Method Not Allowed
MissingContentLength Add Content-Length to the headers. 411 Length Required
MissingRequestBodyError The request body is empty.

Occurs when sending an empty XML document.
400 Bad Request
MissingSecurityHeader The required header is missing. 400 Bad Request
NoLoggingStatusForKey There is no logging status for the key. 400 Bad Request
NoSuchBucket The specified bucket does not exist. 404 Not Found
NoSuchKey The specified key does not exist. 404 Not Found
NoSuchUpload The specified multipart upload does not exist.

This error occurs in the following cases:
- Invalid upload ID is specified.
- Upload is aborted.
- Upload is complete.
404 Not Found
NotImplemented The passed header is not handled by Object Storage. 501 Not Implemented
NotSignedUp Use of Object Storage is not allowed for this account. 403 Forbidden
OperationAborted Conflicting conditional operations. 409 Conflict
PermanentRedirect The specified bucket should always be accessed using the address returned in the response. 301 Moved Permanently
Redirect The specified bucket should temporarily be accessed using the address returned in the response. 307 Moved Temporarily
RequestIsNotMultiPartContent The request must contain data of the multipart/form-data type. 400 Bad Request
RequestTimeout Read/write timeout. 400 Bad Request
RequestTimeTooSkewed The request sending time is too different from the server time. 403 Forbidden
SignatureDoesNotMatch The provided request signature does not match the one calculated by Object Storage. 403 Forbidden
ServiceUnavailable Object Storage is not available.
Reduce your request rate.
503 Service Unavailable
SlowDown Reduce your request rate. 503 Slow Down
TemporaryRedirect Redirect while the DNS is being updated. 307 Moved Temporarily
TokenRefreshRequired Refresh your token. 400 Bad Request
TooManyBuckets Exceeded the bucket number limit. 400 Bad Request
UnexpectedContent The request must not contain this content. 400 Bad Request
UnresolvableGrantByEmailAddress The email address you provided does not match any recorded account. 400 Bad Request
UserKeyMustBeSpecified The request must contain the header specified in the error description. 400 Bad Request