Como gerenciar grupos de recursos do Azure com a CLI do Azure
Um grupo de recursos do Azure é um contêiner que contém recursos relacionados para 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ê lida no Azure.
A CLI (Interface de Linha de Comando) do Azure permite criar, persistir e definir grupos de recursos padrão do Azure. A CLI também permitirá que você limpe os recursos depois de criá-los.
Identificação da Região do Azure
Os clientes do Azure podem optar por implantar recursos em muitas 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 exemplo a seguir, o az config comando é usado para desabilitar a mensagem de recomendação de região:
az config set core.display_region_identified=no
Para obter mais informações sobre as regiões do Azure, consulte Escolher a região do Azure certa para você.
Criar um grupo de recursos
Para criar um grupo de recursos, utilize o comando az group create:
az group create --name MyResourceGroup --location eastus
Um grupo de recursos pertence a um único local. Para ver todos os locais suportados na sua subscrição atual, execute o comando az account list-locations :
az account list-locations
Para ver todos os grupos de recursos da sua assinatura atual, use o comando az group list :
az group list --output table
Gorjeta
O --output parâmetro é um parâmetro global, disponível para todos os comandos. O valor da tabela apresenta a saída em um formato amigável. Para obter mais informações, consulte Formatos de saída para comandos da CLI do Azure.
Ao criar um recurso, você o cria em um grupo de recursos. O exemplo a seguir mostra uma conta de armazenamento criada usando 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. Não é possível anular esta ação. Se você tentar qualquer um dos comandos neste artigo, excluir os grupos de recursos criados limpará sua conta.
Definir um grupo de recursos padrão
Você pode definir um grupo de recursos padrão para todos os comandos executados a partir da CLI do Azure local ou do Azure Cloud Shell. A CLI do Azure armazena essa configuração localmente em um arquivo de configuração . Para ver sua configuração atual, execute o comando az config get :
az config get
O resultado mostra grupos de recursos padrão e outros valores padrão. Se você estiver usando a CLI do Azure pela primeira vez, os resultados podem estar vazios.
Para definir um grupo de recursos padrão para sua 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, consulte Configuração da CLI do Azure.
Nota
O comando az config set não valida a existência do grupo de recursos inserido. O comando simplesmente armazena o par chave-valor.
Depois de executar o comando, os dois comandos a seguir forneceriam 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 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 várias assinaturas, consulte Usar várias assinaturas do Azure.
Não é necessário 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 é apenas para você. Isso não afeta outros usuários ou 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 de configuração .
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, veja 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
Nota
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
Clean up resources (Limpar recursos)
Se você tentou qualquer um dos comandos neste artigo, você pode remover todos os recursos que você criou usando o comando az group delete :
az group delete --name MyResourceGroup
az group delete --name OtherResourceGroup
az group delete --name StorageGroups
Este comando remove o grupo e todos os recursos que ele contém de uma só vez.