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

Статья
2025-05-10

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

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

Синтаксис Azure CLI — это сочетание групп, ссылок, команд и параметров. Часто команда полной ссылки называется командой.

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

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

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

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

Что такое ссылочный тип?

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

Срок	Ядро	Расширение
Ссылки	Являются частью основной службы Azure CLI	Это опциональные команды ссылок, которые можно установить.
Установка	Совместно с установщиком MSI	Отдельно добавьте расширение az
Выпущено	По расписанию	По мере того как новые функции или обновления становятся доступными
Статус	Может быть общедоступной, предварительной или устаревшей.	Кроме того, можно использовать общедоступную версию, предварительную версию или устаревшую версию.

Чтобы получить список групп команд, выполните команду 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, может иметь как основные, так и расширения команды. Вот два примера:

Полная справочная команда	Является ядром	Это расширение
Команда для отображения списка: az iot hub list	да
az iot hub список заданий		да

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

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

Каков статус справки?

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

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

Замечание

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

Большинство команд и параметров для одной ссылки имеют одно состояние, но не всегда. Справочник GA, разрабатываемый для предоставления дополнительных команд, может содержать как команды GA, так и команды предварительной версии. При добавлении новых параметров для повышения функциональности одна команда также может иметь параметры, которые попадают под различные категории состояния. Вот примеры ссылок с разными статусами:

Полная справочная команда	Параметры	Тип	Генеральная Ассамблея	Общедоступная предварительная версия	Устарело
az network dns zone list	Все	Ядро	да
Команда создания DNS зоны в az network.	--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	Расширение	да
	--existingParameter7	Расширение		да
	--newParameter8	Расширение	да
az network firewall create (создать сетевой брандмауэр)	Все	Расширение		да

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

См. также

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