Работа с файлами
Взаимодействие с Хранилищем осуществляется программно. Вы можете использовать API или SDK для управления файлами.
Способы загрузки
Сервис поддерживает два основных механизма загрузки файлов, каждый из которых подходит для своих сценариев.
1. Простая загрузка (Simple Upload)
Стандартная загрузка через HTTP POST запрос с использованием multipart/form-data.
- Когда использовать: Для небольших файлов (аватарки, документы, картинки), когда не требуется сложная логика возобновления.
- Преимущества: Простота реализации, поддержка любым HTTP-клиентом.
2. Протокол TUS (Resumable Upload)
TUS — это открытый протокол для возобновляемой загрузки файлов.
- Когда использовать:
- Загрузка больших файлов (видео, архивы).
- Работа в нестабильных сетях (мобильный интернет).
- Преимущества:
- Возобновляемость: Если соединение прервется, загрузка продолжится с того же места.
- Надежность: Гарантия целостности данных.
Доступ к файлам
После загрузки файла вы можете получить к нему доступ по URL.
Получение URL
URL файла формируется на основе настроек вашего провайдера и ключа файла.
- Публичные файлы: Доступны по прямой ссылке без авторизации (если бакет настроен как публичный).
- Приватные файлы: Требуют генерации подписанных URL (Presigned URLs) с ограниченным сроком действия для безопасного доступа.
подсказка
Подробную информацию о методах API и функциях SDK для работы с хранилищем смотрите в разделе API Reference и SDK.