AWS CLI - База знаний Linx Cloud

База знаний

Ссылки на дистрибутивы AWS CLI и документация доступны по данной ссылке.

Запустите настройку конфигурации AWS: aws configure .
Задайте следующие параметры:

AWS Access Key ID [None] - Access Key, выданный при заведении тенанта
AWS Secret Access Key [None] - Secret Key, выданный при заведении тенанта
Default region name [None] - оставьте пустым.
Default output format [None] - оставьте пустым.

При работе с AWS CLI необходимо:

- либо каждый раз указывать endpoint-url, что делает команды наглядными и позволяет проще переключаться между сервисами и минимизирует вероятность отправки команд "не в то окно"

- либо сохранить в конфигурации endpoint-url, что удобно для сокращения длины команд (далее мы будем приводить примеры команд с учётом для этого варианта использования)

Далее в статье ключ_объекта - имя объекта и путь к нему, включающий все каталоги.

Сохранение endpoint-url в конфигурации

aws configure set endpoint_url https://r1g1z1.p20s3.linx.ru/

Просмотр корневого каталога

aws s3 ls

Работа с бакетами и каталогами

Создание бакета

aws s3api create-bucket --bucket имя_бакета

Важно: имя бакета должно соответствовать правилам наименования.

Создание каталога в существующем бакете

aws s3api put-object --bucket имя_бакета --key имя_каталога

Удаление каталога со всеми вложенными объектами и подкаталогами

aws s3 rm s3://имя_бакета/имя_каталога --recursive

Просмотр списка и размера объектов в бакете или каталоге

aws s3 ls s3://имя_бакета/имя_каталога --recursive --human-readable --summarize

Важно: при большом количестве объектов в бакете или каталоге, выполнение команды может занимать продолжительное время.

Работа с объектами

Скачивание объекта

aws s3api get-object --bucket имя_бакета --key ключ_объекта присваиваемое_имя

или

aws s3 cp s3://имя_бакета/ключ_объекта присваиваемое_имя>

Загрузка объекта

aws s3api put-object --bucket имя_бакета --key ключ_объекта --body путь_к_файлу

или

aws s3 cp путь_к_файлу s3://имя_бакета

Удаление объекта

aws s3 rm s3://имя_бакета/ключ_объекта

Multipart

Удаление частично загруженного multipart объекта

aws s3api abort-multipart-upload --bucket имя_бакета --key ключ_объекта --upload-id идентификатор_загрузки

Чтобы узнать upload-id, найдите его в списке загрузок, который можно вызвать с помощью команды, приведённой ниже.

Отобразить сиписок multipart загрузок объектов

aws s3api list-multipart-uploads --bucket имя_бакета

Управление доступом через ACL

Прочитать ACL объекта

aws s3api get-object-acl --bucket имя_бакета --key ключ_объекта

Прочитать ACL бакета

aws s3api get-bucket-acl --bucket имя_бакета

Назначить ACL на бакет

aws s3api put-bucket-acl --bucket имя_бакета --acl уровень_доступа

, где уровень_доступа принимает одно из следующих значений:

- private - только владелец бакета получает FULL_CONTROL (запись, чтение, управление ACL), остальные пользователи никакого доступа не имеют;

- public-read - владелец бакета получает FULL_CONTROL, а группа AllUsers (другие пользователи tenant'а) получает READ (прочитать, скачать объект, прочитать список объектов в бакете)

- public-read-write - владелец бакета получает FULL_CONTROL, а группа AllUsers получает READ и WRITE (запись, чтение, удаление объекты);

- authenticated-read - владелец бакета получает FULL_CONTROL, а группа AuthenticatedUsers получает READ, анонимно объекты недоступны

Создать presigned ссылку на объект для публичного доступа

aws s3 presign s3://имя_бакета/имя_объекта

Сгенерировать ограниченную по времени presigned ссылку

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

Управление жизненным циклом объектов

Загрузка конфигурации в хранилище

Запрос конфигурации

Удаление конфигурации

Управление CORS-конфигурацией

Загрузка конфигурации в хранилище

Запрос конфигурации

Удаление конфигурации

Работа с Object Lock (WORM)

Создание нового бакета с включённой поддержкой Object Lock

aws s3api create-bucket --bucket имя_бакета --object-lock-enabled-for-bucket

Важно: команда активирует только возможность использования функции Object Lock на объектах без немедленного применения retention правил.

Проверка конфигурации Object lock на бакете

aws s3api get-object-lock-configuration --bucket имя_бакета

Применение retention правила на объект

aws s3api put-object-retention --bucket имя_бакета --key ключ_объекта --retention '{Mode=нужный_режим,RetainUntilDate=дата_завершения_блокировки}'

где

нужный_режим - COMPLIANCE или GOVERNANCE

дата_завершения_блокировки - пишется в формате год-месяц-деньTчас:минута:секунда, например, 2027-01-01T00:00:00

Применение retention правила на весь бакет

aws s3api put-object-lock-configuration --bucket имя_бакета --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": количество_дней }}}'

ВАЖНО:

Настройка object lock не удаляет автоматически обекты при завершении срока удержания (Retention). Автоматическое удаление объектов определяется правилами lifecycle.

Управление пользователями

Если Вы используете IAM аккаунт, то Вам выдан root user, от имени которого есть возможность sub-user'ов с гранулярными правами.

Создание sub-user

Создать пользователя (sub-user)

aws --profile default --region default iam create-user --user-name 'имя_пользователя'

Создать пользователю реквизиты доступа (access key и secret key)

aws --profile default --region default iam create-access-key --user-name 'имя_пользователя'

Добавить пользователю права доступа в формате JSON, записанные в файле.

aws iam put-user-policy --user-name имя_пользователя --policy-name AllowAll --policy-document file://policy.json

Пример содержания файла с правами доступа к бакету с названием "test".

{

"Version": "2012-10-17",

"Statement": [

{

"Effect": "Allow",

"Action": [

"s3:ListAllMyBuckets",

"s3:GetBucketLocation",

"s3:GetObjectTagging"

"Resource": "*"

{

"Effect": "Allow",

"Action": [

"s3:PutObject",

"s3:GetObject",

"s3:DeleteObject",

"s3:PutObjectTagging",

"s3:ListBucket"

"Resource": [

"arn:aws:s3:::test",

"arn:aws:s3:::test/*"

]

}

]

}

Сгенерировать policy под вашу задачу можно с помощью специального инструмента от AWS, доступного по ссылке https://awspolicygen.s3.amazonaws.com/policygen.html

Ещё

С полным списком команд вы можете ознакомится в документации вендора на официальном сайте https://aws.amazon.com/ru/cli/, или введя в CLI команду

aws s3 help