Responses

Successful response

If there are no errors, Object Storage returns HTTP code 2xx. The response code and body depend on the request and are 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

HTTP	Error code	Description
301	PermanentRedirect	The specified bucket should always be accessed using the address returned in the response.
307	Redirect	The specified bucket should temporarily be accessed using the address returned in the response.
307	TemporaryRedirect	Redirect while the DNS is being updated.
400	BadDigest	The hash passed in the Content-MD5 header does not match the one calculated on the Object Storage side.
400	CredentialsNotSupported	Credentials are not supported.
400	EntityTooSmall	The size of an uploaded object is smaller than the minimum allowed.
400	EntityTooLarge	The size of an uploaded object is greater than the maximum allowed.
400	ExpiredToken	The provided token has expired.
400	IncompleteBody	The size of the sent data is smaller than the size indicated in the Content-Length header.
400	IncorrectNumberOfFilesInPostRequest	The POST method requires that only one file is sent.
400	InlineDataTooLarge	Request data exceeds the maximum allowed size.
400	InvalidDigest	The hash passed in the Content-MD5 header is not valid.
400	InvalidArgument	Invalid argument.
400	InvalidBucketName	Unacceptable name of the bucket.
400	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	InvalidPartOrder	The list of multipart upload parts is incorrect. The parts must be sorted by number in ascending order.
400	InvalidRequest	Use AWS4-HMAC-SHA256.
400	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	InvalidStorageClass	Invalid storage class.
400	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	InvalidToken	The token is malformed or otherwise invalid.
400	InvalidURI	Failed to parse the passed URI.
400	KeyTooLongError	The key is too long.
400	MalformedACLError	The provided XML document is malformed or does not conform to the schema.
400	MalformedPOSTRequest	The body of the request does not match the multipart/form-data format.
400	MalformedXML	The provided XML document is malformed or does not conform to the schema.
400	MaxMessageLengthExceeded	The maximum allowed request length is exceeded.
400	MaxPostPreDataLengthExceededError	The HTTP message header has exceeded the allowed length.
400	MetadataTooLarge	The metadata headers exceeded the allowed size.
400	MissingRequestBodyError	The request body is empty. Occurs when sending an empty XML document.
400	MissingSecurityHeader	The required header is missing.
400	NoLoggingStatusForKey	There is no logging status for the key.
400	RequestIsNotMultiPartContent	The request must contain data of the multipart/form-data type.
400	RequestTimeout	Read/write timeout.
400	TokenRefreshRequired	Refresh your token.
400	TooManyBuckets	Exceeded the bucket number limit.
400	UnexpectedContent	The request must not contain this content.
400	UnresolvableGrantByEmailAddress	The email address you provided does not match any recorded account.
400	UserKeyMustBeSpecified	The request must contain the header specified in the error description.
403	AccessDenied	Access is denied.
403	AccountProblem	There is a problem with the account that prevents the operation from completing successfully. Contact the Yandex.Cloud support service.
403	InvalidAccessKeyId	Unknown key.
403	InvalidObjectState	The request cannot be executed for the current state of the object.
403	InvalidPayer	Access to the object is blocked.
403	InvalidSecurity	The provided secret keys are not valid.
403	NotSignedUp	Use of Object Storage is not allowed for this account.
403	RequestTimeTooSkewed	The request sending time is too different from the server time.
403	SignatureDoesNotMatch	The provided request signature does not match the one calculated by Object Storage.
404	NoSuchBucket	The specified bucket does not exist.
404	NoSuchKey	The specified key does not exist.
404	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.
405	MethodNotAllowed	The HTTP method is not allowed for the specified resource.
409	BucketAlreadyExists	A bucket with the same name already exists. Choose a different name.
409	BucketNotEmpty	The bucket you are trying to delete is not empty.
409	InvalidBucketState	The request cannot be executed for the current state of the bucket.
409	OperationAborted	Conflicting conditional operations.
411	MissingContentLength	Add Content-Length to the headers.
412	Precondition Failed	One of the conditions specified in the request is not met.
416	InvalidRange	Invalid range in the Range header.
500	InternalError	Object Storage internal error. Repeat the request.
501	NotImplemented	The passed header is not handled by Object Storage.
503	ServiceUnavailable	Object Storage is not available. Reduce your request rate.
503	SlowDown	Reduce your request rate.