Конфигурация Yandex Cloud CLI
Статья создана
Обновлена 29 июля 2026 г.
Вы можете задать конфигурационные параметры в профиле, чтобы быстро переключать контекст выполнения команд. Для разового запуска команды с определенным значением параметра используйте глобальные параметры.
Важно
Обратите внимание, что некоторые параметры не могут использоваться одновременно. Значение одного из параметров обнуляется после установки другого.
Глобальные параметры доступны для любой команды, но не все команды их обрабатывают. Например, если ресурс определяется только идентификатором, то параметры облака и каталога игнорируются.
| Глобальный параметр | Параметр профиля | Описание |
|---|---|---|
--debug |
— | Вывести журнал отладки при выполнении команды. |
--debug-grpc |
— | Вывести журнал отладки gRPC при выполнении команды. Очень подробный, полезен для отладки проблем с подключением. |
--cloud-id |
cloud-id |
Идентификатор облака, который будет использован при выполнении команды. Применяется только в команде yc resource-manager folder list или совместно с folder-name. В остальных случаях параметр игнорируется. |
--folder-id |
folder-id |
Идентификатор каталога, который будет использован при выполнении команды. Применяется, когда вы обращаетесь по имени к ресурсу в каталоге, отличном от каталога по умолчанию. При обращении по идентификатору ресурса указывать каталог не требуется — поиск выполняется глобально с учетом прав доступа. При установке данного параметра профиля обнуляется параметр folder-name. |
--folder-name |
folder-name |
Имя каталога, который будет использован при выполнении команды. Применяется, когда вы обращаетесь по имени к ресурсу в каталоге, отличном от каталога по умолчанию. При обращении по идентификатору ресурса указывать каталог не требуется — поиск выполняется глобально с учетом прав доступа. При установке данного параметра профиля обнуляется параметр folder-id. |
--format |
format |
Формат, в котором будет представлен вывод: text (по умолчанию), yaml, json, json-rest. |
-h, --help |
— | Вывести справку о команде. |
--no-user-output |
— | Исключить вывод, предназначенный пользователю, из потока вывода ошибок stderr. |
--profile |
— | Имя профиля, параметры которого будут использованы при выполнении команды. |
| — | service-account-key |
Авторизованный ключ сервисного аккаунта в Yandex Cloud. Устанавливается из файла, в котором хранится ключ. При установке данного параметра профиля обнуляется параметр token. |
| — | services.<название_сервиса>.version |
Версия дерева команд сервиса, используемая по умолчанию. Подробнее в разделе Работа с версиями команд Yandex Cloud CLI. |
--token |
token |
Токен, который используется для аутентификации в Yandex Cloud. При установке данного параметра профиля обнуляется параметр service-account-key. |