Remover a associação de uma VM de um grupo de reserva de capacidade

Este artigo orienta você pelas etapas necessárias para remover a associação de uma VM (máquina virtual) de um grupo de reserva de capacidade. Para saber mais sobre reservas de capacidade, confira a Visão geral sobre reserva de capacidade.

Como a VM e a reserva de capacidade subjacente ocupam a capacidade de forma lógica, o Azure impõe algumas restrições nesse processo para evitar estados de alocação ambíguos e erros inesperados.

Há duas maneiras de alterar uma associação:

• Desaloque a máquina virtual, altere a propriedade do grupo de reserva de capacidade e, opcionalmente, reinicie a VM.
• Atualize a quantidade reservada para zero e altere a propriedade do grupo de reserva de capacidade.

Desalocar a máquina virtual

A primeira opção é desalocar a máquina virtual, alterar a propriedade grupo de reserva de capacidade e, opcionalmente, reiniciar a VM.

API

1. Desaloque a máquina virtual:

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

2. Atualize a VM para remover a associação ao grupo de reserva de capacidade:

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

   No corpo da solicitação, defina a propriedade capacityReservationGroup como null para remover a associação da VM ao grupo:

    {
   "location": "eastus",
   "properties": {
       "capacityReservation": {
           "capacityReservationGroup": {
               "id":null
           }
       }
   }
   }
   

Portal

1. Abra o Portal do Azure.
2. Acesse sua VM e selecione Visão geral.
3. Selecione Interromper.
   • Você sabe que sua VM está desalocada quando o status estiver alterado para Interrompida (desalocada).
   • Neste ponto do processo, a VM ainda está associada ao grupo de reserva de capacidade. Essa associação é refletida na propriedade virtualMachinesAssociated da reserva de capacidade.
4. Selecione Configuração.
5. Defina o valor do Grupo de reserva de capacidade para Nenhum. A VM não está mais associada ao grupo de reserva de capacidade.

CLI

1. Desaloque a máquina virtual:

   az vm deallocate 
   -g myResourceGroup 
   -n myVM
   

   Depois que o status for alterado para Interrompida (desalocada), a VM será desalocada.

2. Atualize a VM para remover a associação ao grupo de reserva de capacidade definindo a propriedade capacity-reservation-group como None:

   az vm update 
   -g myresourcegroup 
   -n myVM 
   --capacity-reservation-group None
   

PowerShell

1. Desaloque a máquina virtual:

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

   Depois que o status for alterado para Interrompida (desalocada), a VM será desalocada.

2. Atualize a VM para remover a associação ao grupo de reserva de capacidade definindo a propriedade CapacityReservationGroupId como null:

   $VirtualMachine =
   Get-AzVM
   -ResourceGroupName "myResourceGroup"
   -Name "myVM"
   
   Update-AzVM
   -ResourceGroupName "myResourceGroup"
   -VM $VirtualMachine
   -CapacityReservationGroupId $null
   

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

Atualizar a quantidade reservada para zero

A segunda opção envolve atualizar a quantidade reservada para zero e, em seguida, alterar a propriedade do grupo de reserva de capacidade.

Essa opção funciona bem quando não é possível desalocar a VM e quando uma reserva não é mais necessária. Por exemplo, você pode criar uma reserva de capacidade para garantir a capacidade temporariamente durante uma implantação em grande escala. Após a conclusão, a reserva não será mais necessária.

API

1. Atualize a quantidade reservada para zero:

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

   No corpo da solicitação, inclua os seguintes parâmetros:

   {
   "sku":
       {
       "capacity": 0
       }
   }
   

   Observe que a propriedade capacity está definida como 0.

2. Atualize a VM para remover a associação ao grupo de reserva de capacidade.

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

   No corpo da solicitação, defina a propriedade capacityReservationGroup como null para remover a associação:

   {
   "location": "eastus",
   "properties": {
       "capacityReservation": {
           "capacityReservationGroup": {
               "id":null
           }
       }
   }
   } 
   

Portal

1. Abra o Portal do Azure.
2. Acesse o grupo de reserva de capacidade e selecione Visão Geral.
3. Selecione Reservas.
4. Selecione Gerenciar Reservas na parte superior da página.
5. No painel Gerenciar Reservas, insira 0 no campo Instâncias e selecione Salvar.
6. Vá para sua VM e selecione Configuração.
7. Defina o valor do Grupo de reserva de capacidade para Nenhum. A VM não está mais associada ao grupo de reserva de capacidade.

CLI

1. Atualize a quantidade reservada para zero:

   az capacity reservation update 
   -g myResourceGroup
   -c myCapacityReservationGroup 
   -n myCapacityReservation 
   --capacity 0
   

2. Atualize a VM para remover a associação ao grupo de reserva de capacidade definindo a propriedade capacity-reservation-group como None:

   az vm update 
   -g myresourcegroup 
   -n myVM 
   --capacity-reservation-group None
   

PowerShell

1. Atualize a quantidade reservada para zero:

   Update-AzCapacityReservation
   -ResourceGroupName "myResourceGroup"
   -ReservationGroupName "myCapacityReservationGroup"
   -Name "myCapacityReservation"
   -CapacityToReserve 0
   

2. Atualize a VM para remover a associação ao grupo de reserva de capacidade definindo a propriedade CapacityReservationGroupId como null:

   $VirtualMachine =
   Get-AzVM
   -ResourceGroupName "myResourceGroup"
   -Name "myVM"
   
   Update-AzVM
   -ResourceGroupName "myResourceGroup"
   -VM $VirtualMachine
   -CapacityReservationGroupId $null
   

Para saber mais, confira os comandos do Azure PowerShell New-AzCapacityReservation, Get-AzVM e Update-AzVM.

Próxima etapa

Saiba como associar um conjunto de dimensionamento a um grupo de reserva de capacidade