Introducción a la CLI de Azure

  • Artículo

Le damos la bienvenida a la interfaz de la línea de comandos de Azure (CLI). En este artículo se presenta la CLI y se facilita ayuda sobre la realización de tareas comunes.

Nota

En los scripts y en el sitio de documentación de Microsoft, los ejemplos de la CLI de Azure están escritos para el shell de bash. Los ejemplos de una línea funcionarán en cualquier plataforma. Los ejemplos más largos que incluyan continuaciones de línea (\) o asignación de variables deben modificarse para que funcionen en otros shells, incluido PowerShell.

Instalación o ejecución en Azure Cloud Shell

La manera más fácil de aprender a usar la CLI de Azure es ejecutarla en un entorno de Azure Cloud Shell en su explorador. Para más información acerca de Cloud Shell, consulte Guía de inicio rápido para Bash en Azure Cloud Shell.

Cuando esté listo para instalar la CLI, consulte las instrucciones de instalación.

Después de instalar la CLI por primera vez, ejecute az --version para comprobar que está instalada y que tiene la versión correcta.

Nota

Si usa el modelo de implementación clásico de Azure, instale la CLI clásica de Azure.

Inicio de sesión en la CLI de Azure

Antes de usar los comandos de la CLI de Azure en una instalación local, deberá iniciar sesión con az login.

  1. Ejecute el comando login.

    az login

    Si la CLI puede abrir el explorador predeterminado, iniciará el flujo de código de autorización y abrirá el explorador predeterminado para cargar una página de inicio de sesión de Azure.

    De lo contrario, iniciará el flujo de código de dispositivo y le indicará que abra una página del explorador en https://aka.ms/devicelogin y escriba el código que se muestra en el terminal.

    Si no hay ningún explorador web disponible o no se puede abrir el explorador web, es posible que tenga que forzar el flujo de código de dispositivo con az login --use-device-code.

  2. Inicie sesión con las credenciales de su cuenta en el explorador.

Después de iniciar sesión, verá una lista de suscripciones asociadas con su cuenta de Azure. La información de suscripción con isDefault: true es la suscripción actualmente activada después de iniciar sesión. Para seleccionar otra suscripción, utilice el comando az account set con el identificador de suscripción al que desea cambiar. Para más información sobre la selección de suscripción, consulte Uso de varias suscripciones de Azure.

Hay varias formas de iniciar sesión de una manera no interactiva, que se describen con detalle en Inicio de sesión con la CLI de Azure.

Comandos comunes de la CLI de Azure

En esta tabla se enumeran algunos comandos comunes utilizados en la CLI, así como vínculos a documentación de referencia.

Tipo de recurso Grupo de comandos de la CLI de Azure
Grupos de recursos az group
Máquinas virtuales az vm
Cuentas de almacenamiento az storage account
Key Vault az keyvault
Aplicaciones web az webapp
Bases de datos SQL az sql server
CosmosDB az cosmosdb

Búsqueda de comandos

Los comandos de la CLI de Azure se organizan como comandos de grupos. Cada grupo representa un servicio de Azure y los comandos funcionan en ese servicio.

Para buscar comandos, utilice az find. Por ejemplo, para buscar nombres de comando que contienen secret, use el siguiente comando:

az find secret

Use el argumento --help para obtener una lista completa de los comandos y los subgrupos de un grupo. Por ejemplo, para encontrar los comandos de la CLI para trabajar con grupos de seguridad de red (NSG):

az network nsg --help

La CLI dispone de la función de autocompletar con el tabulador para los comandos en el shell de bash.

Argumentos disponibles globalmente

Hay algunos argumentos que están disponibles para todos los comandos.

  • --help imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los comandos y subgrupos disponibles.
  • --output cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), table (tablas ASCII en lenguaje natural) y yaml. De forma predeterminada, la CLI genera json. Para más información sobre los formatos de salida disponibles, consulte Formatos de salida de la CLI de Azure.
  • --query usa el lenguaje de consulta JMESPath para filtrar los resultados devueltos por los servicios de Azure. Para más información sobre las consultas, vea Consulta de los resultados de los comandos con la CLI de Azure y Tutorial de JMESPath.
  • --verbose imprime información acerca de los recursos creados en Azure durante una operación y otra información de utilidad.
  • --debug imprime más información aún sobre las operaciones de la CLI y se utiliza con fines de depuración. Si encuentra un error, proporcione la salida que se genera con la marca --debug activada al enviar un informe de errores.

Modo interactivo

La CLI ofrece un modo interactivo que muestra automáticamente información de ayuda y facilita la selección de subcomandos. Puede entrar en el modo interactivo con el comando az interactive.

az interactive

Para más información sobre el modo interactivo, consulte Modo interactivo de la CLI de Azure.

También hay un complemento de Visual Studio Code que ofrece una experiencia interactiva, incluida la función de autocompletar y documentación al pasar el ratón.

Conozca los aspectos básicos de la CLI con las guías de inicio rápido y los tutoriales

Para aprender a usar la CLI de Azure, pruebe con un tutorial exhaustivo sobre cómo configurar máquinas virtuales y usar todas las posibilidades que ofrece la CLI para consultar los recursos de Azure.

Creación de máquinas virtuales con la CLI de Azure

También hay guías de inicio rápido para otros servicios populares.

Proporcionar comentarios

Le agradecemos sus comentarios sobre la CLI para ayudarnos a mejorar y resolver errores. También puede informar de un problema en GitHub o utilizar las características integradas de la CLI para dejar comentarios generales con el comando az feedback.

az feedback

Consulte también