Associar uma VM a um grupo de reserva de capacidade

Aplica-se a: ✔️ Máquinas Virtuais do Windows ✔️ Máquinas Virtuais do Linux

Os grupos de reserva de capacidade podem ser usados com máquinas virtuais novas ou existentes. Para saber mais sobre Reservas de Capacidade, confira o artigo de visão geral.

Associar uma nova VM

Para associar uma nova VM ao grupo de Reserva de Capacidade, o grupo deve estar referenciado explicitamente como uma propriedade da máquina virtual. Essa referência protege a reserva correspondente no grupo para cargas de trabalho e aplicativos destinados a usá-la.

API

Para adicionar a propriedade capacityReservationGroup a uma VM, construa a seguinte solicitação PUT para o provedor Microsoft.Compute:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}?api-version=2021-04-01

No corpo da solicitação, inclua a propriedade capacityReservationGroup:

{ 
  "location": "eastus", 
  "properties": { 
    "hardwareProfile": { 
      "vmSize": "Standard_D2s_v3" 
    }, 
    … 
   "capacityReservation":{ 
    "capacityReservationGroup":{ 
        "id":"subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/CapacityReservationGroups/{CapacityReservationGroupName}" 
    } 
    "storageProfile": { 
    … 
    }, 
    "osProfile": { 
    … 
    }, 
    "networkProfile": { 
     …     
    } 
  } 
} 

Portal

1. Abra o portal do Azure
2. Digite máquina virtual na barra de pesquisa
3. Em Serviços, selecione Máquinas virtuais
4. Na página Máquinas virtuais, selecione Criar e, em seguida, Máquina virtual
5. Na guia de Informações básicas, em Detalhes do projeto, selecione a assinatura correta e, em seguida, escolha entre criar um novo grupo de recursos ou usar um grupo existente
6. Em Detalhes da instância, digite o Nome da máquina virtual e escolha a sua Região
7. Escolha uma imagem e o tamanho da VM
8. Em Conta de administrador, forneça um nome de usuário e uma senha
   1. A senha deve ter no mínimo 12 caracteres e atender aos requisitos de complexidade definidos
9. Acesse a seção Avançado
10. Na lista suspensa de Reservas de Capacidade, selecione o grupo de Reserva de Capacidade ao qual você deseja que a VM seja associada
11. Selecione o botão Revisar + Criar
12. Após a execução da validação, selecione o botão Criar
13. Depois da conclusão da implantação, selecione Ir para o recurso

CLI

Use az vm create para criar uma nova VM e adicione a propriedade capacity-reservation-group para associá-la a um grupo de Reserva de Capacidade existente. O exemplo a seguir cria uma VM Standard_D2s_v3 na localização Leste dos EUA e associa a VM a um grupo de reserva de capacidade.

az vm create 
--resource-group myResourceGroup 
--name myVM 
--location eastus 
--size Standard_D2s_v3 
--image Ubuntu2204 
--capacity-reservation-group /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}

PowerShell

Use New-AzVM para criar uma nova VM e adicione a propriedade CapacityReservationGroupId para associá-la a um grupo de Reserva de Capacidade existente. O exemplo a seguir cria uma VM Standard_D2s_v3 no local Leste dos EUA e associa a VM a um grupo de Reserva de Capacidade.

New-AzVm
-ResourceGroupName "myResourceGroup"
-Name "myVM"
-Location "eastus"
-VirtualNetworkName "myVnet"
-SubnetName "mySubnet"
-SecurityGroupName "myNetworkSecurityGroup"
-PublicIpAddressName "myPublicIpAddress"
-Size "Standard_D2s_v3"
-CapacityReservationGroupId "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}"

Para saber mais, acesse o comando New-AzVM do Azure PowerShell.

Modelo de ARM

Um modelo ARM é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do projeto. O modelo usa a sintaxe declarativa. Na sintaxe declarativa, você descreve a implantação pretendida sem gravar a sequência de comandos de programação para criar a implantação.

Os modelos do Resource Manager permitem implantar grupos de recursos relacionados. Em um único modelo, você pode criar Reservas de capacidade e o grupo de Reservas de Capacidade. Você pode implantar modelos por meio do portal do Azure, da CLI do Azure ou do Azure PowerShell ou de pipelines de CI/CD ( integração contínua/entrega contínua).

Associar uma VM existente

Para a versão inicial da reserva de capacidade, uma máquina virtual precisa ser alocada a uma reserva de capacidade.

• Se ainda não estiver concluído, siga as diretrizes para criar um grupo de reserva de capacidade e uma reserva de capacidade. Ou, então, incremente a quantidade de uma reserva de capacidade existente para que haja capacidade reservada não utilizada.
• Desaloque a VM.
• Atualize a propriedade do grupo de reserva de capacidade na VM.
• Reinicie a VM.

API

1. Desaloque a VM.

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroupname}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}/deallocate?api-version=2021-04-01
   

2. Adicione a propriedade capacityReservationGroup à VM. Construa a seguinte solicitação PUT para o provedor Microsoft.Compute:

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}?api-version=2021-04-01
   

   No corpo da solicitação, inclua a propriedade capacityReservationGroup:

   {
   "location": "eastus",
   "properties": {
       "capacityReservation": {
           "capacityReservationGroup": {
               "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}"
           }
       }
   }
   }
   

Portal

1. Abra o portal do Azure
2. Acesse a sua máquina virtual
3. Selecione Visão geral
4. Selecione Parar na parte superior da página para desalocar a VM
5. Vá para Configurações à esquerda
6. Na lista suspensa de grupo de Reservas de Capacidade, selecione o grupo ao qual você deseja que a VM seja associada

CLI

1. Desalocar a VM

   az vm deallocate 
   -g myResourceGroup 
   -n myVM
   

2. Associar uma VM a um grupo de Reserva de Capacidade

   az vm update 
   -g myresourcegroup 
   -n myVM 
   --capacity-reservation-group subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}
   

PowerShell

1. Desalocar a VM

   Stop-AzVM
   -ResourceGroupName "myResourceGroup"
   -Name "myVM"
   

2. Associar uma VM a um grupo de Reserva de Capacidade

   $VirtualMachine =
   Get-AzVM
   -ResourceGroupName "myResourceGroup"
   -Name "myVM"
   
   Update-AzVM
   -ResourceGroupName "myResourceGroup"
   -VM $VirtualMachine
   -CapacityReservationGroupId "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}"
   

Para saber mais, acesse os comandos do Azure PowerShell Stop-AzVM, Get-AzVM e Update-AzVM.

Exibir Associação de VM com exibição de instância

Depois que a propriedade capacityReservationGroup estiver definida, passará a existir uma associação entre a VM e o grupo. O Azure localiza automaticamente a reserva de capacidade correspondente no grupo e consome um slot reservado. A Exibição de Instância da Reserva de Capacidade vai refletir o novo conjunto de dimensionamento de VMs na propriedade virtualMachinesAllocated:

API

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/CapacityReservationGroups/{capacityReservationGroupName}?$expand=instanceView&api-version=2021-04-01 

{
   "name":"{CapacityReservationGroupName}",
   "id":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}",
   "type":"Microsoft.Compute/capacityReservationGroups",
   "location":"eastus",
   "properties":{
      "capacityReservations":[
         {
            "id":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/ {CapacityReservationGroupName}/capacityReservations/{CapacityReservationName}"
         }
      ],
      "virtualMachinesAssociated":[
         {
            "id":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{myVM}"
         }
      ],
      "instanceView":{
         "capacityReservations":[
            {
               "name":"{CapacityReservationName}",
               "utilizationInfo":{
                  "virtualMachinesAllocated":[
                     {
                        "id":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{myVM}"
                     }
                  ]
               },
               "statuses":[
                  {
                     "code":"ProvisioningState/succeeded",
                     "level":"Info",
                     "displayStatus":"Provisioning succeeded",
                     "time":"2021-05-25T15:12:10.4165243+00:00"
                  }
               ]
            }
         ]
      }
   }
} 

CLI

az capacity reservation show 
-g myResourceGroup
-c myCapacityReservationGroup 
-n myCapacityReservation 

PowerShell

$CapRes=
Get-AzCapacityReservation
-ResourceGroupName <"ResourceGroupName">
-ReservationGroupName] <"CapacityReservationGroupName">
-Name <"CapacityReservationName">
-InstanceView

$CapRes.InstanceView.Utilizationinfo.VirtualMachinesAllocated

Para saber mais, acesse o comando Get-AzCapacityReservation do Azure PowerShell.

Portal

1. Abra o portal do Azure
2. Acesse o grupo de Reserva de Capacidade
3. Selecione Recursos em Configurações à esquerda
4. Examine a tabela para ver todas as VMs associadas ao grupo de Reserva de Capacidade

Próximas etapas

Remover uma associação de VMs a um grupo de Reserva de Capacidade