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, convém modificar as 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

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

    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 o novo número que você deseja reservar:

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

Neste exemplo, a propriedade capacity agora está definida como 5.

Redimensionar VMs associadas a um grupo de reserva 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:

  • Crie uma nova reserva para esse tamanho.
  • Remova a VM do grupo de reserva antes de redimensioná-la.

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

  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. Saiba o tamanho da VM associado a cada reserva. O exemplo a seguir é para capacityReservationName1, mas você pode repetir esta etapa para 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:

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

Azure permite excluir um grupo quando todas as reservas de capacidade dos membros forem excluídas e não houver VMs associadas 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.

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, encontre os nomes de todas as VMs sob a propriedade virtualMachinesAssociated. Remova-as do grupo de reserva de capacidade usando as etapas em Remover uma associação de VM de uma reserva de capacidade.

Depois que todas as VMs forem removidas do grupo de reserva de capacidade, exclua as reservas de capacidade associadas:

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

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 uma cota maior e que o Azure atenda à solicitação de mais capacidade. Em um cenário raro em que o Azure não consiga atender à solicitação de aumento da quantidade reservada para reservas existentes, a reserva poderá entrar no estado Failed e ficar indisponível até que a quantidade reservada seja restaurada para o valor original.

Observação

Se uma reserva estiver no estado Failed, todas as VMs associadas à reserva continuam funcionando normalmente.

Por exemplo, digamos que myCapacityReservation tenha 5 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 não atinge o estado desejado de 10 instâncias reservadas e entra no estado Failed.

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

  1. No portal do Azure, acesse Change Analysis.
  2. Selecione, nos filtros, as configurações aplicáveis de Assinatura, Grupo de recursos e Intervalo de tempo. 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 é o valor na coluna Valor antigo.

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

Como alternativa, use o campo currentCapacity das propriedades de exibição da instância da reserva de capacidade para verificar a capacidade do tamanho da VM reservada com êxito e atualizar a quantidade para o valor de capacidade atual. Ver Reservas de Capacidade – Obter.

Próxima etapa

Saiba como remover VMs de uma reserva de capacidade

  • Last updated on