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

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

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

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

Служба Azure	Эталонная группа	Ссылка на подгруппу	Command	Полная справочная команда	Примеры параметров
Azure CLI	az config			az config	--local --output -o
Сеть Azure	az network	application-gateway	create	az network application-gateway create	--name --resource-group --capacity
Azure DevOps	az pipelines	agent	list	az pipelines agent list	--pool-id --agent-name --demands

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

Справочная группа	Подгруппа 1	Подгруппа 2	Подгруппа 3	Command
network	application-gateway	private-link	ip-config	add

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

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

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

Term	Core	Extension
References	Являются частью основной службы Azure CLI	Это опциональные команды ссылок, которые можно установить.
Install	Совместно с установщиком MSI	Индивидуально с az extension add
Released	По расписанию	По мере того как новые функции или обновления становятся доступными
Status	Может быть общедоступной, предварительной или устаревшей.	Кроме того, можно использовать общедоступную версию, предварительную версию или устаревшую версию.

Чтобы получить список групп команд, выполните команду az.

# Get list of all command groups
az

Для списка расширений используйте az extension list-available --output table команды.

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

Core

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

Extension

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

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

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

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

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

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

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

Note

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

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

Полная справочная команда	Parameters	Type	GA	Общедоступная предварительная версия	Deprecated
az network dns zone list	All	Core	yes
az network dns zone create	--name --resource-group --if-none-match --parent-name	Core	yes
	--existingParameter5	Core			yes
	--newParameter6	Core		yes
az network vhub list	All	Extension	yes
az network vhub create	--address-prefix --name --resource-group -vwan --location --sku	Extension	yes
	--existingParameter7	Extension		yes
	--newParameter8	Extension	yes
az network firewall create	All	Extension		yes

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

См. также

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