Ошибка при получении значения из временного хранилища из-за неправильного пути к файлу

Обновлено: 21.11.2024

В этом разделе содержится справочная информация об ошибках Amazon S3.

Темы

Ответы на ошибки REST

При возникновении ошибки информация в заголовке содержит следующее:

Тело ответа также содержит информацию об ошибке. В следующем образце ответа об ошибке показана структура элементов ответа, общих для всех ответов об ошибках REST.

В следующей таблице объясняются элементы ответа на ошибку REST.

Код ошибки – это строка, однозначно идентифицирующая состояние ошибки. Он предназначен для чтения и понимания программами, которые обнаруживают и обрабатывают ошибки по типу. Дополнительные сведения см. в разделе Список кодов ошибок.

Контейнер для всех элементов ошибок.

Сообщение об ошибке содержит общее описание состояния ошибки на английском языке. Он предназначен для человеческой аудитории. Простые программы отображают сообщение непосредственно конечному пользователю, если он сталкивается с ошибкой, которую не знает, как или не хочет обрабатывать. Сложные программы с более исчерпывающей обработкой ошибок и правильной интернационализацией с большей вероятностью проигнорируют сообщение об ошибке.

Идентификатор запроса, связанного с ошибкой.

Корзина или объект, вызвавший ошибку.

Многие ответы об ошибках содержат дополнительные структурированные данные, предназначенные для прочтения и понимания разработчиком, выполняющим диагностику программных ошибок. Например, если вы отправляете заголовок Content-MD5 с запросом REST PUT, который не соответствует дайджесту, рассчитанному на сервере, вы получаете ошибку BadDigest. Ответ об ошибке также включает в качестве элементов сведений дайджест, рассчитанный сервером, и дайджест, который вы сказали серверу ожидать. Во время разработки вы можете использовать эту информацию для диагностики ошибки. В рабочей среде хорошо работающая программа может включить эту информацию в свой журнал ошибок.

Информацию об общих элементах ответа см. в разделе "Ответы об ошибках".

Список кодов ошибок

В следующей таблице перечислены коды ошибок Amazon S3.

Для Amazon S3 на Outposts корзина, которую вы пытались создать, уже существует в вашей Outpost и принадлежит вам.

409 Конфликт (во всех регионах, кроме us-east-1)

Эта ошибка может возникнуть по следующим причинам:

Указанный аргумент недействителен.

В запросе отсутствовал обязательный заголовок.

Указанный аргумент был неполным или имел неверный формат.

Указанный аргумент должен иметь длину больше или равную 3.

Эта ошибка может возникнуть по следующим причинам:

В запросе используется неправильная версия подписи. Используйте AWS4-HMAC-SHA256 (версия подписи 4).

Точку доступа можно создать только для существующего сегмента.

Точка доступа не может быть удалена.

Точка доступа может быть указана только для существующего сегмента.

Следующий токен недействителен.

В правиле жизненного цикла должно быть указано хотя бы одно действие.

Необходимо указать хотя бы одно правило жизненного цикла.

Количество правил жизненного цикла не должно превышать разрешенного предела в 1000 правил.

Недопустимый диапазон параметра MaxResults.

Amazon S3 Transfer Acceleration не поддерживается для корзин с именами, несовместимыми с DNS.

Amazon S3 Transfer Acceleration не поддерживается для сегментов с точками (.) в именах.

Конечная точка Amazon S3 Transfer Acceleration поддерживает только запросы виртуального стиля.

Ускорение передачи Amazon S3 не настроено для этого сегмента.

Ускорение передачи Amazon S3 отключено в этом сегменте.

Ускорение передачи Amazon S3 не поддерживается в этом сегменте. Для получения помощи обратитесь в службу поддержки AWS .

Ускорение передачи Amazon S3 нельзя включить для этого сегмента. Для получения помощи обратитесь в службу поддержки AWS .

Указанный тег не существует.

Список кодов ошибок содержимого объекта SELECT

В следующей таблице приведены специальные ошибки, которые может возвращать SELECT Object Content. Общие сведения об ошибках Amazon S3 и список кодов ошибок см. в разделе Ответы на ошибки.

Список кодов ошибок, связанных с репликацией

В следующей таблице приведены специальные ошибки, которые может возвращать операция репликации. Общие сведения об ошибках Amazon S3 и список кодов ошибок см. в разделе Ответы на ошибки.

Varnish, программное обеспечение, на котором работает Fastly CDN, иногда возвращает стандартные ответы 503 из-за различных проблем, которые могут возникнуть при попытке получить данные с исходных серверов. Общий текст состояния, связанный с ошибкой 503, — «Служба недоступна». Это может означать самые разные вещи. Наиболее распространенные причины, по которым появляется этот общий текст, включают:

  1. Исходный сервер сгенерировал ошибку 503 и Fastly передал ее как есть.
  2. Источник вернул ошибку 503 без заголовка ответа, поэтому Fastly использовал ответ по умолчанию.
  3. Строка состояния ответа HTTP от источника не поддается синтаксическому анализу.
  4. Был запущен код VCL, в котором использовалась инструкция "ошибка" без соответствующего статуса ответа (например, ошибка 503 вместо ошибки 503 "сломанная вещь").

В следующем списке представлены наиболее распространенные нестандартные стандартизированные ответы 503 и основные пояснения к каждому из них.

Если вы видите ошибку 503, не удаляйте весь кешированный контент. Очистить все переопределяет stale-if-error и увеличивает количество запросов к исходному серверу, что может привести к дополнительным ошибкам 503.

Ошибки тайм-аута

Ниже описаны типичные ошибки тайм-аута, с которыми вы можете столкнуться.

Ошибка 503: ошибка чтения серверной части

Эта ошибка обычно появляется, если возникает ошибка тайм-аута, когда серверы Fastly cache пытаются получить контент из ваших источников. Это также может быть связано с различными временными сетевыми проблемами, которые могут привести к сбою чтения (например, отработка отказа маршрутизатора, потеря пакетов) или перегрузке источника.

Сравнительный анализ времени отклика серверной части. Многие внешние факторы вызывают изменение времени отклика серверной части. Часто повторяющиеся постоянные ошибки чтения серверной части можно предотвратить, изменив настройки времени ожидания серверной части в веб-интерфейсе Fastly. Начните с выполнения следующей команды, чтобы оценить время отклика для целей сравнительного анализа:

Увеличение настроек времени ожидания серверной части. После сравнительного анализа некоторых более медленных путей в вашем приложении у вас должно быть представление об идеальном времени отклика серверной части. Настройте значения тайм-аута серверной части на странице «Редактировать этот хост» в области «Дополнительные параметры». Кроме того, если перед источником есть внешний интерфейс (например, балансировщик нагрузки или брандмауэр), проверьте время ожидания для этих интерфейсов.

Ошибка 503: время ожидания соединения истекло

Эта ошибка возникает, если время запроса истекает во время ожидания Fastly для установления TCP-соединения с вашим источником или ожидания ответа вашего источника на запрос. Как и в случае с внутренними ошибками чтения, тайм-ауты подключения могут быть вызваны временными сетевыми проблемами, длительными поездками к источнику и задержкой источника. Вот два распространенных способа устранения этих ошибок тайм-аута:

  • Увеличение значения времени ожидания соединения, установленного для Fastly Host.
  • Настройка щита происхождения. Настройка исходного щита дает два преимущества:
    • Сокращение расстояния, необходимого для установления соединения.
    • Сокращение рукопожатий TCP, вызванных использованием нескольких точек присутствия. Это позволяет источнику избежать замедлений и обрабатывать только запросы на несколько подключений от экрана.

    Быстро устанавливает 60-секундный тайм-аут между узлами, если только вы не передаете запросы в vcl_recv .

    Ошибка 503: ошибка записи серверной части

    Эта ошибка аналогична ошибке чтения серверной части, но возникает, когда Fastly отправляет информацию в виде запроса POST серверной части. Эту ошибку можно устранить так же, как и ошибку внутреннего чтения.

    Ошибка 503: ошибка чтения клиента

    Эта ошибка обычно возникает из-за проблемы с сетью между клиентом и Fastly. Это также может произойти, когда пользователь прекращает загрузку страницы (например, страница загружается слишком медленно, и пользователь нажимает кнопку «Стоп» в браузере). Это похоже на ошибку чтения бэкэнда, но возникает при чтении информации с клиента. Если вы получили эту ошибку, обратитесь в службу поддержки Fastly за помощью в определении проблемы с сетью.

    Ошибка 503: ошибка выборки серверной части

    Эта ошибка возникает, когда соединение закрывается до того, как серверы Fastly cache закончат чтение ответа. Эта ошибка может возникнуть, если в ответе отсутствует или недействителен заголовок Content-Length, хотя могут быть и другие причины. Чтобы решить эту проблему, убедитесь, что ваш источник включает заголовок Content-Length или Transfer-Encoding: chunked вместе с ответом. Если ни один из заголовков отсутствует, сначала убедитесь, что один из них добавлен. Если присутствует один из заголовков, убедитесь, что весь ресурс может быть получен напрямую из источника. Если присутствует какой-либо из заголовков и весь ресурс может быть получен из источника, обратитесь в службу поддержки Fastly за дополнительной помощью.

    Ошибка 503: тайм-аут первого байта

    Эта ошибка возникает, когда Fastly устанавливает соединение с вашим источником, но источник не начинает отправлять ответ в течение времени, которое вы настроили для тайм-аута первого байта. Чтобы решить эту проблему, увеличьте время ожидания первого байта для вашего источника.

    По умолчанию время ожидания первого байта равно 15 секундам. Вы можете увеличить максимально возможное время ожидания до 600 с. Однако имейте в виду следующее:

    Если в вашем источнике настроен щит, максимальное время ожидания должно быть уменьшено до 60 секунд.

    Кластеризация ограничивает максимальное время ожидания до 60 секунд. Если объект кэшируется, то для увеличения максимального времени ожидания до 60 с необходимо отключить кластеризацию, добавив заголовок Fastly-No-Shield в vcl_recv.Если вы решите добавить заголовок Fastly-No-Shield, убедитесь, что ваше условие точно соответствует требованиям, которые занимают более 60 секунд, так как его добавление повлияет на коэффициент попаданий в кэш.

    Ошибки конфигурации источника и службы

    Ниже описаны типичные ошибки конфигурации источника и службы Fastly, с которыми вы можете столкнуться.

    503 Объект ответа слишком велик

    Если Fastly определит, что извлекаемый объект превышает предельный размер ресурсов вашей службы Fastly, мы сгенерируем объект 503 Response слишком большой ответ клиенту. Вы можете использовать функцию сегментированного кэширования, чтобы устранить эти ошибки.

    Ошибка 503: соединение отклонено

    Эта ошибка возникает, когда Fastly пытается установить соединение с вашим источником через определенный порт, а сервер отказывается от соединения. Обычно он появляется, когда для хоста в веб-интерфейсе Fastly указан неверный порт. Чтобы устранить эту ошибку, вам может потребоваться изменить номер порта, чтобы убедиться, что вы используете порт, необходимый для подключения к вашему источнику. Если настройка номера порта не работает, вам также может потребоваться просмотреть настройки источника, чтобы убедиться, что вы разрешаете подключения с определенных IP-адресов Fastly.

    Ошибка 503: недопустимый заголовок Vary из бэкенда

    Эта ошибка возникает, когда серверная часть возвращает в своем ответе искаженный заголовок Vary. Правильно сформированный заголовок Vary указывает Fastly обслуживать другую версию объекта на основе значения заголовка запроса, включенного в него.

    Ошибка 503: сеть недоступна

    Эта ошибка появляется, когда Fastly не может найти маршрут к указанному диапазону IP-адресов. Обычно это происходит из-за неправильно настроенных или неработающих маршрутизаторов. Чтобы устранить эту ошибку, проверьте свои маршрутизаторы, чтобы убедиться, что они работают или правильно настроены.

    Ошибки работоспособности Origin

    Ниже описаны типичные ошибки работоспособности источника, с которыми вы можете столкнуться.

    Ошибка 503: серверная часть не работает

    • источнику потребовалось слишком много времени, чтобы ответить на запрос
    • существуют временные проблемы с сетью, и проверка работоспособности не может получить доступ к источнику
    • проверка работоспособности была настроена неправильно, либо ресурс, по которому выполняется проверка работоспособности, был удален или каким-либо образом изменен

    Чтобы устранить эту ошибку, убедитесь, что ваш источник настроен правильно, а объект, который запрашивает проверка работоспособности, существует в указанном месте.

    Ошибка 503: нет доступных устаревших объектов

    Эта ошибка возникает, когда вы настроили Fastly для обслуживания устаревших объектов в случае сбоя серверной части, но срок действия устаревшего объекта истек, а ваша серверная часть по какой-то причине все еще дает сбой (таким образом, устаревший объект недоступен). Чтобы устранить эту ошибку, вам потребуется либо исправить источник, либо проверить сеть.

    Ошибки ограничения количества подключений

    Ниже описаны типичные ошибки ограничения количества подключений, с которыми вы можете столкнуться.

    Ошибка 503 backend.max_conn достигнута

    Эта ошибка возникает, когда Varnish делает запрос к бэкенду в вашем сервисе Fastly, который достиг заданного максимального количества подключений. По умолчанию Fastly ограничивает вас 200 исходными подключениями от одного пограничного узла, чтобы защитить источники от перегрузки. Для большинства сайтов этого должно быть достаточно. Если вы получаете это сообщение об ошибке с менее чем 10 000 неуспешных запросов в секунду, убедитесь, что ваш источник отвечает нормально (например, нет замедления источника). Если вы просто увеличите количество максимальных подключений, вы можете усугубить проблему. Если вы определили, что проблема не в вашем источнике, увеличьте максимальный лимит подключений к вашему источнику или обратитесь в службу поддержки Fastly за дополнительной помощью по этой проблеме. Эта ошибка также может отображаться как "Ошибка 503: достигнуто максимальное количество потоков для службы".

    Ошибка 503: достигнуто максимальное количество потоков для службы

    Эта ошибка возникает, когда Varnish обнаруживает, что служба превысила безопасный предел количества одновременных запросов. Обычно это указывает на то, что служба испытывает необычно высокую нагрузку, что источник работает медленно или что такие функции, как свертывание запросов, намеренно избегаются.

    Ошибки режиссера

    Ниже описаны типичные ошибки Director, с которыми вы можете столкнуться.

    Ошибка 503: нет исправных серверных частей

    Эта ошибка возникает, когда директор, используемый для балансировки запросов между группой бэкэндов (доступен только через Fastly API), не может кэшировать указанный контент, так как в его группе нет доступных работоспособных бэкендов.

    Ошибка 503: все серверные части вышли из строя или не работают

    Эта ошибка возникает, когда директор, используемый для балансировки запросов между группой бэкэндов (доступных только через Fastly API), дает сбой, потому что все бэкенды неработоспособны или несколько бэкендов, из которых директор пытался получить информацию, не сработали с той же ошибкой.

    Ошибка 503: кворум не достигнут

    Эта ошибка возникает, когда директор, используемый для балансировки запросов между группой бэкэндов (доступен только через Fastly API), не может обслуживать трафик на основе своей конфигурации, поскольку в его группе недостаточно доступных бэкендов.

    Чтобы устранить любую из этих ошибок, вам следует либо проверить и решить все проблемы с вашим источником, либо убедиться в правильности настройки кворума. Кроме того, убедитесь, что вы правильно задали параметры кворума. Например, в директоре с пятью серверными частями 85 % кворума отметят директор как неработоспособный, если неработоспособен хотя бы один сервер.

    Ошибки TLS

    Ниже описаны типичные ошибки TLS, с которыми вы можете столкнуться. Вы также можете найти информацию о других распространенных ошибках TLS в вашем источнике в руководстве по сообщениям конфигурации источника TLS.

    Ошибка 503 Ошибка рукопожатия SSL

    Эта ошибка возникает при сбое согласования TLS между Fastly и вашим источником. Чтобы исправить эту ошибку, проверьте и исправьте настройки TLS вашего хоста.

    Ошибка 503: невозможно получить сертификат локального эмитента

    Эта ошибка возникает, когда сертификат в цепочке сертификатов отсутствует или недействителен. Чтобы лучше определить, какая из этих проблем является причиной ошибки, мы предлагаем запустить тест SSL в вашем источнике, чтобы выявить любые проблемы с установленным там сертификатом. Есть два распространенных способа устранить эту ошибку:

    • В случае отсутствующих или недействительных сертификатов загрузите и замените отсутствующий или неверный сертификат.
    • Если и промежуточный, и корневой сертификаты верны, вставьте действительное имя хоста Server Name Indication (SNI) в исходные параметры TLS службы Fastly.

    Ошибка 503: имя хоста не соответствует сертификату

    Эта ошибка возникает, когда имя хоста сертификата, указанное в настройках TLS источника вашей службы, не совпадает ни с общим именем (CN), ни с доступными альтернативными именами субъекта (SAN). Чтобы устранить эту ошибку, введите значение имени хоста сертификата, которое соответствует записям CN или SAN в сертификате вашего источника.

    Ошибка 503:14077410:Процедуры SSL:SSL23_GET_SERVER_HELLO:предупреждение sslv3

    Эта ошибка возникает, когда требуется указание имени сервера (SNI) в рукопожатии TLS для источника, но поле имени хоста SNI пусто или неверно. Чтобы исправить эту ошибку, введите значение имени хоста в поле имени хоста SNI. Часто это будет соответствовать значению, указанному в поле имени хоста сертификата.

    Срок действия сертификата Ошибка 503 истек

    Эта ошибка возникает, когда истекает срок действия сертификата, установленного в источнике. Чтобы решить эту проблему, обновите свой сертификат или загрузите новый.

    Формат ответа об ошибке

    В следующих примерах показаны некоторые распространенные ошибки. Обратите внимание, что информация заголовка в ответах опущена.

    401 Неавторизованный

    Ниже приведен пример ответа об ошибке, который вы получаете, если пытаетесь перечислить сегменты для проекта, но не предоставляете заголовок авторизации.

    403 Запрещено

    Это пример ответа об ошибке, который вы получаете, если пытаетесь перечислить сегменты несуществующего проекта или проекта, в котором у вас нет разрешения на перечисление сегментов.

    404 Не найден

    Ниже приведен пример ответа об ошибке, который вы получаете, если пытаетесь получить несуществующий объект.

    409 Конфликт

    Ниже приведен пример ответа об ошибке, который вы получаете, если пытаетесь создать сегмент, используя имя уже имеющегося сегмента.

    В следующей таблице описаны элементы, которые могут отображаться в тексте ответа об ошибке. Поля следует использовать вместе, чтобы помочь определить проблему. Кроме того, примеры значений, приведенные ниже, предназначены для иллюстрации и не являются исчерпывающим списком всех возможных значений.

    302 — найдено

    Причина Описание
    Найдено Ресурс временно расположен в другом месте в соответствии с заголовком Location.

    303 — см. Другое

    Причина Описание
    mediaDownloadRedirect При запросе загрузить с помощью параметра URL-адреса alt=media, прямой URL-адрес для использования имеет префикс /download . Если это опущено, служба выполнит это перенаправление с соответствующим путем загрузки мультимедиа в заголовке Location.

    304 — не изменено

    Причина Описание
    notModified Условный запрос был бы успешным, но условие было ложным, поэтому тело не было отправлено.

    307—Временная переадресация

    Причина Описание
    temporaryRedirect Ресурс временно расположен в другом месте в соответствии с заголовком Location. Среди других причин это может произойти, когда используется аутентификация на основе файлов cookie, например., при использовании Storage Browser, и получает запрос на загрузку содержимого.

    308 — Резюме не завершено

    Описание
    Указывает на незавершенную возобновляемую загрузку и предоставляет диапазон байтов, уже полученных Cloud Storage. Ответы с этим статусом не содержат тела.

    400 — неверный запрос

    401 — Несанкционировано

    • Срок действия маркера доступа OAuth истек, и его необходимо обновить. Этого можно избежать, заранее обновив токен доступа, но код также может перехватить эту ошибку, обновить токен и повторить попытку автоматически.
    • Предоставлено несколько несовпадающих разрешений; выберите только один режим.
    • Связанный проект токена доступа OAuth не соответствует проекту, связанному с предоставленным ключом разработчика.
    • Заголовок авторизации имеет нераспознанный формат или использует неподдерживаемый тип учетных данных.

    403 — Запрещено

    404 – не найдено

    Причина Описание
    notFound Есть метод API не связан с URL-путем запроса, или запрос ссылается на один или несколько ресурсов, которые не были найдены.

    405 — метод не разрешен

    408 – время ожидания запроса

    Причина Описание
    uploadBrokenConnection Время запроса вне. Пожалуйста, попробуйте еще раз, используя усеченную экспоненциальную отсрочку.

    409—Конфликт

    Причина Описание
    конфликт Запрос на изменить ресурс, обычно метод storage.*.update или storage.*.patch, не удалось зафиксировать изменение из-за конфликтующего одновременного изменения того же ресурса. Запрос может быть повторен, однако необходимо учитывать новое состояние ресурса, чтобы избежать слепой замены изменений другого агента.

    410 – удалено

    Описание
    Вы попытались использовать возобновляемый сеанс загрузки или перезаписать токен, который больше недоступен. Если код состояния, о котором сообщается, не был успешным, но вы все еще хотите завершить загрузку или перезапись, вы должны начать новый сеанс.

    411 – требуется длина

    412 — Предварительное условие не выполнено

    413 – Слишком большая полезная нагрузка

    Причина Описание
    conditionNotMet Не менее одного из указанных вами предварительных условий не выполняется.
    orgPolicyConstraintFailed Запрос нарушает ограничение OrgPolicy.
    Причина Описание
    uploadTooLarge Облачное хранилище JSON API поддерживает до 5 объектов TiB.

    416 — Запрошенный диапазон не соответствует требованиям

    Причина Описание
    requestedRangeNotSatisfiable Запрошенный диапазон не может быть удовлетворен.

    429 — Слишком много запросов

    [Домен.]Причина Описание
    usageLimits.rateLimitExceeded Превышено ограничение на использование JSON API Cloud Storage. Если ваше приложение попытается использовать больше своего лимита, дополнительные запросы не будут выполнены. Дросселируйте запросы ваших клиентов и/или используйте усеченную экспоненциальную отсрочку.

    499 — Клиент закрыл запрос

    Описание
    Возобновляемая загрузка была отменена по запросу клиента до ее завершения. У этой ошибки нет тела ответа.

    500—Внутренняя ошибка сервера

    Причина Описание
    backendError Мы обнаружили внутренняя ошибка. Пожалуйста, попробуйте еще раз, используя усеченную экспоненциальную отсрочку.
    internalError Мы обнаружили внутреннюю ошибку. Пожалуйста, попробуйте еще раз, используя усеченную экспоненциальную отсрочку.

    502 — Неверный шлюз

    Эта ошибка возникает, когда возникают трудности с доступом к внутренней службе. Он не отформатирован с помощью документа JSON. Повторите попытку, используя усеченную экспоненциальную отсрочку.

    503 — Служба недоступна

    Причина Описание
    backendError Мы обнаружили внутренняя ошибка. Пожалуйста, попробуйте еще раз, используя усеченную экспоненциальную отсрочку.

    504 – тайм-аут шлюза

    Эта ошибка возникает, когда возникают трудности с доступом к внутренней службе. Он не отформатирован с помощью документа JSON. Повторите попытку, используя усеченную экспоненциальную отсрочку.

    Если не указано иное, содержимое этой страницы находится под лицензией Creative Commons Attribution 4.0, а образцы кода распространяются под лицензией Apache 2.0. Подробнее см. в Правилах сайта Google Developers. Java является зарегистрированным товарным знаком Oracle и/или ее дочерних компаний.

    На этой странице описаны методы устранения распространенных ошибок, с которыми вы можете столкнуться при использовании Cloud Storage.

    См. панель состояния Google Cloud для получения информации о региональных или глобальных инцидентах, затрагивающих службы Google Cloud, такие как Cloud Storage.

    Регистрация необработанных запросов

    При использовании таких инструментов, как gsutil или клиентские библиотеки Cloud Storage, большая часть информации о запросах и ответах обрабатывается этим инструментом. Однако иногда бывает полезно просмотреть подробные сведения, чтобы помочь в устранении неполадок. Используйте следующие инструкции, чтобы вернуть заголовки запросов и ответов для вашего инструмента:

    Консоль

    Просмотр сведений о запросе и ответе зависит от браузера, который вы используете для доступа к Google Cloud Console. Для браузера Google Chrome:

    Нажмите кнопку главного меню Chrome ( ).

    Выберите дополнительные инструменты.

    Нажмите Инструменты разработчика.

    На появившейся панели нажмите вкладку Сеть.

    gsutil

    Используйте в своем запросе глобальный флаг -D. Например:

    Клиентские библиотеки

    Установите переменную среды CLOUD_STORAGE_ENABLE_CLOG=yes, чтобы вести журнал каждого RPC.

    Создайте файл с именем logging.properties со следующим содержимым:

    Использовать logging.properties с Maven

    Node.js

    Питон

    Используйте модуль ведения журнала. Например:

    В верхней части файла .rb после require "google/cloud/storage" добавьте следующее:

    Коды ошибок

    301: перемещен навсегда

      В Google Cloud Console перейдите на страницу браузера облачного хранилища.

    400: неверный запрос

    Проблема: при выполнении возобновляемой загрузки я получил эту ошибку и сообщение Failed to parse Content-Range header.

    Решение. Значение, которое вы использовали в заголовке Content-Range, недопустимо. Например, Content-Range: */* недействителен и вместо этого должен быть указан как Content-Range: bytes */* . Если вы получили эту ошибку, ваша текущая возобновляемая загрузка больше не активна, и вы должны начать новую возобновляемую загрузку.

    401: Неавторизованный

    Решение. Убедитесь, что ваш клиент или какой-либо промежуточный прокси-сервер не добавляет заголовок авторизации к запросам в Cloud Storage. Любой запрос с заголовком Authorization, даже если он пуст, проверяется, как если бы это была попытка аутентификации.

    403: учетная запись отключена

    Проблема: я пытался создать сегмент, но получил ошибку 403: учетная запись отключена.

    Решение. Эта ошибка означает, что вы еще не включили оплату для связанного проекта. Инструкции по включению выставления счетов см. в разделе Включение выставления счетов для проекта.

    Если оплата включена, но вы продолжаете получать это сообщение об ошибке, вы можете обратиться в службу поддержки, предоставив идентификатор своего проекта и описание проблемы.

    403: доступ запрещен

    Проблема: я попытался составить список объектов в своей корзине, но получил ошибку 403 "Отказано в доступе" и/или сообщение, похожее на сообщение "Анонимный абонент не имеет доступа к storage.objects.list" .

    Решение. Убедитесь, что ваши учетные данные верны. Например, если вы используете gsutil, проверьте правильность учетных данных, хранящихся в вашем файле .boto. Кроме того, убедитесь, что gsutil использует ожидаемый файл .boto, выполнив команду gsutil version -l и проверив запись пути (путей) конфигурации.

    403: Запрещено

    Чтобы избежать этой проблемы, выполните одно из следующих действий:

    • Используйте прямые вызовы API, которые поддерживают загрузку без проверки подлинности, вместо загрузки через браузер с проверкой подлинности. которые отслеживают доступ к затронутым объектам. Имейте в виду, что журналы доступа к данным устанавливаются на уровне проекта или выше и могут быть включены одновременно на нескольких уровнях. чтобы исключить определенных пользователей из отслеживания журнала доступа к данным, что позволяет этим пользователям выполнять загрузку через браузер с проверкой подлинности.

    409: Конфликт

    Проблема: я попытался создать сегмент, но получил следующую ошибку:

    Решение. Имя корзины, которое вы пытались использовать (например, gs://cats или gs://dogs ), уже занято. Облачное хранилище имеет глобальное пространство имен, поэтому вы не можете назвать корзину с тем же именем, что и существующую корзину. Выберите имя, которое не используется.

    429: Слишком много запросов

    Проблема: мои запросы отклоняются с ошибкой 429 Too Many Requests.

    Решение. Вы достигли предела количества запросов, которое Cloud Storage допускает для данного ресурса. См. квоты облачного хранилища для обсуждения ограничений в облачном хранилище. Если ваша рабочая нагрузка состоит из 1000 запросов в секунду к корзине, ознакомьтесь с рекомендациями по частоте запросов и рекомендациям по распределению доступа, в том числе по постепенному наращиванию рабочей нагрузки и отказу от последовательных имен файлов.

    Диагностика ошибок Google Cloud Console

    Проблема: при использовании Google Cloud Console для выполнения операции я получаю стандартное сообщение об ошибке. Например, я вижу сообщение об ошибке при попытке удалить корзину, но не вижу сведений о том, почему операция не удалась.

    Решение. Используйте уведомления Google Cloud Console, чтобы просмотреть подробную информацию о неудачной операции:

    Нажмите кнопку "Уведомления" в заголовке Google Cloud Console.

    В раскрывающемся списке отображаются самые последние операции, выполненные Google Cloud Console.

    Нажмите на элемент, о котором хотите узнать больше.

    Открывается страница с подробной информацией об операции.

    Нажимайте на каждую строку, чтобы развернуть подробную информацию об ошибке.

    Ниже приведен пример информации об ошибке для неудачной операции удаления сегмента, который объясняет, что политика хранения сегмента предотвратила удаление сегмента.

    ошибки gsutil

    Ниже приведены типичные ошибки gsutil, с которыми вы можете столкнуться.

    статистика gsutil

    Проблема: я попытался использовать команду gsutil stat для отображения статуса объекта для подкаталога и получил ошибку.

    Решение. В облачном хранилище для хранения объектов в сегментах используется плоское пространство имен. Хотя вы можете использовать косую черту ("/") в именах объектов, чтобы они выглядели так, как если бы объекты находились в иерархической структуре, команда gsutil stat рассматривает завершающую косую черту как часть имени объекта.

    Например, если вы запустите команду gsutil -q stat gs://my-bucket/my-object/ , gsutil будет искать информацию об объекте my-object/ (с косой чертой в конце), в отличие от операции на объектах, вложенных в my-bucket/my-object/ . Если у вас действительно нет объекта с таким именем, операция завершится ошибкой.

    Для просмотра списка подкаталогов используйте вместо этого gsutil ls.

    авторизация в gcloud

    Проблема: я пытался аутентифицировать gsutil с помощью команды gcloud auth, но по-прежнему не могу получить доступ к своим корзинам или объектам.

    Решение. В вашей системе могут быть установлены как автономная версия gsutil, так и версия Google Cloud CLI. Запустите команду gsutil version -l и проверьте значение для использования cloud sdk. Если False , ваша система использует автономную версию gsutil при выполнении команд. Вы можете либо удалить эту версию gsutil из своей системы, либо пройти аутентификацию с помощью команды gsutil config.

    Статические ошибки веб-сайта

    Ниже приведены распространенные проблемы, с которыми вы можете столкнуться при настройке корзины для размещения статического веб-сайта.

    • Используйте стороннюю сеть доставки контента с облачным хранилищем.
    • Размещайте статический контент веб-сайта на хостинге Firebase вместо облачного хранилища.

    Подтверждение домена

    Проблема: я не могу подтвердить свой домен.

    Решение. Обычно в процессе проверки в Search Console вам предлагается загрузить файл в свой домен, но у вас может не быть способа сделать это без предварительного создания соответствующей корзины, которую вы можете создать только после< /em> вы выполнили проверку домена.

    В этом случае подтвердите право собственности, используя метод подтверждения поставщика доменного имени. См. Подтверждение права собственности, чтобы узнать, как это сделать. Эту проверку можно выполнить до создания сегмента.

    Недоступная страница

    Проблема: я получаю сообщение об ошибке "Отказано в доступе" к веб-странице, обслуживаемой моим веб-сайтом.

    Решение. Убедитесь, что объект является общедоступным. Если это не так, инструкции о том, как это сделать, см. в разделе Предоставление доступа к данным.

    Если вы ранее загрузили объект и опубликовали его, а затем загрузили новую его версию, вы должны повторно опубликовать этот объект. Это связано с тем, что общедоступное разрешение заменяется новой загрузкой.

    Не удалось обновить разрешение

    Проблема: я получаю сообщение об ошибке, когда пытаюсь сделать свои данные общедоступными.

    Решение. Убедитесь, что у вас есть разрешение setIamPolicy для вашего объекта или сегмента. Это разрешение предоставляется, например, в роли администратора хранилища. Если у вас есть разрешение setIamPolicy, но вы по-прежнему получаете сообщение об ошибке, ваша корзина может подвергаться блокировке общего доступа, которая не разрешает доступ к allUsers или allAuthenticatedUsers. Предотвращение общего доступа может быть настроено непосредственно в корзине или может быть принудительно реализовано с помощью политики организации, установленной на более высоком уровне.

    Скачивание контента

    Проблема: мне предлагается загрузить содержимое моей страницы вместо того, чтобы просматривать его в браузере.

    Решение. Если вы укажете MainPageSuffix в качестве объекта, не имеющего типа веб-контента, то вместо обслуживания страницы посетителям сайта будет предложено загрузить контент. Чтобы решить эту проблему, обновите запись метаданных типа контента до подходящего значения, например text/html . Инструкции о том, как это сделать, см. в разделе Редактирование метаданных объекта.

    Задержка

    Ниже приведены распространенные проблемы с задержкой, с которыми вы можете столкнуться.Кроме того, панель состояния Google Cloud предоставляет информацию о региональных или глобальных инцидентах, затрагивающих такие службы Google Cloud, как облачное хранилище.

    Задержка загрузки или скачивания

    Проблема: я вижу увеличение задержки при загрузке или скачивании.

    Решение. Используйте команду gsutil perfdiag для запуска диагностики производительности из затронутой среды. Учтите следующие распространенные причины задержки загрузки и скачивания:

    Ограничения ЦП или памяти. В операционной системе затронутой среды должны быть инструменты для измерения потребления локальных ресурсов, таких как использование ЦП и памяти.

    Ограничения дискового ввода-вывода: в рамках команды gsutil perfdiag используйте тесты rthru_file и wthru_file, чтобы оценить влияние на производительность, вызванное локальным дисковым вводом-выводом.

    Географическое расстояние. На производительность может повлиять физическое разделение корзины Cloud Storage и затронутой среды, особенно в случаях с несколькими континентами. Тестирование с использованием корзины, расположенной в том же регионе, что и ваша затронутая среда, может определить, в какой степени географическое разделение способствует вашей задержке.

    • Если применимо, сопоставитель DNS затронутой среды должен использовать протокол EDNS(0), чтобы запросы из среды направлялись через соответствующий внешний интерфейс Google.

    задержка gsutil или клиентской библиотеки

    Проблема: я наблюдаю повышенную задержку при доступе к облачному хранилищу с помощью gsutil или одной из клиентских библиотек.

    Прокси-серверы

    Проблема: я подключаюсь через прокси-сервер. Что мне нужно сделать?

    Решение. Чтобы получить доступ к Cloud Storage через прокси-сервер, необходимо разрешить доступ к этим доменам:

    Если ваш прокси-сервер или политика безопасности не поддерживает белый список по домену и вместо этого требует внесения в белый список по блокировке IP-сети, мы настоятельно рекомендуем вам настроить прокси-сервер для всех диапазонов IP-адресов Google. Вы можете найти диапазоны адресов, запросив данные WHOIS в ARIN. Рекомендуется периодически проверять настройки прокси-сервера, чтобы убедиться, что они соответствуют IP-адресам Google.

    Если ваши запросы перенаправляются через прокси-сервер, вам может потребоваться обратиться к сетевому администратору, чтобы убедиться, что заголовок авторизации, содержащий ваши учетные данные, не удаляется прокси-сервером. Без заголовка Authorization ваши запросы отклоняются, и вы получаете сообщение об ошибке MissingSecurityHeader.

    Что дальше

      . .
    • Узнайте, как отчеты об ошибках могут помочь вам выявить и понять ошибки в облачном хранилище.

    Если не указано иное, содержимое этой страницы предоставляется по лицензии Creative Commons Attribution 4.0, а образцы кода — по лицензии Apache 2.0. Подробнее см. в Правилах сайта Google Developers. Java является зарегистрированным товарным знаком Oracle и/или ее дочерних компаний.

    Читайте также: