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 qualquer coisa com a qual você lida no Azure.

A CLI (Interface de Command-Line do Azure) permite criar, persistir e definir grupos de recursos padrão do Azure. A CLI do Azure também permite limpar recursos depois que eles são criados.

Identificação da Região do Azure

Os clientes do Azure podem optar por implantar recursos em várias regiões diferentes. Às vezes, os clientes podem reduzir 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 para seleção em implantações futuras.

No exemplo a seguir, o az config comando é usado para desativar 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 está associado 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

Quando você cria um recurso, ele reside 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 contidos nele. 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.

Depois de executar o comando, os dois comandos a seguir fornecem 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 está associado a uma assinatura. Se sua organização tiver mais de uma assinatura, você deverá alterar para a assinatura desejada antes de trabalhar com um grupo de recursos nessa 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, consulte Bloquear recursos para evitar 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

Para ver os bloqueios atuais no seu grupo de recursos, use o comando az group lock list :

az group lock list --output table

Limpeza de recursos

Se você tentou qualquer um dos comandos neste artigo, você pode remover 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 seus recursos associados.

Ver também

• Configuração da CLI do Azure
• Gerir subscrições do Azure