Бакет

Логическая сущность, которая помогает организовать хранение объектов.

Именование бакетов

Название бакета используется как часть URL для доступа к данным и его будут видеть ваши пользователи. Например, https://storage.yandexcloud.net/bucket-name.

Правила именования:

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

  • На имя бакета накладываются следующие ограничения:

    • Длина имени должна быть от 3 до 63 символов.
    • Имя может содержать строчные буквы латинского алфавита, цифры, дефисы и точки.
    • Первый и последний символы должны быть буквами или цифрами.
    • Символы справа и слева от точки должны быть буквами или цифрами.
    • Имя не должно иметь вид IP-адреса (например 10.1.3.9).

Примечание

Имена с точками следует использовать только при хостинге статических сайтов. Также помните, что протокол HTTPS не доступен для бакетов, имена которых содержат точку.

URL бакета

Название бакета можно поместить в разные части URL, который в зависимости от этого может принимать одну из следующих форм:

  • https://storage.yandexcloud.net/<bucket>?<parameters>
  • https://<bucket>.storage.yandexcloud.net?<parameters>

Настройки бакетов

Вы можете:

Доступ к бакетам

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

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

Особенности использования

  • Бакет нельзя переименовать.

  • Производительность Object Storage не зависит от количества бакетов. Вы можете хранить все свои данные в одном бакете или в нескольких.

  • Бакеты не могут быть вложенными.

  • Удалить можно только пустой бакет.

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

  • При быстрой последовательной загрузке объектов возможно превышение максимального заданного объема бакета.

  • После удаления объектов из бакета, удаленный объем еще некоторое время считается занятым.

    Примечание

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