Вернуться наверх

Быстрый старт с AWS CLI ​

AWS CLI (AWS Command Line Interface) — популярная утилита для работы с S3-хранилищами. С ее помощью вы можете управлять хранилищем через интерфейс командной строки. В этой статье описаны шаги по настройке AWS CLI для работы с Object Storage.

Перед началом работы ​

При регистрации для вас были созданы организация и проект.

Чтобы начать работу с Object Storage используя AWS CLI, вам потребуется в веб-консоли MWS создать HMAC-ключ, привязанный к сервисному аккаунту.

  1. Cоздайте сервисный аккаунт.
  2. Назначьте сервисному аккаунту роль storage.bucket.editor или выше.
  3. Создайте HMAC-ключ.
  4. Скопируйте и сохраните обе части HMAC-ключа: Access key и Secret key.

Установка и настройка AWS CLI ​

Внимание!

Поддерживается работа с AWS CLI до версии 2.22.35 включительно.

  1. Установите поддерживаемую версию AWS CLI.

    Инструкция по установке

    Linux:

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

    MacOS:

    bash
    curl "https://awscli.amazonaws.com/AWSCLIV2-2.22.35.pkg" -o "AWSCLIV2.pkg"
sudo installer -pkg AWSCLIV2.pkg -target /

    Также вы можете установить AWS CLI с помощью менеджера пакетов brew:

    bash
    brew install awscli

    Windows:

    Скачайте установочный файл.
    Дважды щелкните по файлу, и мастер установки проведет вас через весь процесс.

  2. Запустите AWS CLI и выполните команду:

    bash
    aws configure

  3. Задайте значения для параметров:

    • 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.

  4. Укажите эндпоинт Object Storage с помощью команды:

    bash
    aws configure set endpoint_url https://storage.mwsapis.ru

Основные операции ​

Создать бакет ​

bash
aws s3 mb s3://firstbucket

После выполнения этой команды вы получите краткое сообщение об успешном создании бакета:

make_bucket: firstbucket

Загрузить объект в бакет с изменением имени ​

bash
aws s3 cp FirstObject.txt s3://firstbucket/FirstUploadedObject.txt

После выполнения этой команды вы получите краткое сообщение об успешной загрузке:

upload: .\FirstObject.txt to s3://firstbucket/FirstUploadedObject.txt

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

bash
aws s3 ls firstbucket

После выполнения этой команды вы получите список объектов с указаниым размера и даты создания:

2024-01-02 03:04:05          0 FirstUploadedObject.txt

Скачать объект из бакета с изменением имени ​

bash
aws s3 cp s3://firstbucket/FirstUploadedObject.txt FirstDownloadedObject.txt

После выполнения этой команды вы получите краткое сообщение об успешном скачивании указанного объекта:

download: s3://firstbucket/FirstUploadedObject.txt to .\FirstDownloadedObject.txt

Удалить объект ​

bash
aws s3 rm s3://firstbucket/FirstUploadedObject.txt

После выполнения этой команды вы получите сообщение об успешном удалении указанного объекта:

delete: s3://firstbucket/FirstUploadedObject.txt

Удалить бакет ​

bash
aws s3 rb s3://firstbucket

После выполнения этой команды вы получите сообщение об успешном удалении указанного бакета:

remove_bucket: firstbucket