Associar uma VM a um grupo de reserva de capacidade

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

Você pode usar grupos de reserva de capacidade com VMs (máquinas virtuais) novas ou existentes. Para saber mais sobre reservas de capacidade, confira a Visão geral sobre 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 estar referenciado explicitamente como uma propriedade da VM. Essa referência protege a reserva correspondente no grupo para cargas de trabalho e aplicativos destinados a usá-la.

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": { 
     …     
    } 
  } 
}

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}

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 na localização 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, consulte o comando New-AzVM do Azure PowerShell.

Um modelo do Azure Resource Manager (modelo do ARM) é um arquivo de JavaScript Object Notation (JSON) que define a infraestrutura e a configuração do seu 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, é possível criar um grupo de reserva de capacidade e reservas de capacidade. É possível implantar modelos por meio do portal do Azure, da CLI do Azure ou do Azure PowerShell ou de pipelines de integração contínua/entrega contínua (CI/CD).

Para associar uma VM a um Grupo de Reserva de Capacidade, consulte o seguinte modelo do ARM. Substitua os nomes dos recursos pelos seus próprios. O exemplo a seguir cria uma VM de SKU D2s_v3 e a associa a um grupo de reserva de capacidade.

Como alternativa, você pode remover as informações de zona para criar uma VM regional e associá-la a um Grupo de Reserva de Capacidade.

{
   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {
       "adminUsername": {
           "type": "string",
           "metadata": {
               "description": "Username for the Virtual Machine."
           }
       },
       "adminPassword": {
           "type": "securestring",
           "minLength": 12,
           "metadata": {
               "description": "Password for the Virtual Machine."
           }
       },
       "dnsLabelPrefix": {
           "type": "string",
           "defaultValue": "[toLower(concat(parameters('vmName'),'-', uniqueString(resourceGroup().id, parameters('vmName'))))]",
           "metadata": {
               "description": "Unique DNS Name for the Public IP used to access the Virtual Machine."
           }
       },
       "publicIpName": {
           "type": "string",
           "defaultValue": "myPublicIP",
           "metadata": {
               "description": "Name for the Public IP used to access the Virtual Machine."
           }
       },
       "publicIPAllocationMethod": {
           "type": "string",
           "defaultValue": "Dynamic",
           "allowedValues": [
               "Dynamic",
               "Static"
           ],
           "metadata": {
               "description": "Allocation method for the Public IP used to access the Virtual Machine."
           }
       },
       "publicIpSku": {
           "type": "string",
           "defaultValue": "Basic",
           "allowedValues": [
               "Basic",
               "Standard"
           ],
           "metadata": {
               "description": "SKU for the Public IP used to access the Virtual Machine."
           }
       },
       "OSVersion": {
           "type": "string",
           "defaultValue": "2019-Datacenter",
           "allowedValues": [
               "2008-R2-SP1",
               "2012-Datacenter",
               "2012-R2-Datacenter",
               "2016-Nano-Server",
               "2016-Datacenter-with-Containers",
               "2016-Datacenter",
               "2019-Datacenter",
               "2019-Datacenter-Core",
               "2019-Datacenter-Core-smalldisk",
               "2019-Datacenter-Core-with-Containers",
               "2019-Datacenter-Core-with-Containers-smalldisk",
               "2019-Datacenter-smalldisk",
               "2019-Datacenter-with-Containers",
               "2019-Datacenter-with-Containers-smalldisk"
           ],
           "metadata": {
               "description": "The Windows version for the VM. This will pick a fully patched image of this given Windows version."
           }
       },
       "vmSize": {
           "type": "string",
           "defaultValue": "Standard_D2s_v3",
           "metadata": {
               "description": "Size of the virtual machine."
           }
       },
       "location": {
           "type": "string",
           "defaultValue": "[resourceGroup().location]",
           "metadata": {
               "description": "Location for all resources."
           }
       },
       "vmName": {
           "type": "string",
           "defaultValue": "myD2v3VM",
           "metadata": {
               "description": "Name of the virtual machine."
           }
       }
   },
   "variables": {
       "storageAccountName": "[concat('bootdiags', uniquestring(resourceGroup().id))]",
       "nicName": "myVMNic",
       "addressPrefix": "10.0.0.0/16",
       "subnetName": "Subnet",
       "subnetPrefix": "10.0.0.0/24",
       "virtualNetworkName": "MyVNET",
       "subnetRef": "[resourceId('Microsoft.Network/virtualNetworks/subnets', variables('virtualNetworkName'), variables('subnetName'))]",
       "networkSecurityGroupName": "default-NSG"
   },
   "resources": [{
           "type": "Microsoft.Storage/storageAccounts",
           "apiVersion": "2019-06-01",
           "name": "[variables('storageAccountName')]",
           "location": "[parameters('location')]",
           "sku": {
               "name": "Standard_LRS"
           },
           "kind": "Storage",
           "properties": {}
       }, {
           "type": "Microsoft.Network/publicIPAddresses",
           "apiVersion": "2020-06-01",
           "name": "[parameters('publicIPName')]",
           "location": "[parameters('location')]",
           "sku": {
               "name": "[parameters('publicIpSku')]"
           },
           "properties": {
               "publicIPAllocationMethod": "[parameters('publicIPAllocationMethod')]",
               "dnsSettings": {
                   "domainNameLabel": "[parameters('dnsLabelPrefix')]"
               }
           }
       }, {
           "type": "Microsoft.Network/networkSecurityGroups",
           "apiVersion": "2020-06-01",
           "name": "[variables('networkSecurityGroupName')]",
           "location": "[parameters('location')]",
           "properties": {
               "securityRules": [{
                       "name": "default-allow-3389",
                       "properties": {
                           "priority": 1000,
                           "access": "Allow",
                           "direction": "Inbound",
                           "destinationPortRange": "3389",
                           "protocol": "Tcp",
                           "sourcePortRange": "*",
                           "sourceAddressPrefix": "*",
                           "destinationAddressPrefix": "*"
                       }
                   }
               ]
           }
       }, {
           "type": "Microsoft.Network/virtualNetworks",
           "apiVersion": "2020-06-01",
           "name": "[variables('virtualNetworkName')]",
           "location": "[parameters('location')]",
           "dependsOn": [
               "[resourceId('Microsoft.Network/networkSecurityGroups', variables('networkSecurityGroupName'))]"
           ],
           "properties": {
               "addressSpace": {
                   "addressPrefixes": [
                       "[variables('addressPrefix')]"
                   ]
               },
               "subnets": [{
                       "name": "[variables('subnetName')]",
                       "properties": {
                           "addressPrefix": "[variables('subnetPrefix')]",
                           "networkSecurityGroup": {
                               "id": "[resourceId('Microsoft.Network/networkSecurityGroups', variables('networkSecurityGroupName'))]"
                           }
                       }
                   }
               ]
           }
       }, {
           "type": "Microsoft.Network/networkInterfaces",
           "apiVersion": "2020-06-01",
           "name": "[variables('nicName')]",
           "location": "[parameters('location')]",
           "dependsOn": [
               "[resourceId('Microsoft.Network/publicIPAddresses', parameters('publicIPName'))]",
               "[resourceId('Microsoft.Network/virtualNetworks', variables('virtualNetworkName'))]"
           ],
           "properties": {
               "ipConfigurations": [{
                       "name": "ipconfig1",
                       "properties": {
                           "privateIPAllocationMethod": "Dynamic",
                           "publicIPAddress": {
                               "id": "[resourceId('Microsoft.Network/publicIPAddresses', parameters('publicIPName'))]"
                           },
                           "subnet": {
                               "id": "[variables('subnetRef')]"
                           }
                       }
                   }
               ]
           }
       }, {
           "type": "Microsoft.Compute/virtualMachines",
           "apiVersion": "2020-06-01",
           "name": "[parameters('vmName')]",
           "location": "[parameters('location')]",
           "zones": "[parameters('Zones')]",
           "dependsOn": [
               "[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]",
               "[resourceId('Microsoft.Network/networkInterfaces', variables('nicName'))]"
           ],
           "properties": {
               "hardwareProfile": {
                   "vmSize": "[parameters('vmSize')]"
               },
               "capacityReservation": {
                   "capacityReservationGroup": {
                       "id": "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}"
                   }
               },
               "osProfile": {
                   "computerName": "[parameters('vmName')]",
                   "adminUsername": "[parameters('adminUsername')]",
                   "adminPassword": "[parameters('adminPassword')]"
               },
               "storageProfile": {
                   "imageReference": {
                       "publisher": "MicrosoftWindowsServer",
                       "offer": "WindowsServer",
                       "sku": "[parameters('OSVersion')]",
                       "version": "latest"
                   },
                   "osDisk": {
                       "createOption": "FromImage",
                       "managedDisk": {
                           "storageAccountType": "StandardSSD_LRS"
                       }
                   },
                   "dataDisks": [{
                           "diskSizeGB": 1023,
                           "lun": 0,
                           "createOption": "Empty"
                       }
                   ]
               },
               "networkProfile": {
                   "networkInterfaces": [{
                           "id": "[resourceId('Microsoft.Network/networkInterfaces', variables('nicName'))]"
                       }
                   ]
               },
               "diagnosticsProfile": {
                   "bootDiagnostics": {
                       "enabled": true,
                       "storageUri": "[reference(resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))).primaryEndpoints.blob]"
                   }
               }
           }
       }
   ],
   "outputs": {
       "hostname": {
           "type": "string",
           "value": "[reference(parameters('publicIPName')).dnsSettings.fqdn]"
       }
   }
}

Associar uma máquina virtual existente

As máquinas virtuais zonais existentes podem ser atualizadas com a propriedade Grupo de Reserva de Capacidade sem a necessidade de desalocação e consumir automaticamente a reserva de capacidade. As máquinas virtuais regionais existentes devem ser realocadas.

Máquina Virtual Regional

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

Siga as diretrizes para criar um grupo de reserva de capacidade e uma reserva de capacidade, se necessário. Ou, então, incremente a quantidade de uma reserva de capacidade existente para que haja capacidade reservada não utilizada.
Desaloque a máquina virtual.
Atualize a propriedade do grupo de reserva de capacidade na VM.
Reinicie a VM.

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

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

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

Desaloque a máquina virtual:

az vm deallocate 
-g myResourceGroup 
-n myVM

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}

Desaloque a máquina virtual:

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

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, confira os comandos do Azure PowerShell Stop-AzVM, Get-AzVM e Update-AzVM.

Máquina Virtual Zonal

Uma máquina virtual zonal pode ser alocada a uma reserva de capacidade sem a necessidade de realocação. Se você tiver capacidade em um grupo de reserva de capacidade existente, poderá adicionar uma máquina virtual zonal existente ao grupo de reserva de capacidade e atualizar a VM para usar uma reserva de capacidade correspondente no grupo de reserva de capacidade.

Importante

O recurso para associar uma VM zonal existente a um Grupo de Reserva de Capacidade sem a necessidade de desalocar está atualmente em Versão Prévia. Consulte os Termos de Uso da Versão Prévia para termos legais que se aplicam às funcionalidades do Azure que estão em beta, em versão prévia ou que ainda não foram liberadas para disponibilidade geral.

Siga as diretrizes para criar um grupo de reserva de capacidade e uma reserva de capacidade, se necessário. Ou, então, incremente a quantidade de uma reserva de capacidade existente para que haja capacidade reservada não utilizada.
Atualize a propriedade do grupo de reserva de capacidade na VM.

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

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

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}

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, confira os comandos do Azure PowerShell Stop-AzVM, Get-AzVM e Update-AzVM.

Proteger a máquina virtual zonal existente usando reserva de tamanho zero

Máquinas virtuais implantadas zonalmente podem ser convertidas para usar uma Reserva de Capacidade sob Demanda sem realocação. Se você não tiver capacidade em um grupo de reserva de capacidade existente, poderá começar criando uma reserva de tamanho zero para proteger suas cargas de trabalho. O processo básico envolve três etapas:

Crie um Grupo de Reserva de Capacidade e, em seguida, crie reservas de capacidade correspondentes em cada zona de destino, com a quantidade reservada definida como zero. Isso não requer nenhuma cota ou capacidade adicional. Para obter mais informações sobre como criar uma reserva, consulte Criar uma reserva de capacidade.
Associe a máquina virtual zonal existente e em execução à reserva de capacidade. Defina a propriedade CapacityReservationGroup da Máquina Virtual como o Grupo de Reserva de Capacidade desejado. Quando concluído, cada reserva de capacidade de destino estará superalocada. Consulte a Máquina Virtual Zonal.
Aumente a quantidade reservada de cada reserva de capacidade (CR) para corresponder à quantidade de Máquinas Virtuais (VM) alocadas. Como cada reserva de capacidade já está superalocada, esta etapa não requer cota ou capacidade adicionais. Para obter mais informações sobre como atualizar a contagem reservada, consulte A modificação da reserva de capacidade.

Após o aumento da quantidade, você deverá ver a reserva de capacidade totalmente alocada com todas as máquinas virtuais alocadas. Consulte Visualizar alocação de VM com a Vista de Instância.

Para obter informações sobre como usar o grupo de reserva de capacidade compartilhada, consulte Proteger cargas de trabalho zonais existentes usando a reserva de tamanho zero no Grupo de Reservas de Capacidade Compartilhada.

Visualize a alocação de VM com a Visão da 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 ao grupo e consome um slot reservado. A Exibição de instância da reserva de capacidade vai refletir a nova VM na propriedade virtualMachinesAllocated:

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

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

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

$CapRes.InstanceView.Utilizationinfo.VirtualMachinesAllocated

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

Próxima etapa

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

Comentários

Esta página foi útil?

Last updated on 2025-11-24

Compartilhar via

Associar uma VM a um grupo de reserva de capacidade

Associar uma nova máquina virtual

Associar uma máquina virtual existente

Máquina Virtual Regional

Máquina Virtual Zonal

Proteger a máquina virtual zonal existente usando reserva de tamanho zero

Visualize a alocação de VM com a Visão da Instância

Próxima etapa

Comentários

Recursos adicionais