VK Cloud logo
Обновлена 15 апреля 2024 г. в 08:50

CLI

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

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

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

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

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

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

    aws configure
  2. Укажите идентификатор ключа доступа к Cloud Storage.

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

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

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

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

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

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

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

aws s3 ls --endpoint-url <домен>

Здесь:

  • <домен> — регион аккаунта Cloud Storage. По умолчанию AWS CLI настроен на работу с серверами Amazon, поэтому обязательно указывайте --endpoint-url при выполнении любой команды. Возможные значения:
    • https://hb.ru-msk.vkcs.cloud — домен региона Россия;
    • https://hb.kz-ast.vkcs.cloud — домен региона Казахстан.

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

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

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

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

aws s3 mb s3://<имя_бакета> --endpoint-url <домен>

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

aws s3 cp <путь_к_локальному_файлу> s3://<имя_бакета> --endpoint-url <домен>

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

aws s3 ls s3://<имя_бакета> --endpoint-url <домен>