Obsutil

Obsutil — командная строка для работы с бакетами и объектами в Object Storage Service. Утилита подходит для пакетной обработки и автоматизации задач.

Obsutil совместим с операционными системами Windows, Linux и macOS.

Рекомендуемые версии ОС
OC	Версии
Windows	Windows 7 Windows 8 Windows 10 Windows Server 2016
Linux	SUSE 11 EulerOS 2 CentOS 7
macOS	macOS 10.13.4

Ниже описано, как установить и настроить подключение obsutil к хранилищу Object Storage Service.

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

Установить obsutil

Способ установки и запуска obsutil зависит от операционной системы вашего компьютера:

Распакуйте архив и запустите приложение obsutil.exe.

Распакуйте архив:
```
tar -xzvf obsutil_linux_amd64.tar.gz
```
Перейдите в каталог, в котором находится obsutil.
Разрешите выполнение obsutil:
```
chmod 755 obsutil
```

Распакуйте архив.
Откройте командную строку и перейдите в каталог, где находится obsutil.
Разрешите выполнение obsutil:
```
chmod 755 obsutil
```

Настроить подключение

Укажите данные для подключения к OBS:

Запустите приложение obsutil.exe.
В командной строке obsutil введите:
```
config -i=ak -k=sk -e=obs.ru-moscow-1.hc.sbercloud.ru
```
Где:
- ak — Access Key Id из файла credentials.csv.
- sk — Secret Access Key из файла credentials.csv.
Примечание

Если вы используете временные Access Key и Secret Key, укажите токен безопасности с помощью ключа -t:
```
config -i=ak -k=sk -e=obs.ru-moscow-1.hc.sbercloud.ru -t=security-token
```

Также вы можете настроить подключение в интерактивном режиме с помощью команды:

config -interactive

Пример:

-->config -interactive
Please input your ak:
your-access-key
Please input your sk:
your-secret-key
Please input your endpoint:
obs.ru-moscow-1.hc.sbercloud.ru
Please input your token:
your-security-token
Config file url:
  C:\Users\user-name\.obsutilconfig

Update config file successfully!

Если вы используете постоянные ключи доступа, на этапе Please input your token нажмите Enter, так как при использовании постоянных ключей токен не требуется.

Перейдите в каталог, в котором находится obsutil.
В командной строке введите:
```
./obsutil config -i=ak -k=sk -e=obs.ru-moscow-1.hc.sbercloud.ru
```
Где:
- ak — Access Key Id из файла credentials.csv.
- sk — Secret Access Key из файла credentials.csv.
Примечание

Если вы используете временные Access Key и Secret Key, укажите токен безопасности с помощью ключа -t :
```
./config -i=ak -k=sk -e=obs.ru-moscow-1.hc.sbercloud.ru -t=security-token
```

Также вы можете настроить подключение в интерактивном режиме:

./obsutil config -interactive

Пример:

./obsutil config -interactive
Please input your ak:
your-access-key
Please input your sk:
your-secret-key
Please input your endpoint:
obs.ru-moscow-1.hc.sbercloud.ru
Please input your token:
your-security-token
Config file url:
  /user-name/.obsutilconfig

Update config file successfully!

Если вы используете постоянные ключи доступа, на этапе Please input your token: нажмите Enter, так как при использовании постоянных ключей токен не требуется.

Проверить соединение

Чтобы проверить настройки, выполните команду, которая выведет список бакетов:

ls -s

./obsutil ls -s

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

Возможные ошибки и решения

Http status [403]

Проверьте, что указаны верные ключи доступа и у вас есть права на доступ к OBS.

Также эта ошибка может возникнуть в случае, если вы используете временный ключ доступа Temporary Access Key, но при этом не указан токен безопасности. Укажите токен с помощью ключа -t или в интерактивном режиме.

A connection attempt failed

Проверьте состояние сети.

См.также

Initializing the Configuration (en)

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

Спасибо за отзыв! Что можно улучшить?