Виджет позволяет просматривать содержимое S3-совместимых хранилищ объектов, таких как Amazon S3, Yandex Object Storage, MinIO и другие.
Для каждого объекта доступно:
- Просмотр списка объектов в S3-бакете с информацией о размере, дате изменения и классе хранения.
- Поиск объектов по префиксу (пути).
- Загрузка файлов из S3-бакета.
- Просмотр детальной метаинформации объектов (размер, тип контента, метаданные, настройки кеширования и т. д.).
- Навигация по каталогам S3-бакета.
Использование шаблонов для учётных данных
Для повышения безопасности можно использовать механизм шаблонизации с учётными данными:
{{ .credentials.accessKeyId }}— подставить Access Key ID из учётных данных.{{ .credentials.secretAccessKey }}— подставить Secret Access Key из учётных данных.
Доступность информации в виджете определяется уровнем прав подключённой учётной записи.
Конфигурация
| Название | Обязательность | Описание | Значение по умолчанию |
|---|---|---|---|
| Название S3-бакета | Да | Название S3-бакета для просмотра | — |
| Endpoint | Да | Эндпоинт URL S3-совместимого хранилища (например, https://storage.yandexcloud.net) | — |
| Регион | Да | Регион, в котором находится S3-бакет | — |
| Access Key ID | Да | Идентификатор ключа доступа для аутентификации | — |
| Secret Access Key | Да | Секретный ключ доступа для аутентификации | — |
| Префикс | Нет | Префикс (путь) для фильтрации объектов при первоначальной загрузке | — |
| Максимум объектов | Нет | Максимальное количество объектов для отображения за один запрос (по умолчанию 100) | 100 |
Дополнительные возможности виджета
Поиск объектов
Виджет позволяет искать объекты по префиксу (пути). При поиске список объектов обновляется в соответствии с заданным префиксом.
Поиск работает только при вводе символов с начала названия объекта. Поиск по символам из середины названия не поддерживается.
Если в конфигурации виджета задан начальный префикс, поиск в виджете ограничивается этим префиксом. Загрузка и отображение файлов с другим префиксом недоступны.
Загрузка файлов
Виджет позволяет загружать файлы из S3-бакета напрямую в браузер. Для каждого файла доступна кнопка загрузки.
Детальная информация об объектах
При клике на иконку документа для каждого объекта отображается детальная информация:
- Основные параметры: ключ, размер, дата изменения, класс хранения, тип контента, ETag.
- Информация о контенте: кодировка, язык, диспозиция.
- Настройки кеширования: Cache-Control, срок действия.
- Безопасность: серверное шифрование.
- Пользовательские метаданные.
Загрузка дополнительных объектов
При наличии большого количества объектов в S3-бакете доступна функция «Загрузить ещё» для пошаговой загрузки объектов без потери производительности.
Аутентификация
Для работы с виджетом требуется учётная запись с правами доступа к S3-бакету. Система поддерживает следующие методы аутентификации:
- Access Key ID и Secret Access Key.
- Поддержка различных S3-совместимых провайдеров через настройку эндпоинта.
В отличие от других виджетов, виджет S3 не поддерживает использование внешних сервисов для передачи учётных данных. Укажите все параметры аутентификации непосредственно в конфигурации виджета.