S3

Интеграция позволяет работать с Amazon S3 и S3-совместимыми хранилищами: просматривать бакеты и объекты, читать, искать, загружать, скачивать и удалять файлы в пределах прав указанной учетной записи.

Доступные операции

Обзор и чтение объектов:
  • Просмотреть содержимое бакета с фильтрами по префиксу, разделителю, имени, маске и расширению.

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

Загрузка файлов:
  • Загрузить файл текущей сессии в хранилище.

  • Создать multipart-загрузку, записать части, завершить или прервать ее.

  • Выдать подписанные ссылки для прямой передачи файла клиентом.

Скачивание файлов:
  • Скачать файл из хранилища в файлы текущей сессии.

Изменение объектов:
  • Изменить параметры объекта, переименовать или восстановить его.

Настройки бакета:
  • Показать конфигурацию выбранного бакета и сведения о подключении.

  • Изменить конфигурацию или удалить выбранный бакет.

Экспорт:
  • Экспортировать реестр объектов бакета в файл XLSX.

Публикация и доступ:
  • Выдать временную ссылку, открыть публичный доступ или настроить публичный префикс.

Подготовка и добавление из витрины

Подготовка выполняется администратором GigaCowork.
Перед добавлением интеграции, получите у администратора хранилища:
  • HTTPS-адрес API хранилища.

  • Регион.

  • Имя бакета по умолчанию.

  • Сведения о поддержке условного PutObject с заголовком If-None-Match: *.

Для добавления интеграции:
  1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию.

  2. В витрине интеграций откройте подключаемую интеграцию S3 и укажите:

    • Адрес S3 — HTTPS-адрес API без имени бакета и пути (например, https://s3.example.ru).

    • Регион — регион хранилища (например, ru-central-1).

    • Бакет по умолчанию — имя существующего бакета.

    • Режим адресации — оставьте Автоматически, если провайдер не требует Virtual-hosted или Path-style.

    • Условная запись объектов — оставьте Поддерживается, если провайдер атомарно поддерживает If-None-Match: ; иначе выберите *Не поддерживается.

  3. Нажмите Далее, проверьте параметры и нажмите Добавить.

Авторизация в интеграции

Подготовка

В зависимости от вашего хранилища, сгенерируйте сами или получите у администратора ключи доступа: Access Key ID и Secret Access Key с правами, необходимыми для работы интеграции.

Авторизация

Для работы с интеграцией:
  1. Проверьте, что интеграция находится в разделе button grid 2x2 Каталоги → button blocks Интеграции. Если ее нет, попросите администратора GigaCowork ее включить.

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

  3. Введите Access Key ID и Secret Access Key.

  4. Нажмите Войти и убедитесь, что на карточке появился статус Авторизована.