Compartir a través de

Información general: terminología de la CLI de Azure y niveles de soporte técnico

En este artículo se explican las terminologías de la CLI de Azure. Hay componentes de sintaxis, tipos de referencia y estados.

Componentes de sintaxis de la CLI de Azure

La sintaxis de la CLI de Azure es una combinación de grupos, referencias, comandos y parámetros. A menudo, el comando de referencia completa se conoce como comando.

Servicio de Azure Grupo de referencia Subgrupos de referencia Comando Comando de referencia completa Ejemplos de parámetros
CLI de Azure az config az config --local, --output -o
Red de Azure az network puerta de enlace de aplicaciones crear az network application-gateway create - comando asociado con los servicios de red de Azure --name, --resource-group, --capacity
Azure DevOps az pipelines agente lista lista de agentes de az pipelines --pool-id, --agent-name, --demand

Un subgrupo de referencia puede tener varios niveles, como az network application-gateway private-link ip-config add

Grupo de referencias Subgrupo 1 Subgrupo 2 Subgrupo 3 Comando
red puerta de enlace de aplicaciones enlace privado configuración de IP (ip-config) añadir

Consulte Lista de referencia A a Z para obtener una lista completa de comandos de referencia.

¿Qué es el tipo de referencia?

Los comandos de la CLI de Azure forman parte del servicio principal de la CLI de Azure o son una extensión. Las extensiones son complementos opcionales. El tipo de referencia determina la programación de versión, el estado y el método de instalación como se describe aquí:

Término Núcleo Extensión
Referencias Forman parte del servicio principal de la CLI de Azure Son comandos de referencia opcionales que se deben instalar.
Instalación Conjuntamente con el instalador MSI Individualmente con az extension add
Fecha de publicación Según una programación A medida que las nuevas características o actualizaciones estén disponibles
Estado Puede ser GA (generalmente disponible), versión preliminar o en desuso. También puede ser GA, en versión preliminar o en desuso.

Para obtener una lista de grupos de comandos, ejecute az. Para obtener una lista de extensiones, use los comandos az extension list-available --output table .

# Get list of all command groups
az

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

Núcleo

Las referencias de la CLI de Azure que se han publicado como parte permanente de la CLI se denominan referencias principales. Todas las referencias principales se instalan con la CLI de Azure y no se puede elegir un subconjunto de referencias. Si ejecuta la CLI desde Azure Cloud Shell, las referencias principales estarán siempre actualizadas.

Extensión

Las extensiones no se incluyen como parte de la CLI, pero se ejecutan como comandos de la CLI. Algunas extensiones son una parte permanente de la CLI de Azure, pero a menudo, una extensión le da acceso a comandos de vista previa y experimentales. Un único grupo de referencia, como az iot hub, puede tener comandos de núcleo y extensión. Estos son dos ejemplos:

Comando de referencia completa Es esencial Es una extensión
az iot hub list (lista los centros IoT) Sí
az lista de tareas del concentrador de iot Sí

Se le pedirá que instale una extensión al usarse por primera vez. También puede instalar una extensión ejecutando el comando az extension add .

Puede obtener más información sobre las referencias de extensión, incluida la instalación y actualización en Uso de extensiones con la CLI de Azure. Consulte Extensiones disponibles para la CLI de Azure para obtener una lista completa de los comandos de referencia de extensión.

¿Qué es el estado de referencia?

Independientemente del tipo de referencia, las referencias de la CLI de Azure se dividen en tres categorías de estado: GA (disponible con carácter general), versión preliminar pública o en desuso. Es el estado del comando de referencia (no tipo) que determina la estabilidad.

Disponibilidad general Versión preliminar pública Obsoleto
Estabilidad Permanente Puede cambiar en respuesta a los comentarios de los clientes. Está sujeto a los términos de las versiones preliminares de Microsoft Azure. Se quitará.

Nota:

Las advertencias que indican la versión preliminar pública o en desuso forman parte de la salida del comando de la CLI de Azure y deben esperarse.

La mayoría de los comandos y parámetros de una sola referencia tienen un único estado, pero no siempre. Una referencia de disponibilidad general (GA) que se está ampliando para ofrecer más comandos puede tener comandos de referencia tanto de disponibilidad general como de vista previa. A medida que se agregan nuevos parámetros para aumentar la funcionalidad, un único comando también puede tener parámetros que se encuentran en diferentes categorías de estado. Estas son las referencias de ejemplo que tienen diferentes estados:

Comando de referencia completa Parámetros Tipo Disponibilidad general Versión preliminar pública Obsoleto
az network dns zone list Todos Núcleo Sí
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Núcleo Sí
--existingParameter5 Núcleo Sí
--newParameter6 Núcleo Sí
az network vhub list Todos Extensión Sí
az network vhub create --address-prefix, --name, --resource-group (grupo de recursos), -vwan, --location (ubicación), --sku Extensión Sí
--existingParameter7 Extensión Sí
--newParameter8 Extensión Sí
az crear firewall de red Todos Extensión Sí

La tabla anterior es solo un ejemplo y no es representativa de los estados de referencia actuales para az network.

Consulte también