Modifier une réservation de capacité

S’applique à : ✔️ Machines virtuelles Linux ✔️ Machines virtuelles Windows ✔️ Groupes identiques uniformes ✔️ Groupes identiques flexibles

Après avoir créé un groupe de réservations de capacité et une réservation de capacité, il se peut que vous souhaitiez modifier vos réservations. Cet article explique comment effectuer les actions suivantes en utilisant l’API, le portail Azure et PowerShell.

• Mettez à jour le nombre d’instances réservées dans une réservation de capacité.
• Redimensionnez les machines virtuelles associées à un groupe de réservations de capacité.
• Supprimez le groupe de réservations de capacité et la réservation de capacité.

Mettez à jour le nombre d’instances réservées

Mettez à jour le nombre d’instances de machine virtuelle réservées dans une réservation de capacité.

Important

Dans de rares cas où Azure ne peut pas traiter la demande pour augmenter la quantité réservée pour les réservations de capacité existantes, une réservation peut passer à un état d’échec et peut devenir indisponible jusqu’à ce que la quantité soit restaurée sur le montant d’origine.

API

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

Dans le corps de la demande, mettez à jour la propriété capacity avec le nouveau nombre que vous souhaitez réserver :

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

Dans cet exemple, la propriété capacity est désormais définie sur 5.

Portail

1. Ouvrez le portail Azure.
2. Accédez à votre groupe de réservations de capacité.
3. Sélectionnez Vue d’ensemble.
4. Sélectionnez Réservations.
5. En haut de la page, sélectionnez Gérer les réservations.
6. Dans la page Gérer les réservations, entrez la nouvelle quantité à réserver dans le champ Instances.
7. Cliquez sur Enregistrer.

INTERFACE DE LIGNE DE COMMANDE

Pour mettre à jour la quantité réservée, utilisez az capacity reservation update avec la propriété capacity mise à jour.

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

PowerShell

Pour mettre à jour la quantité réservée, utilisez New-AzCapacityReservation avec la propriété capacityToReserve mise à jour.

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

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

Redimensionner les machines virtuelles associées à un groupe de réservations de capacité

Vous devez choisir l’une des options suivantes si la machine virtuelle redimensionnée est actuellement attachée à un groupe de réservations de capacité et que ce groupe n’a pas de réservation pour la taille cible :

• Créez une nouvelle réservation pour cette taille.
• Supprimez la machine virtuelle du groupe de réservations avant de redimensionner.

Vérifiez si la taille cible fait partie du groupe de réservations.

API

1. Obtenez le nom de toutes les réservations de capacité au sein du groupe.

       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. Déterminez la taille de machine virtuelle réservée pour chaque réservation. L’exemple suivant est destiné à capacityReservationName1, mais vous pouvez répéter cette étape pour d’autres réservations.

       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. Examinez les scénarios suivants :

   • Si la taille de machine virtuelle cible ne fait pas partie du groupe, créez une nouvelle réservation de capacité pour la machine virtuelle cible.
   • Si la taille de machine virtuelle cible existe déjà dans le groupe, redimensionnez la machine virtuelle.

Portail

1. Ouvrez le portail Azure.
2. Accédez à votre groupe de réservations de capacité.
3. Sélectionnez Vue d’ensemble.
4. Sélectionnez Réservations.
5. Déterminez la taille de machine virtuelle réservée pour chaque réservation.
   1. Si la taille de machine virtuelle cible ne fait pas partie du groupe, créez une nouvelle réservation de capacité pour la machine virtuelle cible.
   2. Si la taille de machine virtuelle cible existe déjà dans le groupe, redimensionnez la machine virtuelle.

INTERFACE DE LIGNE DE COMMANDE

1. Obtenez le nom de toutes les réservations de capacité au sein du groupe de réservation de capacité avec az capacity reservation group show.

   az capacity reservation group show 
   -g myResourceGroup
   -n myCapacityReservationGroup 
   

2. À partir de la réponse, recherchez le nom de toutes les réservations de capacité.

3. Pour déterminer la ou les tailles de machine virtuelle réservées pour chaque réservation, exécutez les commandes suivantes :

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

4. Examinez les scénarios suivants :

   • Si la taille de machine virtuelle cible ne fait pas partie du groupe, créez une nouvelle réservation de capacité pour la machine virtuelle cible.
   • Si la taille de machine virtuelle cible existe déjà dans le groupe, redimensionnez la machine virtuelle.

PowerShell

1. Obtenez le nom de toutes les réservations de capacité au sein du groupe avec Get-AzCapacityReservationGroup.

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

2. À partir de la réponse, recherchez le nom de toutes les réservations de capacité.

3. Pour déterminer la ou les tailles de machine virtuelle réservées pour chaque réservation, exécutez les commandes suivantes :

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

4. Examinez les scénarios suivants :

   • Si la taille de machine virtuelle cible ne fait pas partie du groupe, créez une nouvelle réservation de capacité pour la machine virtuelle cible.
   • Si la taille de machine virtuelle cible existe déjà dans le groupe, redimensionnez la machine virtuelle.

Pour plus d’informations, consultez les commandes Azure PowerShell Get-AzCapacityReservationGroup et Get-AzCapacityReservation.

Supprimer le groupe de réservations de capacité et la réservation de capacité

Azure permet à un groupe d’être supprimé lorsque toutes les réservations de capacité des membres sont supprimées et qu’aucune machine virtuelle n’est associée au groupe.

Pour supprimer une réservation de capacité, commencez par rechercher toutes les machines virtuelles qui y sont associées. La liste des machines virtuelles est disponible sous la propriété virtualMachinesAssociated.

API

Tout d’abord, recherchez toutes les machines virtuelles associées au groupe de réservations de capacité et dissociez-les :

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

Dans la réponse précédente, recherchez les noms de toutes les machines virtuelles sous la propriété virtualMachinesAssociated. Supprimez-les du groupe de réservations de capacité en suivant les étapes décrites dans Supprimer une association de machine virtuelle à une réservation de capacité.

Une fois que toutes les machines virtuelles sont supprimées du groupe de réservations de capacité, supprimez la ou les réservations de capacité du membre :

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

Enfin, supprimez le groupe de réservations de capacité parent :

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

Portail

1. Ouvrez le portail Azure.
2. Accédez à votre groupe de réservations de capacité.
3. Sélectionnez Ressources.
4. Découvrez toutes les machines virtuelles associées au groupe.
5. Dissociez chaque machine virtuelle.
6. Supprimez chaque réservation de capacité dans le groupe :
   1. Accédez à Réservations.
   2. Sélectionnez chaque réservation.
   3. Sélectionnez Supprimer.
7. Supprimez le groupe de réservations de capacité :
   1. Accédez au groupe de réservations de capacité.
   2. En haut de la page, sélectionnez Supprimer.

INTERFACE DE LIGNE DE COMMANDE

Découvrez toutes les machines virtuelles associées au groupe de réservations de capacité et dissociez-les.

1. Exécutez la commande suivante :

   az capacity reservation group show
   -g myResourceGroup
   -n myCapacityReservationGroup
   

2. Dans la réponse précédente, recherchez les noms de toutes les machines virtuelles sous la propriété VirtualMachinesAssociated et supprimez-les du groupe de réservations de capacité en suivant les étapes décrites dans Supprimer une association de machines virtuelles d’un groupe de réservations de capacité.

3. Supprimez la réservation de capacité :

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

4. Supprimez le groupe de réservations de capacité :

   az capacity reservation group delete 
   -g myResourceGroup 
   -n myCapacityReservationGroup
   

PowerShell

Découvrez toutes les machines virtuelles associées au groupe de réservations de capacité et dissociez-les.

1. Exécutez la commande suivante :

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

2. Dans la réponse précédente, découvrez les noms de toutes les machines virtuelles sous la propriété VirtualMachinesAssociated. Supprimez-les du groupe de réservations de capacité en suivant les étapes décrites dans Supprimer une association de machines virtuelles d’un groupe de réservations de capacité.

3. Supprimez la réservation de capacité :

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

4. Supprimez le groupe de réservations de capacité :

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

Pour plus d’informations, consultez les commandes Azure PowerShell Get-AzCapacityReservationGroup, Remove-AzCapacityReservation, et Remove-AzCapacityReservationGroup.

Restaurer la quantité d’instance

Une demande bien formée pour réduire la quantité réservée doit toujours réussir, quel que soit le nombre de machines virtuelles associées à la réservation. Toutefois, l’augmentation de la quantité réservée peut nécessiter davantage de quota et pour qu’Azure réponde à la demande d’une capacité plus importante. Dans de rares cas où Azure ne peut pas traiter la requête pour augmenter la quantité réservée pour les réservations existantes, il est possible qu’une réservation passe dans un état d’échec et devienne indisponible jusqu’à ce que la quantité soit restaurée sur le montant d’origine.

Remarque

Si une réservation est dans un état d’échec, toutes les machines virtuelles associées à la réservation continuent de fonctionner normalement.

Par exemple, supposons que myCapacityReservation a 5 instances réservées. Vous demandez 5 instances supplémentaires, ce qui rend la quantité réservée totale égale à 10. Toutefois, en raison d’une situation de capacité restreinte dans la région, Azure ne peut pas traiter les 5 quantités supplémentaires que vous avez demandées. Dans ce cas, myCapacityReservation ne répond pas à son état prévu de 10 instances réservées et passe à un état d’échec.

Pour résoudre ce problème, suivez les étapes suivantes pour localiser l’ancienne valeur réservée quantité :

1. Dans le portail Azure, accédez à Application de l’analyse des changements.
2. Sélectionnez Abonnement, le Groupe de ressources et les paramètres Intervalle de temps appropriés dans les filtres. Vous ne pouvez revenir à plus de 14 jours dans le passé du filtre Intervalle de temps.
3. Recherchez le nom de la réservation de capacité.
4. Recherchez la modification de la propriété sku.capacity pour cette réservation. L’ancienne quantité réservée est la valeur sous la colonne Ancienne valeur.

Mettez à jour myCapacityReservation à l’ancienne quantité réservée. Une fois mise à jour, la réservation est disponible immédiatement pour une utilisation avec vos machines virtuelles.

Étape suivante

Découvrir comment supprimer des machines virtuelles d’une réservation de capacité