— это официальная библиотека AWS SDK для работы с сервисом S3 на языке JavaScript. С ее помощью можно загружать и скачивать файлы, получать списки объектов, удалять их, использовать мультипарт-загрузку и формировать подписанные ссылки.
Установка
Для установки используйте npm или yarn:
или
Настройка доступа
При использовании @aws-sdk/client-s3 реквизиты доступа можно задать несколькими способами.
Через файлы ~/.aws/config и ~/.aws/credentials
При использовании в домашней директории пользователя автоматически создаётся папка .aws с файлами, содержащими данные для подключения к S3. При необходимости эту папку и файлы можно создать вручную — без использования AWS CLI. Файл ~/.aws/credentials должен содержать такие данные:
И ~/.aws/config:
Через переменные окружения
Реквизиты можно задать с помощью переменных окружения:
Через код приложения
Полная настройка клиента с явной передачей всех параметров:
Использование профиля AWS CLI
Если настроено несколько профилей, можно указать нужный через переменную окружения:
В этом случае можно создать клиента без передачи ключей:
Пример
Рассмотрим, как при помощи SDK выполнять базовые операции с объектами. В этом примере скрипт:
- загружает файл в бакет;
- выводит список всех объектов;
- скачивает загруженный файл под другим именем;
- удаляет объект из хранилища.
Предварительно создайте файл с именем example.txt в той же директории, где находится скрипт.
Код скрипта: