Обзор: терминология и уровни поддержки Azure CLI

Статья
2025-04-14

В этой статье описываются терминологии Azure CLI. Существуют компоненты синтаксиса, ссылочные типы и состояния.

Компоненты синтаксиса Azure CLI

Синтаксис Azure CLI — это сочетание групп, ссылок, команд и параметров. Often the full reference command is referred to as command.

Служба Azure	Референтная группа	Опорные подгруппы	командование	Full reference command	Примеры параметров
Azure CLI (интерфейс командной строки Azure)	az config			az config	--local, --output -o
Сеть Azure	az network	шлюз приложений	create	az network application-gateway create	--name, --resource-group, --capacity
Azure DevOps	az pipelines	агент	список	az pipelines agent list	--pool-id, --agent-name, --demands

Ссылочная подгруппа может иметь несколько уровней, таких какaz network application-gateway private-link ip-config add

Справочная группа	Подгруппа 1	Подгруппа 2	Подгруппа 3	командование
сеть	шлюз приложений	приватная ссылка	настройка IP	add

Полный список ссылочных команд см. в списке ссылок A to Z .

What is reference type?

Команды Azure CLI являются частью основной службы Azure CLI или являются расширением. Расширения — необязательные дополнения. Тип ссылки определяет расписание выпуска, состояние и метод установки, как указано здесь:

Срок	Ядро	Расширение
Ссылки	Являются частью основной службы Azure CLI	Are optional reference commands that must be installed
Установка	Совместно с установщиком MSI	Individually with az extension add
Выпущено	По расписанию	По мере того как новые функции или обновления становятся доступными
Статус	Can be GA (Generally Available), preview or deprecated	Also can be GA, preview or deprecated

Чтобы получить список групп команд, выполните команду az. Чтобы посмотреть список доступных расширений, используйте команду az extension list-available --output table.

# Get list of all command groups
az

# Get list of extensions
az extension list-available --output table

Ядро

Ссылки Azure CLI, опубликованные в качестве постоянной части интерфейса командной строки, называются основными ссылками. Все основные ссылки устанавливаются с помощью Azure CLI и вы не можете выбрать подмножество ссылок. Если вы запускаете CLI с помощью Azure Cloud Shell, основные ссылки всегда будут актуальными.

Расширение

Расширения не поставляются как часть интерфейса командной строки, но выполняются в качестве команд CLI. Некоторые расширения являются постоянной частью Azure CLI, но часто расширение предоставляет доступ к предварительным версиям и экспериментальным командам. Одна эталонная группа, например az iot hub, может иметь как основные, так и расширения команды. Вот два примера:

Full reference command	Is Core	Is Extension
az iot hub list	да
az iot hub job list		да

Вам будет предложено установить расширение при первом использовании. Вы также можете установить расширение, выполнив команду az extension add .

Вы можете узнать больше о ссылках на расширения, включая установку и обновление, в разделе Использование расширений с Azure CLI. Полный список команд ссылок на расширения см. в разделе "Доступные расширения" для Azure CLI .

What is reference status?

Независимо от типа ссылок, ссылки Azure CLI делятся на три категории состояния: ga (общедоступная версия), общедоступная предварительная версия или нерекомендуемые. Это состояние ссылочной команды (не тип), определяющее стабильность.

	GA	Общедоступная предварительная версия	Устарело
Стабильность	Постоянный	Может измениться в ответ на отзывы клиентов. Подлежит условиям предварительных версий Microsoft Azure.	Будет удален.

Примечание.

Предупреждения, указывающие на общедоступную предварительную версию или устаревшие , являются частью выходных данных команды Azure CLI и должны быть ожидаемыми.

Большинство команд и параметров для одной ссылки имеют одно состояние, но не всегда. A GA reference that is being built out to offer more commands can have both GA and preview reference commands. При добавлении новых параметров для повышения функциональности одна команда также может иметь параметры, которые попадают под различные категории состояния. Вот примеры ссылок с разными статусами:

Full reference command	Параметры	Тип	GA	Общедоступная предварительная версия	Устарело
az network dns zone list	Все	Ядро	да
az network dns zone create	--name, --resource-group, --if-none-match, --parent-name	Ядро	да
	--существующийПараметр5	Ядро			да
	--newParameter6	Ядро		да
az network vhub list	Все	Расширение	да
az network vhub create	--address-prefix, --name, --resource-group, -vwan, --location, --sku	Расширение	да
	--exsitingParameter7	Расширение		да
	--newParameter8	Расширение	да
az network firewall create	Все	Расширение		да

Приведенная выше таблица является только примером и не отражает текущие статусы ссылок для az network.

См. также

Жизненный цикл поддержки Azure CLI