Modificar uma reserva de capacidade

Aplica-se a: ✔️ VMs do Linux ✔️ VMs do Windows ✔️ Conjuntos de dimensionamento uniformes ✔️ Conjuntos de dimensionamento flexíveis

Depois de criar um grupo de reservas de capacidade e uma reserva de capacidade, talvez você queira modificar suas reservas. Este artigo explica como executar as ações a seguir usando a API, o portal do Azure e o PowerShell.

• Atualizar o número de instâncias reservadas em uma reserva de capacidade.
• Redimensionar VMs associadas a um grupo de reservas de capacidade.
• Excluir o grupo de reservas de capacidade e a reserva de capacidade.

Atualizar o número de instâncias reservadas

Atualize o número de instâncias de máquina virtual (VM) reservadas em uma reserva de capacidade.

Importante

Nos casos raros em quando o Azure não pode atender à solicitação de aumento da quantidade reservada para a reserva de capacidade atual, a reserva poderá entrar em estado de Falha e ficar indisponível até que a quantidade seja restaurada ao valor original.

API

    PATCH 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, atualize a propriedade capacity para a nova contagem que você deseja reservar:

{
    "sku":
    {
        "capacity": 5
    }
} 

Neste exemplo, a propriedade capacity é definida como 5.

Portal

1. Abra o Portal do Azure.
2. Vá para o seu grupo de reservas de capacidade.
3. Selecione Visão geral.
4. Selecione Reservas.
5. Selecione Gerenciar Reserva na parte superior.
6. Na página Gerenciar Reservas, insira a nova quantidade a ser reservada no campo Instâncias.
7. Selecione Salvar.

CLI

Para atualizar a quantidade reservada, use az capacity reservation update com a propriedade capacity atualizada.

az capacity reservation update 
-c myCapacityReservationGroup 
-n myCapacityReservation 
-g myResourceGroup2 
--capacity 5

PowerShell

Para atualizar a quantidade reservada, use New-AzCapacityReservation com a propriedade capacityToReserve atualizada.

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

Para saber mais, confira o comando do Azure PowerShell Update-AzCapacityReservation.

Redimensionar VMs associadas a um grupo de reservas de capacidade

Você deve executar uma das seguintes opções se a VM que está sendo redimensionada estiver atualmente anexada a um grupo de reservas de capacidade e esse grupo não tiver uma reserva para o tamanho de destino:

• Criar uma nova reserva para esse tamanho.
• Remover a VM do grupo de reserva antes de redimensionar.

Verifique se o tamanho de destino faz parte do grupo de reservas.

API

1. Obtenha os nomes de todas as reservas de capacidade dentro do grupo.

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

   { 
       "name": "<CapacityReservationGroupName>", 
       "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}", 
       "type": "Microsoft.Compute/capacityReservationGroups", 
       "location": "eastUS", 
       "zones": [ 
           "1" 
       ], 
       "properties": { 
           "capacityReservations": [ 
               { 
                   "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName1}" 
               }, 
   { 
                   "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName2}" 
               } 
           ] 
       } 
   } 
   

2. Descubra o tamanho da VM reservado para cada reserva. O exemplo a seguir é para capacityReservationName1, mas você pode repetir esta etapa em outras reservas.

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

   { 
       "name": "capacityReservationName1", 
       "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName1}", 
       "type": "Microsoft.Compute/capacityReservationGroups/capacityReservations", 
       "location": "eastUS", 
       "sku": { 
           "name": "Standard_D2s_v3", 
           "capacity": 3 
       }, 
       "zones": [ 
           "1" 
       ], 
       "properties": { 
           "reservationId": "<reservationId>", 
           "provisioningTime": "<provisioningTime>", 
           "provisioningState": "Succeeded" 
       } 
   }  
   

3. Considere os seguintes cenário:

   • Se o tamanho da VM de destino não fizer parte do grupo, crie uma nova reserva de capacidade para a VM de destino.
   • Se o tamanho da VM de destino já existir no grupo, redimensione a VM.

Portal

1. Abra o Portal do Azure.
2. Vá para o seu grupo de reservas de capacidade.
3. Selecione Visão geral.
4. Selecione Reservas.
5. Verifique o tamanho da VM reservado para cada reserva.
   1. Se o tamanho da VM de destino não fizer parte do grupo, crie uma nova reserva de capacidade para a VM de destino.
   2. Se o tamanho da VM de destino já existir no grupo, redimensione a VM.

CLI

1. Obtenha os nomes de todas as reservas de capacidade do grupo de reservas de capacidade com az capacity reservation group show.

   az capacity reservation group show 
   -g myResourceGroup
   -n myCapacityReservationGroup 
   

2. Na resposta, encontre os nomes de todas as reservas de capacidade.

3. Execute os comandos a seguir para descobrir os tamanhos de VM reservados para cada reserva:

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

4. Considere os seguintes cenário:

   • Se o tamanho da VM de destino não fizer parte do grupo, crie uma nova reserva de capacidade para a VM de destino.
   • Se o tamanho da VM de destino já existir no grupo, redimensione a VM.

PowerShell

1. Obtenha os nomes de todas as reservas de capacidade do grupo com Get-AzCapacityReservationGroup.

   Get-AzCapacityReservationGroup
   -ResourceGroupName "myResourceGroup"
   -Name "myCapacityReservationGroup"
   

2. Na resposta, encontre os nomes de todas as reservas de capacidade.

3. Execute os comandos a seguir para descobrir os tamanhos de VM reservados para cada reserva:

   $CapRes =
   Get-AzCapacityReservation
   -ResourceGroupName "myResourceGroup"
   -ReservationGroupName "myCapacityReservationGroup"
   -Name "mycapacityReservation"
   
   $CapRes.Sku
   

4. Considere os seguintes cenário:

   • Se o tamanho da VM de destino não fizer parte do grupo, crie uma nova reserva de capacidade para a VM de destino.
   • Se o tamanho da VM de destino já existir no grupo, redimensione a VM.

Para saber mais, confira os comandos do Azure PowerShell Get-AzCapacityReservationGroup e Get-AzCapacityReservation.

Excluir um grupo de reservas de capacidade e a reserva de capacidade

O Azure permite que um grupo seja excluído quando todas as reservas de capacidade do membro foram excluídas e nenhuma VMs estiver associada ao grupo.

Para excluir uma reserva de capacidade, primeiro descubra todas as VMs associadas a ela. A lista de VMs está disponível na propriedade virtualMachinesAssociated.

API

Primeiro, localize todas as VMs associadas ao grupo de reservas de capacidade e desassocie-as:

    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/{VirtualMachineName1}" 
            }, 
            { 
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName2}" 
            } 
        ], 
        "instanceView": { 
            "capacityReservations": [ 
                { 
                    "name": "{capacityReservationName}", 
                    "utilizationInfo": { 
                        "virtualMachinesAllocated": [ 
                            { 
                                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName1}" 
                            } 
                        ] 
                    }, 
                    "statuses": [ 
                        { 
                            "code": "ProvisioningState/succeeded", 
                            "level": "Info", 
                            "displayStatus": "Provisioning succeeded", 
                            "time": "<time>" 
                        } 
                    ] 
                } 
            ] 
        } 
    } 
}  

Na resposta anterior, localize os nomes de todas as VMs na propriedade virtualMachinesAssociated. Remova-os do grupo de reservas de capacidade usando as etapas em Remover uma associação de VM para uma reserva de capacidade.

Depois de remover todas as VMs do grupo de reservas de capacidade, exclua as reservas de capacidade do membro:

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

Por fim, exclua o grupo de reservas de capacidade pai:

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

Portal

1. Abra o Portal do Azure.
2. Vá para o seu grupo de reservas de capacidade.
3. Selecione Recursos.
4. Descubra todas as VMs associadas ao grupo.
5. Desassociar todas as VMs.
6. Exclua todas as reservas de capacidade do grupo:
   1. Acesse Reservas.
   2. Selecione cada reserva.
   3. Selecione Excluir.
7. Exclua o grupo de reservas de capacidade:
   1. Vá para o grupo de reservas de capacidade.
   2. Selecione Excluir na parte superior da página.

CLI

Descubra todas as VMs associadas ao grupo de reservas de capacidade e desassocie-as.

1. Execute o comando a seguir:

   az capacity reservation group show
   -g myResourceGroup
   -n myCapacityReservationGroup
   

2. Na resposta anterior, descubra os nomes de todas as VMs na propriedade VirtualMachinesAssociated e remova-os do grupo de reservas de capacidade usando as etapas em Remover uma associação de VM de um grupo de reservas de capacidade.

3. Exclua a reserva de capacidade:

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

4. Exclua o grupo de reservas de capacidade:

   az capacity reservation group delete 
   -g myResourceGroup 
   -n myCapacityReservationGroup
   

PowerShell

Descubra todas as VMs associadas ao grupo de reservas de capacidade e desassocie-as.

1. Execute o comando a seguir:

   Get-AzCapacityReservationGroup
   -ResourceGroupName "myResourceGroup"
   -Name "myCapacityReservationGroup"
   

2. Na resposta anterior, descubra os nomes de todas as VMs na propriedade VirtualMachinesAssociated. Remova-os do grupo de reserva de capacidade usando as etapas em Remover uma associação de VM de um grupo de reservas de capacidade.

3. Exclua a reserva de capacidade:

   Remove-AzCapacityReservation
   -ResourceGroupName "myResourceGroup"
   -ReservationGroupName "myCapacityReservationGroup"
   -Name "myCapacityReservation"
   

4. Exclua o grupo de reservas de capacidade:

   Remove-AzCapacityReservationGroup
   -ResourceGroupName "myResourceGroup"
   -Name "myCapacityReservationGroup"
   

Para saber mais, confira os comandos do Azure PowerShell Get-AzCapacityReservationGroup, Remove-AzCapacityReservation e Remove-AzCapacityReservationGroup.

Quantidade de instância de restauração

Uma solicitação bem formada para reduzir a quantidade reservada sempre deve ser bem-sucedida, seja qual for o número de VMs associadas à reserva. No entanto, aumentar a quantidade reservada pode exigir mais cota e para que o Azure atenda à solicitação de mais capacidade. Em um cenário raro em que o Azure não possa atender à solicitação de aumento da quantidade reservada da reserva atual, a reserva poderá entrar em estado de Falha e ficar indisponível até que a quantidade reservada seja restaurada ao valor original.

Observação

Se uma reserva estiver em um estado de Falha, todas as VMs associadas à reserva continuarão funcionando normalmente.

Por exemplo, digamos que myCapacityReservation tenha cinco instâncias reservadas. Você solicita cinco instâncias extras, o que torna a quantidade total reservada igual a 10. No entanto, devido a uma situação de capacidade restrita na região, o Azure não pode fornecer as cinco instâncias extras solicitadas. Nesse caso, myCapacityReservation falha ao atender ao estado pretendido de 10 instâncias reservadas e entra em um estado de Falha.

Para resolver essa falha, siga estas etapas para localizar o valor antigo da quantidade reservada:

1. No portal do Azure, acesse Análise de Alterações de Aplicativo.
2. Selecione as configurações de Assinatura, Grupo de recursos e Intervalo de tempo aplicáveis ​​nos filtros. Você só pode selecionar até 14 dias atrás no filtro Intervalo de tempo.
3. Pesquise o nome da reserva de capacidade.
4. Procure a alteração na propriedade sku.capacity dessa reserva. A quantidade reservada antiga será o valor da coluna Valor antigo.

Atualize myCapacityReservation com a quantidade reservada antiga. Depois de atualizada, a reserva estará disponível imediatamente para uso com suas VMs.

Próxima etapa

Saiba como remover VMs de uma reserva de capacidade