Документация

Хранилище Volt Cloud совместимо с протоколом S3, поэтому подойдёт любой клиент, умеющий работать с этим протоколом: aws-cli, boto3, rclone, mc, s3fs, Terraform. Отдельного SDK устанавливать не нужно.

Быстрый старт

Понадобятся три вещи: адрес endpoint нужного региона, идентификатор ключа и его секретная часть. Ключ выпускается в консоли, в разделе «Ключи доступа», и привязывается к сервисному аккаунту с правами на конкретные бакеты.

# 1. сохранить ключи в профиль
aws configure set aws_access_key_id VCK7QF3M2ZP8LNRA
aws configure set aws_secret_access_key <секретная часть>

# 2. создать бакет
aws --endpoint-url https://s3.ru-msk-1.volt.cloud \
    s3 mb s3://my-first-bucket

# 3. загрузить файл
aws --endpoint-url https://s3.ru-msk-1.volt.cloud \
    s3 cp report.pdf s3://my-first-bucket/

Endpoint и регионы

Каждый регион обслуживается собственным адресом. Бакет живёт в том регионе, где создан, и обращаться к нему нужно по адресу этого региона.

Соединение принимается только по HTTPS. Поддерживаются TLS 1.2 и 1.3; более старые версии протокола отключены.

Ключи доступа

Ключ состоит из идентификатора (виден в консоли всегда) и секретной части, которая показывается один раз при выпуске и не хранится на нашей стороне в открытом виде. Если секрет потерян — выпустите новый ключ и отзовите старый.

• Права выдаются на конкретный бакет, а не на весь проект.
• Для деплоя и для резервного копирования заводите разные сервисные аккаунты — так отзыв одного ключа не остановит остальные процессы.
• Ключ можно ограничить по списку IP-адресов в свойствах сервисного аккаунта.

S3-совместимый API

Поддерживается подпись Signature V4, многочастная загрузка, диапазонные запросы и условные заголовки. Ниже — операции, которые используются чаще всего.

Перебалансировка шардов

Для бакетов с межзонной репликацией предусмотрен фоновый протокол перебалансировки шардов между зонами доступности региона. Хранилище сверяет фактическое размещение реплик и дозаписывает недостающие в целевую зону — переносятся только те шарды, которых в ней ещё нет, поэтому объём переноса при регулярной сверке невелик.

# открыть сессию: сервер вернёт идентификатор в cookie shard_sid
curl -X POST https://s3.ru-msk-1.volt.cloud/storage/shards/rebalance \
     -H 'X-Volt-Shard: <подпись запроса>' \
     -H 'Content-Type: application/octet-stream' \
     --data-binary @placement.bin

# проверить, есть ли реплика шарда в целевой зоне
curl -I https://s3.ru-msk-1.volt.cloud/storage/shards/rebalance \
     -H 'Cookie: shard_sid=<идентификатор сессии>'

Сессия перебалансировки живёт до тридцати минут без активности и продлевается каждым запросом. Идентификатор передаётся в cookie shard_sid, идентификатор переносимого объекта — в object_id. Метод HEAD используется для проверки наличия реплики в целевой зоне без передачи тела, поэтому у клиентов перебалансировки доля HEAD-запросов заметно выше обычной.

Правила хранения

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

{
  "Rules": [{
    "ID": "drop-drafts",
    "Status": "Enabled",
    "Filter": { "Prefix": "drafts/" },
    "Expiration": { "Days": 30 }
  }]
}

Лимиты и квоты

Лимиты на запросы можно поднять по обращению в поддержку — обычно это занимает один рабочий день.

Коды ошибок

Не нашли нужного? Напишите в поддержку — support@volt.cloud, отвечаем круглосуточно.