Ответы
Успешный ответ
При отсутствии ошибок Object Storage отвечает HTTP-кодами 2xx. Код и тело ответа зависят от запроса и рассматриваются в описаниях запросов.
Ответ с ошибкой
При возникновении ошибки Object Storage отвечает сообщением с соответствующим HTTP-кодом и дополнительным описанием в формате XML.
<?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>
| Тег | Описание |
|---|---|
Code |
Код ошибки. Перечень кодов смотрите ниже по тексту. |
Message |
Описание ошибки на английском языке. |
RequestId |
Идентификатор запроса вызвавшего ошибку. Равен значению заголовка x-amz-request-id. |
Resource |
Бакет или объект при работе с которым возникла ошибка. |
Коды ошибок
| HTTP | Код ошибки | Описание |
|---|---|---|
| 301 | PermanentRedirect |
К указанному бакету всегда следует обращаться по указанному в ответе адресу. |
| 307 | Redirect |
К указанному бакету временно следует обращаться по указанному в ответе адресу. |
| 307 | TemporaryRedirect |
Редирект на время обновления DNS. |
| 400 | BadDigest |
Хэш переданных в заголовке Content-MD5 не совпадает с вычисленным на стороне Object Storage. |
| 400 | CredentialsNotSupported |
Учетные данные не поддерживаются. |
| 400 | EntityTooSmall |
Загружаемый объект меньше минимально допустимого размера. |
| 400 | EntityTooLarge |
Загружаемый объект больше максимально допустимого. |
| 400 | ExpiredToken |
Срок действия предоставленного токена истек. |
| 400 | IncompleteBody |
Размер отправленных данных меньше, чем указано в заголовке Content-Length. |
| 400 | IncorrectNumberOfFilesInPostRequest |
Метод POST требует передачи строго одного файла. |
| 400 | InlineDataTooLarge |
Данные запроса превышают максимально допустимый размер. |
| 400 | InvalidDigest |
Хэш, переданный в заголовке Content-MD5, не верен. |
| 400 | InvalidArgument |
Недопустимый аргумент. |
| 400 | InvalidBucketName |
Недопустимое имя бакета. |
| 400 | InvalidPart |
Одна и более частей составной загрузки не найдены. Проверьте корректность перечня. Возможно отсутствующие части не были загружены. |
| 400 | InvalidPartOrder |
Перечень частей составной загрузки указан некорректно. Части должны быть отсортированы по возрастанию номера. |
| 400 | InvalidRequest |
Используйте AWS4-HMAC-SHA256. |
| 400 | InvalidRequest |
Попытка превысить максимальный размер бакета. Описание ошибки в ответе: "You have attempted to exceed the max size configured for the bucket." |
| 400 | InvalidStorageClass |
Некорректный класс хранения. |
| 400 | InvalidTargetBucketForLogging |
Бакет не существует или вы не владелец бакета или недостаточно прав у группы доставки логов. |
| 400 | InvalidToken |
Токен неправильно сформирован или некорректен по другой причине. |
| 400 | InvalidURI |
Не получилось разобрать переданный URI. |
| 400 | KeyTooLongError |
Ключ слишком длинный. |
| 400 | MalformedACLError |
Предоставленный XML документ неправильно сформирован или не соответствует схеме. |
| 400 | MalformedPOSTRequest |
Тело запроса не соответствует формату multipart/form-data. |
| 400 | MalformedXML |
Предоставленный XML документ неправильно сформирован или не соответствует схеме. |
| 400 | MaxMessageLengthExceeded |
Превышена допустимая длина запроса. |
| 400 | MaxPostPreDataLengthExceededError |
Заголовок HTTP-сообщения превысил допустимый размер. |
| 400 | MetadataTooLarge |
Размер заголовков метаданных превысил допустимый размер. |
| 400 | MissingRequestBodyError |
Пустое тело запроса. Возникает в случае отправки пустого XML документа. |
| 400 | MissingSecurityHeader |
Отсутствует необходимый заголовок. |
| 400 | NoLoggingStatusForKey |
Отсутствует статус логгирования ключа. |
| 400 | RequestIsNotMultiPartContent |
Запрос должен содержать данные типа multipart/form-data. |
| 400 | RequestTimeout |
Таймаут на чтение/запись. |
| 400 | TokenRefreshRequired |
Обновите токен. |
| 400 | TooManyBuckets |
Превышение лимита на количество бакетов. |
| 400 | UnexpectedContent |
В запросе не должно быть контента. |
| 400 | UnresolvableGrantByEmailAddress |
Не зарегистрированный e-mail. |
| 400 | UserKeyMustBeSpecified |
Запрос должен содержать указанный в описании ошибки заголовок. |
| 403 | AccessDenied |
Доступ запрещен. |
| 403 | AccountProblem |
Проблема с аккаунтом, не позволяющая завершиться операции успешно. Обратитесь в службу поддержки Яндекс.Облака. |
| 403 | InvalidAccessKeyId |
Неизвестный ключ. |
| 403 | InvalidObjectState |
Запрос не может быть выполнен для текущего состояния объекта. |
| 403 | InvalidPayer |
Доступ к объекту заблокирован. |
| 403 | InvalidSecurity |
Предоставленные секретные ключи не валидны. |
| 403 | NotSignedUp |
Для аккаунта не разрешено использование Object Storage. |
| 403 | RequestTimeTooSkewed |
Слишком большая разница между временем отправки запроса и временем на сервере. |
| 403 | SignatureDoesNotMatch |
Предоставленная подпись запроса не соответствует вычисленной Object Storage. |
| 404 | NoSuchBucket |
Указанного бакета не существует. |
| 404 | NoSuchKey |
Указанный ключ не существует. |
| 404 | NoSuchUpload |
Указанной составной загрузки не существует. Ошибка возникает в следующих случаях: - Указан неправильный идентификатор загрузки. - Загрузка прервана. - Загрузка завершена. |
| 405 | MethodNotAllowed |
HTTP-метод не применим к заданному ресурсу. |
| 409 | BucketAlreadyExists |
Бакет с таким названием уже существует, выберите другие имя. |
| 409 | BucketNotEmpty |
Бакет, который вы удаляете, не пустой. |
| 409 | InvalidBucketState |
Запрос не может быть выполнен для текущего состояния бакета. |
| 409 | OperationAborted |
Конфликтующие условные операции. |
| 411 | MissingContentLength |
Добавьте Content-Length в заголовки. |
| 412 | Precondition Failed |
Не выполнено одно из указанных в запросе условий. |
| 416 | InvalidRange |
Неправильный диапазон в заголовке Range. |
| 500 | InternalError |
Внутренняя ошибка Object Storage. Повторите запрос. |
| 501 | NotImplemented |
Переданный заголовок не обрабатывается Object Storage. |
| 503 | ServiceUnavailable |
Object Storage недоступен. Уменьшите частоту ваших запросов. |
| 503 | SlowDown |
Уменьшите частоту ваших запросов. |