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Файл .aws/credentials

Код

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

Код

[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 «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