Object Storage

S3cmd для работы с Object Storage

S3cmd^® — это интерфейс командной строки для работы с сервисами, поддерживающими HTTP API Amazon S3. Для установки S3cmd^® скачайте дистрибутив на сайте разработчика.

Примечание

S3cmd^® не поддерживает работу с версиями объектов. Чтобы работать с версиями объектов, используйте AWS CLI.

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

Для доступа Object Storage потребуются:

Tenant ID — идентификатор тенанта. ID тенанта можно скопировать в сервисе Object Storage платформы Evolution.
Key ID (логин) и Key Secret (пароль) — формируются при создании персонального API-ключа или ключа сервисного аккаунта.
Endpoint — s3.cloud.ru.

Настройка S3cmd

Введите команду s3cmd --configure.
Для параметра Access Key введите <tenant_id>:<key_id>.
Для параметра Secret Key введите <key_secret>.
Для параметра Default Region введите регион ru-central-1.
Для параметра S3 Endpoint введите s3.cloud.ru.
Для параметра Host Bucket введите host_bucket = %(bucket)s.s3.cloud.ru, где %(bucket)s — доменное имя бакета.
Для параметра DNS-style bucket+hostname:port template оставьте значение по умолчанию.
Для параметра Use HTTPS protocol выберите Yes.
Для параметра Test access with supplied credentials выберите Yes, чтобы проверить подключение.
Сохраните конфигурацию.
После успешной проверки подключения нажмите Enter, чтобы сохранить конфигурацию.

Проверка подключения

Проверьте список бакетов командой s3cmd ls.

Если вы видите список бакетов, подключение прошло успешно.

В противном случае создайте бакет командой s3cmd mb.

Примеры команд

Создать бакет:
```
s3cmd mb s3://customer-bucket-name
```
Получить список бакетов:
```
s3cmd ls
```
Загрузить объект:
```
s3cmd put FILE /Desktop/customer_object.html s3://customer-bucket-name/customer-object-key --storage-class=COLD
```
Внимание
По умолчанию загружаемому объекту присваивается класс STANDARD. Чтобы присвоить объекту класс ICE или COLD, укажите его в команде --storage-class <Class_Name>.
Получить список объектов:
```
s3cmd ls s3://customer-bucket-name
```
Удалить бакет:
```
s3cmd rb s3://customer-bucket-name
```

Чтобы посмотреть и проанализировать проблемы, добавьте к команде параметр --debug.

С полным списком команд для S3cmd можно ознакомиться на сайте разработчика.

Дополнительные возможности

Редактирование конфигурации

Конфигурационный файл S3cmd^® находится по пути ~/.s3cfg. Он может быть отредактирован для изменения параметров подключения.

С полным списком возможностей и настроек других параметров можно ознакомиться на сайте разработчика.

Была ли статья полезной ?

Предыдущая статья

AWS CLI для работы с Object Storage

Следующая статья

rclone для работы с Object Storage

Поддержка Юридические документы