Como gerenciar os grupos de recursos do Azure com a CLI do Azure
Um grupo de recursos do Azure é um contêiner que mantém os recursos relacionados a uma solução do Azure. Um grupo de recursos pode conter armazenamento, máquinas virtuais, aplicativos, painéis, serviços ou quase tudo o que você usa no Azure.
A CLI (Interface de Linha de Comando) do Azure permite criar, persistir e definir grupos de recursos padrão no Azure. A CLI também permite que você limpe os recursos após criá-los.
Identificação de região do Azure
Os clientes do Azure podem optar por implantar recursos em várias regiões diferentes. Em alguns casos, os clientes podem reduzir os custos selecionando regiões próximas que oferecem os mesmos serviços. Se uma região próxima for identificada, uma mensagem exibirá a região a ser selecionada para implantações futuras.
No seguinte exemplo, o comando az config é usado para desabilitar a mensagem de recomendação de região:
az config set core.display_region_identified=no
Para saber mais sobre as regiões do Azure, confira Escolher a região do Azure certa para você.
Criar um grupo de recursos
Para criar um grupo de recursos, use o comando az group create:
az group create --name MyResourceGroup --location eastus
Um grupo de recursos pertence a uma só localização. Para ver todas as localizações com suporte na sua assinatura atual, execute o comando az account list-locations:
az account list-locations
Para ver todos os grupos de recursos para a sua assinatura atual, use o comando az group list:
az group list --output table
Dica
O parâmetro --output é um parâmetro global, disponível para todos os comandos. O valor table apresenta a saída em um formato amigável. Para obter mais informações, confira Formatos de saída para comandos da CLI do Azure.
Ao criar um recurso, você o cria em um grupo de recursos. O seguinte exemplo mostra a criação de uma conta de armazenamento com o comando az storage account create:
az storage account create --resource-group MyResourceGroup --name storage134 --location eastus --sku Standard_LRS
Para remover um grupo de recursos, execute o comando az group delete:
az group delete --name MyResourceGroup
Ao remover um grupo de recursos, você exclui todos os recursos que pertencem a ele. Esta ação não pode ser desfeita. Se você testar um dos comandos deste artigo, a exclusão dos grupos de recursos criados limpará a sua conta.
Definir um grupo de recursos padrão
Você pode definir um grupo de recursos padrão para todos os comandos executados da CLI do Azure local ou do Azure Cloud Shell. A CLI do Azure armazena essa configuração localmente em um arquivo config. Para ver a configuração atual, execute o comando az config get:
az config get
O resultado mostra os grupos de recursos padrão e outros valores padrão. Se você estiver usando a CLI do Azure pela primeira vez, os resultados poderão estar vazios.
Para definir um grupo de recursos padrão para a instalação da CLI do Azure, execute o comando az config set:
az config set defaults.group=MyResourceGroup
O comando define um valor para uma chave especificada, neste caso, defaults.group. Para obter as opções de configuração disponíveis, confira Configuração da CLI do Azure.
Observação
O comando az config set não valida a existência do grupo de recursos inserido. O comando apenas armazena o par chave-valor.
Depois que você executar o comando, os dois seguintes comandos fornecerão o mesmo resultado:
az storage account create --resource-group MyResourceGroup --name storage01 --location eastus --sku Standard_LRS
az storage account create --name storage01 --location eastus --sku Standard_LRS
Um grupo de recursos pertence a uma assinatura. Se a sua organização tiver mais de uma assinatura, você precisará definir essa assinatura antes de trabalhar com um grupo de recursos na assinatura. Se o valor padrão de um grupo de recursos não pertencer à sua assinatura atual, ocorrerá um erro. Para obter mais informações sobre o uso de várias assinaturas, confira Usar várias assinaturas do Azure.
Você não precisa redefinir o padrão para usar outros grupos de recursos. Em vez disso, especifique o grupo de recursos:
az group create --name OtherResourceGroup --location eastus
az storage account create --resource-group StorageGroups --name storage03 --location westus --sku Standard_LRS
O valor padrão destina-se apenas a você. Ele não afetará outros usuários ou as alterações feitas por meio do portal do Azure.
Se você estiver usando valores de parâmetros persistentes, conforme descrito neste artigo, esses valores terão precedência sobre os padrões definidos no arquivo config.
Definir um bloqueio de grupo de recursos
Como administrador, talvez seja necessário bloquear um grupo de recursos para impedir que os usuários o excluam ou modifiquem. Para obter mais informações, confira Bloquear recursos para impedir alterações inesperadas.
Na CLI do Azure, use os comandos az group lock . Por exemplo, o comando az account lock create pode impedir que os usuários excluam um grupo de recursos:
az group lock create --name "Cannot delete resource group" --lock-type CanNotDelete
Observação
Você precisa ter contributor permissões em um grupo de recursos para criar ou alterar bloqueios.
Para ver os bloqueios atuais no seu grupo de recursos, use o comando az group lock list :
az group lock list --output table
Limpar os recursos
Se você testou um dos comandos deste artigo, remova todos os recursos criados com o comando az group delete:
az group delete --name MyResourceGroup
az group delete --name OtherResourceGroup
az group delete --name StorageGroups
Esse comando remove o grupo e todos os recursos que ele contém ao mesmo tempo.