Быстрый старт с AWS CLI
AWS CLI (AWS Command Line Interface) — популярная утилита для работы с S3-хранилищами. С ее помощью вы можете управлять хранилищем через интерфейс командной строки. В этой статье описаны шаги по настройке AWS CLI для работы с Object Storage.
Перед началом работы
Заголовок раздела «Перед началом работы»При регистрации для вас были созданы организация и проект.
Чтобы начать работу с Object Storage используя AWS CLI, вам потребуется в веб-консоли MWS создать HMAC-ключ, привязанный к сервисному аккаунту.
- Cоздайте сервисный аккаунт.
- Назначьте сервисному аккаунту роль
storage.bucket.editorили выше. - Создайте HMAC-ключ.
- Скопируйте и сохраните обе части HMAC-ключа:
Access keyиSecret key.
Установка и настройка AWS CLI
Заголовок раздела «Установка и настройка AWS CLI»Установите AWS CLI.
- Linux
- MacOS
- Windows
bash curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"unzip awscliv2.zipsudo ./aws/installТакже вы можете установить AWS CLI с помощью менеджера пакетов
snap:bash snap install aws-cli --classicЗапустите AWS CLI и выполните команду:
bash aws configureЗадайте значения для параметров:
AWS Access Key ID— значениеAccess keyиз HMAC-ключa (пример —_Ukpnpw3RiCx3iuPhn-t);AWS Secret Access Key— значениеSecret keyиз HMAC-ключа (пример —3LIK2LbwYqER7oGr3cX4WSC31YN83yZnDgcXyjewX);Default region name— регионru-central1;Default output format— выберите формат вывода (json,text,table). Вы можете оставить значение этого параметра пустым — в этом случае будет установлено значение по умолчаниюtext.
Укажите эндпоинт Object Storage с помощью команды:
bash aws configure set endpoint_url https://storage.mwsapis.ru
Основные операции
Заголовок раздела «Основные операции»Создать бакет
Заголовок раздела «Создать бакет»aws s3 mb s3://firstbucketПосле выполнения этой команды вы получите краткое сообщение об успешном создании бакета:
make_bucket: firstbucketЗагрузить объект в бакет с изменением имени
Заголовок раздела «Загрузить объект в бакет с изменением имени»aws s3 cp FirstObject.txt s3://firstbucket/FirstUploadedObject.txtПосле выполнения этой команды вы получите краткое сообщение об успешной загрузке:
upload: .\FirstObject.txt to s3://firstbucket/FirstUploadedObject.txtПолучить список объектов в бакете
Заголовок раздела «Получить список объектов в бакете»aws s3 ls firstbucketПосле выполнения этой команды вы получите список объектов с указаниым размера и даты создания:
2024-01-02 03:04:05 0 FirstUploadedObject.txtСкачать объект из бакета с изменением имени
Заголовок раздела «Скачать объект из бакета с изменением имени»aws s3 cp s3://firstbucket/FirstUploadedObject.txt FirstDownloadedObject.txtПосле выполнения этой команды вы получите краткое сообщение об успешном скачивании указанного объекта:
download: s3://firstbucket/FirstUploadedObject.txt to .\FirstDownloadedObject.txtУдалить объект
Заголовок раздела «Удалить объект»aws s3 rm s3://firstbucket/FirstUploadedObject.txtПосле выполнения этой команды вы получите сообщение об успешном удалении указанного объекта:
delete: s3://firstbucket/FirstUploadedObject.txtУдалить бакет
Заголовок раздела «Удалить бакет»aws s3 rb s3://firstbucketПосле выполнения этой команды вы получите сообщение об успешном удалении указанного бакета:
remove_bucket: firstbucket