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é, vous souhaiterez peut-être modifier vos réservations. Cet article explique comment effectuer les actions suivantes à l’aide de l’API, du portail Azure et de 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, il est possible qu’une réservation passe dans un état échec et devienne indisponible jusqu’à ce que la quantité soit restaurée sur le montant d’origine.

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

Notez que la propriété capacity a la valeur 5 maintenant dans cet exemple.

Redimensionnez 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éer une nouvelle réservation pour cette taille
  • Supprimez l’ordinateur virtuel du groupe de réservations avant le redimensionnement.

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

  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 :

    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

Supprimez 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 ont été 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.

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

À partir de la réponse ci-dessus, recherchez les noms de toutes les machines virtuels sous la propriété virtualMachinesAssociated et supprimez-les du groupe de réservations de capacité en suivant les étapes de la section supprimer une association de machines virtuelles à 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

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’amélioration de la quantité réservée peut nécessiter plus de quota et pour qu’Azure puisse traiter la demande de capacité supplémentaire. 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 échec et devienne indisponible jusqu’à ce que la quantité soit restaurée sur le montant d’origine.

Notes

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

Par exemple, myCapacityReservation a une quantité réservée de 5. Vous demandez 5 instances supplémentaires, ce qui rend la quantité totale réservée é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 demandées. Dans ce cas, myCapacityReservation ne répondra pas à son état prévu de 10 quantités réservées et passera en état d'échec.

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

  1. Accédez à Analyse des modifications d’application dans le portail Azure
  2. Sélectionnez l'Abonnement, le Groupe de ressourceset l'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 sera la valeur sous la colonne Ancienne valeur

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

Étapes suivantes