AWS CLI

AWS CLI — это интерфейс командной строки для работы с сервисами, поддерживающими HTTP API Amazon S3.

Общий порядок вызова команд смотрите в официальной документации Amazon Web Services.

Управление S3 bucket через AWS CLI

1. Установите AWS CLI

Для установки AWS CLI воспользуйтесь инструкцией на сайте разработчика ПО.

2. Настройте доступ AWS CLI к S3 bucket

Все настройки AWS CLI хранятся в файлах .aws/config и .aws/credentials в домашней директории пользователя. Для подключения вашей выделенной области хранения объектов на серверах хранения (S3 bucket) пропишите следующие настройки в этих файлах.

Файл .aws/config

[profile ngenix]
s3 =
  addressing_style = virtual
  signature_version = v4

Файл .aws/credentials

[ngenix]
  aws_access_key_id = id
  aws_secret_access_key = secretKey

В полях aws_access_key_id и aws_secret_access_key укажите свои авторизационные данные для доступа. Посмотреть их вы можете на странице «Cloud Object Storage» клиентского портала NGENIX Multidesk.

3. Выполняйте команды для управления S3 bucket

В примерах ниже используется S3 bucket с идентификаторомs12345. Для корректного выполнения команд используйте идентификатор собственного S3 bucket.

Список типовых команд:

• Получить список всех файлов в S3 bucket

• Загрузить локальный файл в S3 bucket

• Загрузить локальный файл в S3 bucket с добавлением HTTP-заголовка

• Синхронизировать содержимое директории с S3 bucket

• Загрузить файл из S3 bucket

• Синхронизировать S3 bucket с содержимым директории

• Удалить файл из S3 bucket

[Пример] Получить список всех файлов в S3 bucket «s12345»

aws --profile ngenix --endpoint-url=https://cos.ngenix.net s3 ls s3://s12345/

[Пример] Загрузить локальный файл /data/www/file.dat в S3 bucket «s12345»

aws --profile ngenix --endpoint-url=https://cos.ngenix.net s3 cp /data/www/file.dat s3://s12345/

[Пример] Загруить локальный файл /data/www/file.dat в S3 bucket «s12345» с добавлением HTTP-заголовка "Cache-Control: max-age=604800"

aws --profile ngenix --endpoint-url=https://cos.ngenix.net s3 cp /data/www/file.dat s3://s12345/ --cache-control max-age=604800

[Пример] Синхронизировать содержимое директории /data/www/ с S3 bucket «s12345»

aws --profile ngenix --endpoint-url=https://cos.ngenix.net s3 sync /data/www/ s3://s12345/

[Пример] Загрузить файл /file.dat из S3 bucket «s12345»

aws --profile ngenix --endpoint-url=https://cos.ngenix.net s3 cp s3://s12345/file.dat /data/www/file.dat

[Пример] Синхронизировать S3 bucket «s12345» с содержимым директории /data/www/

aws --profile ngenix --endpoint-url=https://cos.ngenix.net s3 sync s3://s12345/ /data/www/

[Пример] Удалить файл /file.dat с S3 bucket «s12345»

aws --profile ngenix --endpoint-url=https://cos.ngenix.net s3 rm s3://s12345/file.dat