Associer une machine virtuelle à un groupe de réservations de capacité

S’applique à : ✔️ Machines Virtuelles Windows ✔️ Machines Virtuelles Linux

Les groupes de réservations de capacité peuvent être utilisés avec des machines virtuelles nouvelles ou existantes. Pour en savoir plus sur les réservations de capacité, consultez l’article de présentation.

Associer une nouvelle machine virtuelle

Pour associer une nouvelle machine virtuelle au groupe de réservations de capacité, le groupe doit être explicitement référencé en tant que propriété de la machine virtuelle. Cette référence protège la réservation correspondante dans le groupe pour les applications et charges de travail destinées à l’utiliser.

API

Pour ajouter la propriété capacityReservationGroup à une machine virtuelle, envoyez la demande PUT suivante au fournisseur Microsoft.Compute :

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

Dans le corps de la requête, ajoutez la propriété capacityReservationGroup :

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

Portail

1. Ouvrez le portail Azure.
2. Dans la barre de recherche, tapez machine virtuelle.
3. Sous Services, sélectionnez Machines virtuelles.
4. Dans la page Machines virtuelles, sélectionnez Créer, puis Machine virtuelle.
5. Sous l’onglet De base, sous Détails du projet, sélectionnez l’abonnement approprié, puis choisissez de créer un groupe de ressources ou d’en utiliser un déjà disponible.
6. Sous Détails de l’instance, entrez le nom de la machine virtuelle et choisissez votre région.
7. Choisissez une image et la taille de machine virtuelle
8. Sous Compte Administrateur, spécifiez un nom d’utilisateur et un mot de passe.
   1. Le mot de passe doit contenir au moins 12 caractères et satisfaire aux exigences de complexité définies.
9. Accédez à la section Avancé.
10. Dans la liste déroulante Réservations de capacité, sélectionnez le groupe de réservations de capacité auquel vous souhaitez associer la machine virtuelle.
11. Sélectionnez le bouton Vérifier + Créer.
12. Une fois la validation exécutée, sélectionnez le bouton Créer.
13. Une fois le déploiement effectué, sélectionnez Accéder à la ressource.

INTERFACE DE LIGNE DE COMMANDE

Utilisez az vm create pour créer une machine virtuelle et ajouter la propriété capacity-reservation-group pour associer la machine virtuelle à un groupe de réservations de capacité existant. L’exemple suivant crée une machine virtuelle Standard_D2s_v3 dans la localisation USA Est et associe la machine virtuelle à un groupe de réservations de capacité.

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}

PowerShell

Utilisez New-AzVM pour créer une machine virtuelle et ajouter la propriété CapacityReservationGroupId pour associer la machine virtuelle à un groupe de réservations de capacité existant. L’exemple suivant crée une machine virtuelle Standard_D2s_v3 dans l’emplacement USA Est et associe la machine virtuelle à un groupe de réservations de capacité.

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

Pour en savoir plus, consultez la commande Azure PowerShell New-AzVM.

Modèle ARM

Un modèle ARM est un fichier JSON (JavaScript Object Notation) qui définit l’infrastructure et la configuration de votre projet. Le modèle utilise la syntaxe déclarative. Dans la syntaxe déclarative, vous décrivez le déploiement souhaité sans écrire la séquence de commandes de programmation pour créer le déploiement.

Les modèles ARM vous permettent de déployer des groupes de ressources associées. Dans un modèle unique, vous pouvez créer un groupe de réservations de capacité et des réservations de capacité. Vous pouvez déployer des modèles via le Portail Azure, Azure CLI ou Azure PowerShell, ou à partir de pipelines d’intégration continue/de livraison continue.

Associer une machine virtuelle existante

Pour la version initiale de la réservation de capacité, une machine virtuelle doit être allouée à une réservation de capacité.

• Si ce n’est pas déjà fait, suivez les recommandations pour créer un groupe de réservations de capacité et une réservation de capacité. Sinon, incrémentez la quantité d’une réservation de capacité existante pour qu’il y ait de la capacité réservée inutilisée.
• Libérez la machine virtuelle.
• Mettez à jour la propriété du groupe de réservations de capacité sur la machine virtuelle.
• Redémarrez la machine virtuelle.

API

1. Libérez la machine virtuelle.

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

2. Ajoutez la propriété capacityReservationGroup à la machine virtuelle. Envoyez la demande PUT suivante au fournisseur Microsoft.Compute :

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

   Dans le corps de la requête, ajoutez la propriété capacityReservationGroup :

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

Portail

1. Ouvrez le portail Azure.
2. Accéder à votre machine virtuelle.
3. Sélectionnez Vue d’ensemble
4. Sélectionnez Arrêter en haut de la page pour libérer la machine virtuelle.
5. Accédez à Configurations à gauche.
6. Dans la liste déroulante Groupe de réservations de capacité, sélectionnez le groupe auquel vous souhaitez associer la machine virtuelle

INTERFACE DE LIGNE DE COMMANDE

1. Libérer la machine virtuelle

   az vm deallocate 
   -g myResourceGroup 
   -n myVM
   

2. Associer la machine virtuelle à un groupe de réservations de capacité

   az vm update 
   -g myresourcegroup 
   -n myVM 
   --capacity-reservation-group subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}
   

PowerShell

1. Libérer la machine virtuelle

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

2. Associer la machine virtuelle à un groupe de réservations de capacité

   $VirtualMachine =
   Get-AzVM
   -ResourceGroupName "myResourceGroup"
   -Name "myVM"
   
   Update-AzVM
   -ResourceGroupName "myResourceGroup"
   -VM $VirtualMachine
   -CapacityReservationGroupId "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}"
   

Pour en savoir plus, allez voir les commandes Azure PowerShell Stop-AzVM, Get-AzVM et Update-AzVM.

Afficher l’association de machines virtuelles avec la vue d’instance

Une fois que la propriété capacityReservationGroup est définie, une association existe entre la machine virtuelle et le groupe. Azure recherche automatiquement la réservation de capacité correspondante dans le groupe et consomme un emplacement réservé. La Vue d’instance du groupe de réservations de capacité reflète la nouvelle machine virtuelle dans la propriété virtualMachinesAllocated :

API

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

INTERFACE DE LIGNE DE COMMANDE

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

PowerShell

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

$CapRes.InstanceView.Utilizationinfo.VirtualMachinesAllocated

Pour plus d’informations, accédez à la commande Azure PowerShell Get-AzCapacityReservation.

Portail

1. Ouvrez le portail Azure.
2. Accédez à votre groupe de réservations de capacité.
3. Sélectionnez Ressources dans Paramètres à gauche.
4. Examinez le tableau pour voir toutes les machines virtuelles associées au groupe de réservations de capacité.

Étapes suivantes

Supprimer une association de machines virtuelles à un groupe de réservations de capacité