CLI

VK Cloud позволяет использовать интерфейс командной строки для управления сервисами VK Object Storage и автоматизации их работы.

Подготовительные шаги

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

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

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

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

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

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

  4. Укажите регион размещения сервиса VK Object Storage по умолчанию. Настройка должна соответствовать региону аккаунта:

    • ru-msk — регион Москва;
    • kz-ast — регион Казахстан.
  5. Укажите выходной формат по умолчанию. Эта настройка определяет, в каком виде AWS CLI отобразит результат выполнения команды. Доступные варианты:

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

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

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

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

aws s3 ls --endpoint-url <URL_СЕРВИСА>

Здесь:

  • <URL_СЕРВИСА> — должен соответствовать региону аккаунта:
    • https://hb.vkcloud-storage.ru или https://hb.ru-msk.vkcloud-storage.ru — для региона Москва;
    • https://hb.kz-ast.vkcloud-storage.ru — для региона Казахстан.

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

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

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

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

aws s3 mb s3://<ИМЯ_БАКЕТА> --endpoint-url <URL_СЕРВИСА>

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

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

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

aws s3 ls s3://<ИМЯ_БАКЕТА> --endpoint-url <URL_СЕРВИСА>