Перейти к содержимому

Быстрый старт с 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.
  1. Установите AWS CLI.

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

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

    bash
    snap install aws-cli --classic
  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

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

bash
make_bucket: firstbucket

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

Заголовок раздела «Загрузить объект в бакет с изменением имени»
bash
aws s3 cp FirstObject.txt s3://firstbucket/FirstUploadedObject.txt

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

bash
upload: .\FirstObject.txt to s3://firstbucket/FirstUploadedObject.txt
bash
aws s3 ls firstbucket

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

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

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

Заголовок раздела «Скачать объект из бакета с изменением имени»
bash
aws s3 cp s3://firstbucket/FirstUploadedObject.txt FirstDownloadedObject.txt

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

bash
download: s3://firstbucket/FirstUploadedObject.txt to .\FirstDownloadedObject.txt
bash
aws s3 rm s3://firstbucket/FirstUploadedObject.txt

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

bash
delete: s3://firstbucket/FirstUploadedObject.txt
bash
aws s3 rb s3://firstbucket

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

bash
remove_bucket: firstbucket