Executar comandos da CLI do Azure interativamente

6 minutos

No modo interativo, a CLI do Azure permite que você insira e execute comandos imediatamente. Se você só precisa criar alguns recursos do Azure , executar manualmente os comandos da CLI do Azure é uma escolha razoável.

Criar uma conta de armazenamento com a CLI do Azure

Vamos executar uma tarefa comum: criar uma conta de Armazenamento do Azure. Aqui estão os quatro passos que você precisa seguir:

Conecte-se ao Azure usando o az login.
Trabalhar com assinaturas do Azure usando o az account.
Crie um grupo de recursos (se necessário) usando az group createo .
Crie uma conta de armazenamento usando az storage account createo .

Etapa 1: Conectar-se ao Azure

Como você está trabalhando com uma instalação local da CLI do Azure , precisa 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 da 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ê estará conectado à sua assinatura do Azure.

Importante

A partir de 2025, a Microsoft impõe a autenticação multifator (MFA) 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 . Eles não afetam identidades de carga de trabalho, como principais de serviço e identidades geridas.

Passo 2: Verificar a sua subscrição

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 pretender alterar a sua subscrição predefinida:

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 os recursos do Azure organizados e ajudam-no a gerir a segurança e os custos. Os nomes dos grupos de recursos devem ser exclusivos dentro de uma assinatura e receber uma localização geográfica.

Descubra 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>

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órios permite que você teste um script repetidamente sem ter que esperar que o grupo de recursos do teste anterior seja excluído.
```
# 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 criado na etapa anterior. Os nomes das contas 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

Sugestão

A barra invertida (\) é o caractere de continuação de linha em Bash. Ele permite que você divida comandos longos em 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.

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
```

Se você tiver várias contas de armazenamento, filtre os valores de retorno 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 cadeia de caracteres do parâmetro --query usando JMESPath, que é uma linguagem de consulta padrão para requisições JSON. Saiba mais em JMESPath Tutorial.

Limpeza de recursos

Usar IDs aleatórios 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, quando você exclui um grupo de recursos, exclui todos os objetos dentro do grupo, por isso é 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

Sugestão

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 executadas 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.

Comentários

Esta página foi útil?