概述:Azure CLI 引用类型和状态

Azure CLI 具有不同的引用类型,它们在描述上有时可与引用状态互换。 本文说明了 Azure CLI 类型与状态之间的区别,还介绍了如何使用这两者。

Azure CLI 语法组件

Azure CLI 语法是引用、命令和参数的组合。 完整引用命令常被称为“命令”。

Azure 服务 参考 引用子服务 命令 完整引用命令 参数示例
Azure CLI az configure az configure --defaults、--list-default、--scope
Azure 网络 az network application-gateway create az network application-gateway create --name、--resource-group、--capacity
Azure DevOps Server az pipelines 代理 list az pipelines agent list --pool-id、--agent-name、--demands

引用类型

可通过引用类型了解引用命令是否是主要 Azure CLI 服务的一部分,以及它是否是可选的加载项。 有两种类型的 Azure CLI 引用命令:核心和扩展 core

核心 扩展
参考 是主要 Azure CLI 服务的一部分 是必须安装的可选引用命令
安装 MSI 安装程序结合使用 通过 az extension add 单独使用
已发布 制定计划时 在新功能或更新可用时
Status 可以是 GA(正式发布)、预览版或试验版 也可以是通用版、预览版或试验版

所有 Azure CLI 引用都可在 Windows、macOS、Linux、Docker 中运行。

核心

已作为 CLI 的永久组成部分发布的 Azure CLI 引用被称为“核心引用”。 所有核心引用均使用 Azure CLI 进行安装,你无法只选择其中部分引用。有关核心引用命令的完整列表,请参阅 Azure CLI 的核心引用列表

扩展

扩展不作为 CLI 的一部分传递,而是作为 CLI 命令运行。 某些扩展是 Azure CLI 的永久组成部分,但通常的情况是,扩展让你能够访问个人预览版和试验版的命令。 一个引用(例如 az iot hub)可以既是核心命令,又是扩展命令。 下面是 4 个示例:

完整引用命令 是核心 是扩展
az iot hub list
az iot hub query
az iot hub certificate create
az iot hub device identify create

Important

使用之前,必须运行 az extension add 命令来安装扩展。

要详细了解扩展引用(包括安装和更新),可参阅将扩展与 Azure CLI 结合使用。 查看扩展 wiki 提示,实现最大限度的使用。 有关扩展引用命令的完整列表,请参阅 Azure CLI 的可用扩展

引用状态

无论类型如何,Azure CLI 引用都分为下面 3 种状态类别:通用版、公共预览版或试验版 。 它是引用命令状态,不是类型,用于确定稳定性和支持级别。

GA 公共预览版 实验
稳定性 永久性 可根据客户反馈更改。 需遵守 Microsoft Azure 预览版的条款。 可根据客户反馈更改。 常会迁移到公共预览版。 可删除。
支持级别 完全 部分

虽然一个引用的大多数命令和参数都有一个状态,但并不总是如此。 根据构建可提供更多命令的 GA 引用可具有 GA、预览版和试验版引用命令。 随着添加新参数来增加功能,一个命令也可具有属于不同状态类别的参数。 下面是具有不同状态的示例引用:

完整引用命令 参数 类型 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 全部 扩展

Note

指示是公共预览版还是试验版的警告是 Azure CLI 命令输出的一部分,应该是预期内容 。

另请参阅