Обзор терминологии и уровней поддержки Azure CLI
В этой статье описываются термины Azure CLI. В Azure CLI есть компоненты синтаксиса, ссылочные типы и состояния. это состояние, определяющее уровень поддержки.
Компоненты синтаксиса Azure CLI
Синтаксис Azure CLI представляет собой сочетание групп, ссылок, команд и параметров. Часто команда полной ссылки называется командой.
| Служба Azure | Ссылочная группа | Ссылочные подгруппы | Get-Help | Команда полной ссылки | Примеры параметров |
|---|---|---|---|---|---|
| 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 | агент | list | az pipelines agent list | --pool-id, --agent-name, --demands |
Ссылочная подгруппа может иметь несколько уровней, например az network application-gateway private-link ip-config add.
| Ссылочная группа | Подгруппа 1 | Подгруппа 2 | Подгруппа 3 | Команда |
|---|---|---|---|---|
| network | application-gateway | private-link | ip-config | add |
Полный список ссылочных команд см. в разделе Справочный список от A до Z .
Что такое ссылочный тип?
Команды Azure CLI являются частью основной службы Azure CLI или расширением. Расширения — это необязательные надстройки. Ссылочный тип определяет расписание выпуска, состояние и метод установки, как описано здесь:
| Термин | Основные сведения | Расширение |
|---|---|---|
| Справочные материалы | Являются частью основной службы Azure CLI. | Являются необязательными командами ссылки, которые должны быть установлены. |
| Установка | Совместно с помощью установщика MSI. | Отдельно с помощью az extension add. |
| Выпущено | По расписанию. | По мере появления новых функций или обновлений. |
| Состояние | Могут иметь состояние общедоступной, предварительной или экспериментальной версии | Также могут быть общедоступными, предварительными или экспериментальными. |
Чтобы получить список групп команд, выполните команду 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, опубликованные как постоянная часть CLI, называются основными ссылками. Все основные ссылки устанавливаются с помощью Azure CLI, и вы не можете выбрать подмножество ссылок. Если вы запускаете CLI с помощью Azure Cloud Shell, основные ссылки всегда будут актуальными.
Расширение
Расширения не поставляются вместе с CLI, но выполняются в виде команд CLI. Некоторые расширения являются постоянной частью Azure CLI, но часто они предоставляют доступ к предварительным и экспериментальным командам. Отдельная ссылочная группа, например az iot hub, может включать команды основной службы и команды-расширения. Вот два примера.
| Команда полной ссылки | Основная команда | Команда расширения |
|---|---|---|
| az iot hub list | да | |
| az iot hub job list | Да |
При первом использовании вам будет предложено установить расширение. Вы также можете установить расширение, выполнив команду az extension add.
Сведения о расширениях, включая инструкции по их установке и обновлении, см. в статье Использование расширений с Azure CLI. Полный список команд расширения см. в статье Доступные расширения для Azure CLI.
Что такое состояние ссылки?
Независимо от ссылочного типа Azure CLI делятся на три категории состояния: общедоступная версия, общедоступная предварительная версия и экспериментальная версия. Это состояние ссылочной команды (а не тип), которое определяет стабильность и уровень поддержки.
| GA | Общедоступная предварительная версия | Экспериментальный | |
|---|---|---|---|
| Стабильность | Постоянно | Могут изменяться в ответ на отзывы клиентов. Регулируются условиями использования предварительных версий продуктов Microsoft Azure. | Могут изменяться в ответ на отзывы клиентов. Часто выполняет миграцию в общедоступную предварительную версию. Могут быть удалены. |
| Уровень поддержки | Полное | Partial | Нет |
Примечание
Предупреждения, информирующие об использовании общедоступной предварительной версии или экспериментальной версии, являются частью выходных данных команды Azure CLI и не должны вызывать беспокойство.
Большинство команд и параметров для одной ссылки имеют одно состояние, но не всегда. Общедоступная ссылка, которая создается для предоставления дополнительных команд, может иметь общедоступные, предварительные и экспериментальные версии команд ссылок. Кроме того, при добавлении новых параметров для повышения функциональности одна команда может иметь параметры, которые используются в разных категориях состояния. Ниже приведены примеры ссылок с разными состояниями.
| Команда полной ссылки | Параметры | Тип | GA | Общедоступная предварительная версия | Экспериментальный |
|---|---|---|---|---|---|
| az network dns zone list | Все | Основные сведения | да | ||
| az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Основные сведения | да | ||
| --newFutureParameter1 | Основные сведения | да | |||
| --newFutureParameter2 | Основные сведения | да | |||
| az network vhub list | Все | Расширение | да | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Расширение | да | ||
| --newFutureParameter1 | Расширение | да | |||
| --newFutureParameter2 | Расширение | да | |||
| az network firewall create | Все | Расширение | да |
Вышеприведенная таблица является только примером и не представляет актуальные справочные сведения.