Инструкция описывает начало работы с API Object Storage с помощью консольной утилиты AWS CLI®. Вы создадите бакет Object Storage и загрузите в него объект.
Чтобы начать работу с API Object Storage:
Выполните базовые команды: создайте бакет, загрузите объект, получите список объектов и удалите их.
Получите ключ доступа
Для аутентификации в API Object Storage вы можете использовать персональный ключ доступа, привязанный к личной учетной записи, или ключ доступа сервисного аккаунта.
Чтобы получить ключ:
Авторизуйтесь в личном кабинете.
Создайте ключ доступа одним из способов:
Создайте сервисный аккаунт и сгенерируйте ключ доступа для него.
Сохраните Key ID (логин) и Key Secret (пароль).
Получите идентификатор тенанта.
В личном кабинете на верхней панели слева нажмите
и выберите Хранение данных → Object Storage.
Идентификатор тенанта указан над списком бакетов.
Установите и настройте AWS CLI
AWS CLI — консольная утилита для работы с сервисами AWS.
Скачайте дистрибутив AWS CLI на сайте разработчика и установите утилиту.
В командной строке введите команду aws configure. Укажите параметры подключения к хранилищу:
AWS Access Key ID — идентификатор ключа доступа к API в формате <tenant_id>:<key_id>, где:
<tenant_id> — идентификатор тенанта;
<key_id> — Key ID (логин) ключа доступа.
AWS Secret Access Key — Key Secret (пароль) ключа доступа.
Default region name — ru-central-1.
Создайте бакет
Выполните команду:
aws s3 mb s3://<bucket_name> --endpoint-url https://s3.cloud.ru
Где <bucket_name> — название бакета.
Пример команды:
aws s3 mb s3://my-bucket --endpoint-url https://s3.cloud.ru
Команда создаст бакет my-bucket.
Загрузите объект в бакет
Выполните команду:
aws s3 cp <file_path> s3://<bucket_name>/<object_name> --endpoint-url https://s3.cloud.ru
Где:
<file_path> — путь до локального файла, который будет загружен в качестве объекта.
<bucket_name> — название бакета, в который нужно загрузить объект.
<object_name> — название объекта в бакете.
Пример команды:
aws s3 cp my_directory/my_file.txt s3://my-bucket/my-object --endpoint-url https://s3.cloud.ru
Команда загрузит объект my-object в бакет my-bucket из файла my_directory/my_file.txt.
Получите список объектов бакета
Выполните команду:
aws s3 ls s3://<bucket_name> --endpoint-url https://s3.cloud.ru
Где <bucket_name> — название бакета.
Пример команды:
aws s3 ls s3://my-bucket --endpoint-url https://s3.cloud.ru
Команда вернет список объектов бакета my-bucket.
Удалите объекты из бакета
Если загруженные объекты больше не нужны, удалите их — это позволит не израсходовать ресурсы хранилища.
Выполните команду:
aws s3 rm s3://<bucket_name> --endpoint-url https://s3.cloud.ru --recursive
Где <bucket_name> — название бакета.
Пример команды:
aws s3 rm s3://my-bucket --endpoint-url https://s3.cloud.ru --recursive
Команда удалит все объекты из бакета my-bucket.
Что дальше
После создания бакета вы можете:
использовать бакет для размещения статического сайта;
настроить ACL и политики доступа (Bucket Policy) для бакета.