Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Интерфейс командной строки
KZ
  • Начало работы
    • Все инструкции
    • Установка
    • Обновление
    • Удаление
    • Работа с версиями команд
  • Релизы
  • Решение проблем

В этой статье:

  • Узнать, какие версии доступны
  • Использовать определенную версию
  • Изменить версию для основной ветки
  1. Пошаговые инструкции
  2. Работа с версиями команд

Работа с версиями команд Yandex Cloud CLI

Статья создана
Yandex Cloud
Обновлена 29 июля 2026 г.
Открыть в Markdown
  • Узнать, какие версии доступны
  • Использовать определенную версию
  • Изменить версию для основной ветки

Для быстрого выпуска новой функциональности сервисов и обеспечения более широкого покрытия вызовов публичного API в Yandex Cloud CLI постепенно внедряется новый подход по формированию дерева команд — напрямую из proto-спецификаций публичного gRPC API.

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

В каждой группе сервисных команд, например yc compute, как и прежде остается основная ветка команд — yc compute [ instance | image | disk | ... ], но также добавляются ветки с номерами версии команд, например yc compute v0 [ instance | image | disk | ... ].

Основная ветка команд обязательно соответствует одной из версий. Если версия всего одна, то основная ветка полностью ее дублирует.

Информация о появлении или удалении версии команд, а также о переключении основной ветки на другую версию публикуется в разделе Релизы Yandex Cloud CLI.

Совет

Используйте актуальную версию CLI и дерево команд, которое сервис назначил основным. Если команды CLI вызываются из скриптов, CI/CD или других автоматизированных процессов, при переходе на новую версию CLI сначала проверьте совместимость команд. Пока прежняя версия команд доступна, вы можете явно указывать ее в конкретных командах или назначить ее версией по умолчанию.

Узнать, какие версии доступныУзнать, какие версии доступны

Когда сервис поддерживает несколько версий команд, для каждой из них доступна отдельная ветка с номером версии.

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

yc <название_сервиса> --help

Пример:

yc baremetal --help

Результат:

Command tree v1 (new CLI interface) is the default. Run `yc baremetal v1 <command>`.
Legacy command tree v0 is also available: `yc baremetal v0 <command>`.
Set `services.baremetal.version: v0` or `services.baremetal.version: v1` in your profile to change the default.

Эта информация также указана на обзорной странице соответствующего сервиса в справочнике CLI, например yc baremetal или yc smartwebsecurity.

Использовать определенную версиюИспользовать определенную версию

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

yc <название_сервиса> v<номер_версии> <команда>

Например:

yc baremetal v0 server list

Изменить версию для основной веткиИзменить версию для основной ветки

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

yc config set services.<название_сервиса>.version v<номер_версии>

Например:

yc config set services.smartwebsecurity.version v0

Полезные ссылкиПолезные ссылки

  • Справочник CLI
  • Релизы Yandex Cloud CLI
  • Управление параметрами профиля Yandex Cloud CLI

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

Предыдущая
Удаление
Следующая
Создание
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»