VK Object Storage logo
Помощь
Обновлена 17 июля 2026 г. в 15:35

CLI

VK Object Storage поддерживает управление сервисом через интерфейс командной строки.

Настройте подключение к VK Object Storage

  1. Создайте аккаунт и ключ доступа к VK Object Storage в личном кабинете IAM Only. Сохраните секретный ключ доступа (Secret Key).

  2. Установите нужные инструменты:

  1. В консоли выполните команду:

    aws configure
  2. Укажите идентификатор ключа доступа, полученный при создании аккаунта VK Object Storage.

  3. Укажите секретный ключ доступа Secret Key, полученный при создании аккаунта VK Object Storage. Секретный ключ должен соответствовать тому идентификатору ключа, который вы указали в консоли.

  4. Укажите регион размещения сервиса VK Object Storage, указанный при установке сервиса. По умолчанию используется значение ru-msk.

  5. Укажите выходной формат по умолчанию. Эта настройка определяет, в каком виде AWS CLI отобразит результат выполнения команды. Доступные варианты:

    • json — данные отображаются в формате JSON, значение по умолчанию;
    • yaml — данные отображаются в формате YAML;
    • yaml-stream — данные передаются в потоковом режиме и формируются в формате YAML;
    • текст — строковые значения разделены табуляцией;
    • таблица — строковые значения разделены |.

    AWS CLI хранит эту информацию в профиле (наборе настроек), названном default в credentials-файле. Информация из этого профиля используется, когда запускается команда без указания профиля.

Проверьте подключение к VK Object Storage

Выполните команду для вывода списка бакетов:

aws s3 ls --endpoint-url <ENDPOINT_URL>

Здесь:

  • <ENDPOINT_URL> — ссылка с доменным именем, которое используется в вашей инсталляции VK Object Storage. Формат имени может отличаться. Чтобы узнать точный формат ссылки, обратитесь к вашему администратору.

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

При возникновении проблем с подключением, обратитесь к документации разработчика:

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

Создание бакета:

aws s3 mb s3://<ИМЯ_БАКЕТА> --endpoint-url <ENDPOINT_URL>

Загрузка файла в бакет:

aws s3 cp <ПУТЬ_К_ЛОКАЛЬНОМУ_ФАЙЛУ> s3://<ИМЯ_БАКЕТА> --endpoint-url <ENDPOINT_URL>

Получение списка объектов:

aws s3 ls s3://<ИМЯ_БАКЕТА> --endpoint-url <ENDPOINT_URL>