Partilhar via


Associar uma VM a um grupo de reserva de capacidade

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

Você pode usar grupos de reserva de capacidade com máquinas virtuais (VMs) novas ou existentes. Para saber mais sobre reservas de capacidade, consulte a Visão geral da reserva de capacidade.

Associar uma nova máquina virtual

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

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

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

No corpo do pedido, inclua a capacityReservationGroup propriedade:

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

Associar uma máquina virtual existente

Para a liberação inicial de uma reserva de capacidade, uma máquina virtual deve ser alocada para uma reserva de capacidade:

  1. Siga as orientações para criar um grupo de reserva de capacidade e uma reserva de capacidade, se necessário. Ou aumente a quantidade de uma reserva de capacidade existente para que haja capacidade reservada não utilizada.
  2. Desaloque a máquina virtual.
  3. Atualize a propriedade do grupo de reserva de capacidade na VM.
  4. Reinicie a VM.

Siga as etapas para associar a máquina virtual a um grupo de reserva de capacidade.

  1. Desalocar 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. Adicione a capacityReservationGroup propriedade à VM. Construa a seguinte PUT solicitação ao Microsoft.Compute provedor:

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

    No corpo do pedido, inclua a capacityReservationGroup propriedade:

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

Exibir associação de VM com a Visualização de instância

Depois que a capacityReservationGroup propriedade é definida, agora existe 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 visualização de instância da reserva de capacidade reflete a nova VM na virtualMachinesAllocated propriedade:

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"
                  }
               ]
            }
         ]
      }
   }
} 

Próximo passo