Подключиться
Yandex Object Storage

Ответы

Успешный ответ

При отсутствии ошибок 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 Проблема с аккаунтом, не позволяющая завершиться операции успешно.

Обратитесь в службу поддержки Yandex.Cloud.
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.
429 TooManyRequests Слишком много запросов к Object Storage. Снизьте частоту обращений.
500 InternalError Внутренняя ошибка Object Storage. Повторите запрос.
501 NotImplemented Переданный заголовок не обрабатывается Object Storage.
503 ServiceUnavailable Object Storage недоступен.
Уменьшите частоту ваших запросов.
503 SlowDown Уменьшите частоту ваших запросов.
В этой статье: