Introdução à CLI do Azure

  • Artigo

Bem-vindo(a) à CLI (interface de linha de comando) do Azure! Este artigo apresenta a CLI e ajuda a concluir tarefas comuns.

Observação

Em scripts e no site de documentação da Microsoft, os exemplos da CLI do Azure são escritos para o shell bash. Os exemplos de uma linha serão executados em qualquer plataforma. Os exemplos mais longos, que incluem continuações da linha (\) ou a atribuição de variáveis precisam ser modificados para funcionar em outros shells, incluindo o PowerShell.

Instalar ou executar no Azure Cloud Shell

A maneira mais fácil de aprender a usar a CLI do Azure é executando-a em um ambiente do Azure Cloud Shell por meio do seu navegador. Para saber mais sobre o Cloud Shell, consulte Início Rápido para Bash no Azure Cloud Shell.

Quando você estiver pronto para instalar a CLI, confira as instruções de instalação.

Depois de instalar a CLI pela primeira vez, verifique se ela está instalada e se você tem a versão correta, executando az --version.

Observação

Se você estiver usando o modelo de implantação clássico do Azure, instale a CLI clássica do Azure.

Como entrar na CLI do Azure

Antes de usar os comandos da CLI do Azure com uma instalação local, é preciso entrar com az login.

  1. Execute o comando login.

    az login

    Se a CLI puder abrir seu navegador padrão, ela iniciará o fluxo do código de autorização e abrirá o navegador padrão para carregar uma página de entrada do Azure.

    Caso contrário, ela inicia o fluxo de código do dispositivo e informa a você para abrir uma página do navegador em https://aka.ms/devicelogin e inserir o código exibido em seu terminal.

    Se nenhum navegador da Web estiver disponível ou se houver falha ao abrir o navegador, você poderá forçar o fluxo de código do dispositivo com az login --use-device-code.

  2. Entre com suas credenciais de conta no navegador.

Depois de entrar, você deve ver uma lista de assinaturas associadas à sua conta do Azure. A informação de assinatura com isDefault: true é a assinatura ativada no momento depois de entrar. Para selecionar outra assinatura, use o comando az account set com a ID da assinatura para a qual alternar. Para obter mais informações sobre a seleção da assinatura, confira Usar várias assinaturas do Azure.

Há maneiras de entrar de modo não interativo, como mostrado em detalhes em Entrar com a CLI do Azure.

Comandos comuns da CLI do Azure

Esta tabela lista alguns comandos comuns usados na CLI e está vinculada à documentação de referência.

Tipo de recurso Grupo de comando da CLI do Azure
Grupo de recursos az group
Máquinas virtuais az vm
Contas de armazenamento az storage account
Key Vault az keyvault
Aplicativos Web az webapp
Bancos de dados SQL az sql server
CosmosDB az cosmosdb

Encontrando comandos

Os comandos da CLI do Azure são organizados como comandos de grupos. Cada grupo representa um serviço do Azure e os comandos operam nesse serviço.

Para procurar comandos, use az find. Por exemplo, para procurar nomes de comando que contenham secret, use o seguinte comando:

az find secret

Use o argumento --help para obter uma lista completa de comandos e subgrupos de um grupo. Por exemplo, para localizar os comandos da CLI para trabalhar com Grupos de Segurança de Rede (NSGs):

az network nsg --help

A CLI tem o preenchimento completo de guia para comandos sob o shell do Bash.

Argumentos disponíveis globalmente

Há alguns argumentos disponíveis para cada comando.

  • --help imprime as informações de referência da CLI sobre comandos e seus argumentos, além de listar os comandos e subgrupos disponíveis.
  • --output altera o formato de saída. Os formatos de saída disponíveis são json, jsonc(JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legível por humanos) e yaml. Por padrão, a CLI gera json. Para saber mais sobre os formatos de saída disponíveis, confira Formatos de saída da CLI do Azure.
  • --query usa o linguagem de consulta JMESPath para filtrar a saída retornada dos serviços do Azure. Para saber mais sobre as consultas, confira Consultar resultados do comando com a CLI do Azure e Tutorial do JMESPath.
  • --verbose imprime informações sobre recursos criados no Azure durante uma operação, além de outras informações úteis.
  • --debug imprime ainda mais informações sobre operações de CLI e é usado para fins de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.

Modo interativo

A CLI oferece um modo interativo que exibe informações de ajuda automaticamente e torna mais fácil selecionar subcomandos. Você entra no modo interativo com o comando az interactive.

az interactive

Para obter mais informações sobre o modo interativo, confira Modo interativo da CLI do Azure.

Também há um plug-in do Visual Studio Code que oferece uma experiência interativa, incluindo documentação de preenchimento automático e com o passar do mouse.

Aprenda as noções básica da CLI com os guias de início rápido e tutoriais

Para aprender a usar a CLI do Azure, experimente ver um tutorial aprofundado para configurar máquinas virtuais e usar o poder da CLI para consultar recursos do Azure.

Tutorial sobre como criar máquinas virtuais com a CLI do Azure

Também existem Inícios Rápido para outros serviços populares.

Envie comentários

Apreciamos seus comentários da CLI para ajudar-nos a melhorar e resolver bugs. Você pode arquivar um problema no GitHub ou usar os recursos internos da CLI para deixar um comentário geral com o comando az feedback.

az feedback

Confira também