Подключение к хранилищу S3 через AWS CLI

Хранилище S3 — объектное хранилище для хранения любых цифровых данных: документов, изображений, видео, архивов и прочего. Доступ к данным осуществляется через HTTP/HTTPS API по уникальным URL-адресам. В отличие от традиционных файловых систем, данные хранятся как независимые объекты с уникальными ключами и метаданными, а не как файлы в иерархии папок.

Установка AWS CLI

Для установки на Linux выполните:

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

Проверьте установку:

aws --version

Ожидаемый вывод:

aws-cli/2.27.45 Python/3.13.4 Linux/5.15.0-140-generic exe/x86_64.ubuntu.22

Инструкцию по установке AWS CLI на Windows и macOS можно найти в официальной документации.

Настройка подключения

Ключи доступа к хранилищу находятся в дашборде вашего заказа.

Ключи доступа в дашборде

Запустите мастер настройки:

aws configure

Введите следующие данные:

• AWS Access Key ID — ID ключа доступа.
• AWS Secret Access Key — секретный ключ.
• Default region name — регион размещения бакета, например us-east-1 (опционально).
• Default output format — рекомендуется json, либо оставьте пустым.

Учётные данные сохраняются в ~/.aws/credentials, конфигурация — в ~/.aws/config.

Добавьте endpoint хранилища в файл ~/.aws/config:

# замените s3-storage-host на название сервера из дашборда заказа
[default]
endpoint_url = https://s3-storage-host
s3 =
  addressing_type = virtual

Настройка подключения завершена.

Основные команды

Получить список объектов в бакете:

aws s3 ls s3://имя_бакета

Скопировать файл из локальной директории в бакет:

aws s3 cp local_file s3://имя_бакета

Загрузить файл из хранилища на локальный компьютер:

aws s3 cp s3://имя_бакета/file /path/to/local/directory

Синхронизировать локальный каталог с хранилищем:

aws s3 sync local_directory/ s3://имя_бакета

Удалить объект из хранилища:

aws s3 rm s3://имя_бакета/file

Создать временную ссылку для публичного доступа к файлу:

aws s3 presign s3://имя_бакета/file --expires-in время_в_секундах

Для справки по командам используйте aws s3 help.