Executar comandos da CLI do Azure interativamente

Concluído

No modo interativo, a CLI do Azure permite que você insira e execute comandos imediatamente. Se você precisar criar apenas alguns recursos do Azure , executar comandos da CLI do Azure manualmente é uma opção razoável.

Criar uma conta de armazenamento com a CLI do Azure

Vamos executar uma tarefa comum: criar uma conta de Armazenamento do Azure. Estas são as quatro etapas que você precisa seguir:

  1. Conectar-se ao Azure usando az login.

  2. Trabalhe com assinaturas do Azure usando az account.

  3. Criar um grupo de recursos (se necessário) usando az group create.

  4. Criar uma conta de armazenamento usando az storage account create.

Etapa 1: Conectar-se ao Azure

Como você está trabalhando com uma instalação local da CLI do Azure , você precisa se autenticar antes de executar comandos do Azure . Entre no Azure usando o az login comando:

az login

A CLI do Azure normalmente inicia seu navegador padrão para abrir a página de entrada do Azure.

Se não funcionar, siga as instruções de linha de comando e insira um código de autorização na caixa de diálogo Inserir Código .

Após uma entrada bem-sucedida, você está conectado à sua assinatura do Azure.

Importante

A partir de 2025, a Microsoft impõe a MFA (autenticação multifator) obrigatória para a CLI do Azure e outras ferramentas de linha de comando. Os novos requisitos de MFA afetam as identidades de usuário do Microsoft Entra ID . Elas não afetam identidades de carga de trabalho, como principais de serviço e identidades gerenciadas.

Etapa 2: Verificar sua assinatura

Se você tiver permissões para várias assinaturas do Azure, verifique sua assinatura padrão:

az account show --output table
EnvironmentName    HomeTenantId                          IsDefault    Name                               State    TenantId
-----------------  ------------------------------------  -----------  ---------------------------------  -------  ------------------------------------
AzureCloud         aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e  True         My Production Subscription         Enabled  aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e

Se você quiser alterar sua assinatura padrão:

az account set --subscription "the name of a different subscription or subscription ID"

Etapa 3: Criar um grupo de recursos

Um grupo de recursos do Azure é um contêiner para recursos do Azure. Os grupos de recursos mantêm seus recursos do Azure organizados e ajudam você a gerenciar a segurança e os custos. Os nomes do grupo de recursos devem ser exclusivos em uma assinatura e receber uma localização geográfica.

  1. Localize quais locais do Azure estão disponíveis para sua assinatura padrão:

    az account list-locations --output table
    
    DisplayName               Name                 RegionalDisplayName
    ------------------------  -------------------  -------------------------------------
    East US                   eastus               (US) East US
    South Central US          southcentralus       (US) South Central US
    West US 2                 westus2              (US) West US 2
    West US 3                 westus3              (US) West US 3
    Australia East            australiaeast        (Asia Pacific) Australia East
    ... <more regions here>
    
  2. Crie um grupo de recursos usando variáveis:

    Como este módulo é avançado, vamos começar a usar identificadores aleatórios e variáveis Bash . O uso de IDs aleatórias permite que você teste um script repetidamente sem precisar aguardar a exclusão do grupo de recursos do teste anterior.

    # Variable block
    let "randomIdentifier=$RANDOM*$RANDOM"
    location="westus2"
    resourceGroup="msdocs-rg-$randomIdentifier"
    
    # Create the resource group
    az group create --name $resourceGroup --location $location --output json
    

Etapa 4: Criar uma conta de armazenamento

Usando o grupo de recursos que você criou, crie uma conta de armazenamento. Substitua <msdocs-rg-0000000> pelo nome do grupo de recursos que você criou na etapa anterior. Os nomes da conta de armazenamento só podem conter letras minúsculas e números.

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="westus2"
resourceGroup="<msdocs-rg-0000000>"
storageAccount="msdocssa$randomIdentifier"

# Create the storage account
echo "Creating storage account $storageAccount in resource group $resourceGroup"
az storage account create --name $storageAccount \
                          --resource-group $resourceGroup \
                          --location $location \
                          --sku Standard_RAGRS \
                          --kind StorageV2 \
                          --output json

Dica

A barra invertida (\) é o caractere de continuação de linha no Bash. Ele permite dividir comandos longos entre várias linhas para melhor legibilidade.

Etapa 5: Verificar a criação de recursos

Para a maioria dos grupos de comandos do Azure , a CLI do Azure fornece list e show comandos para obter detalhes do recurso.

  1. Verifique se sua nova conta de armazenamento foi criada:

    az storage account list
    

    Para obter informações mais concisas, você pode formatar a saída como uma tabela simples:

    az storage account list --output table
    
  2. Se você tiver várias contas de armazenamento, filtre os valores retornados usando o --query parâmetro:

    # Get a list of all storage accounts created in the last 30 days
    saDate=$(date +%F -d "-30days")
    az storage account list --resource-group <msdocs-rg-00000000> \
        --query "[?creationTime >='$saDate'].{saName:name, saID: id, sku: sku.name}"
    
    # Get a list of all storage accounts that contain the word 'msdocs'
    az storage account list --resource-group $rgName \
        --query "[?contains(name, 'msdocs')].{saName:name, saKind:kind, saPrimaryLocation:primaryLocation, createdTimeStamp:creationTime}" \
        --output table
    

Observação

Formate a --query cadeia de caracteres de parâmetro usando JMESPath, que é uma linguagem de consulta padrão para solicitações JSON. Saiba mais no Tutorial do JMESPath.

Limpar os recursos

Usar IDs aleatórias e executar essas etapas de módulo cria grupos de recursos de teste que podem ser removidos. A maneira mais fácil de limpar os recursos do Azure é excluir o grupo de recursos. No entanto, ao excluir um grupo de recursos, você exclui todos os objetos dentro do grupo, portanto, é importante excluir o nome correto do grupo de recursos !

# Get a list of resource groups in the active subscription
az group list --output table

# Delete a resource group and do not wait for the operation to finish
az group delete --name <msdocs-rg-0000000> --no-wait

Dica

O --no-wait parâmetro permite que a operação de exclusão seja executada em segundo plano, liberando a linha de comando para outras tarefas.

Tarefas complexas ou repetitivas podem ser demoradas e propensas a erros quando feitas manualmente. Muitas organizações preferem automatizar essas tarefas para reduzir custos e evitar erros. Usar um script da CLI do Azure para automatizar a criação de recursos do Azure é muito mais eficiente e confiável do que criá-los manualmente um de cada vez.