Associate a VM to a Capacity Reservation group
Applies to: ✔️ Windows Virtual Machines ✔️ Linux Virtual Machines
Capacity reservation groups can be used with new or existing virtual machines. To learn more about Capacity Reservations, see the overview article.
Associate a new VM
To associate a new VM to the Capacity Reservation group, the group must be explicitly referenced as a property of the virtual machine. This reference protects the matching reservation in the group for applications and workloads intended to use it.
To add the capacityReservationGroup
property to a VM, construct the following PUT request to the Microsoft.Compute provider:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}?api-version=2021-04-01
In the request body, include the capacityReservationGroup
property:
{
"location": "eastus",
"properties": {
"hardwareProfile": {
"vmSize": "Standard_D2s_v3"
},
…
"capacityReservation":{
"capacityReservationGroup":{
"id":"subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/CapacityReservationGroups/{CapacityReservationGroupName}"
}
"storageProfile": {
…
},
"osProfile": {
…
},
"networkProfile": {
…
}
}
}
Associate an existing VM
For the initial release of Capacity Reservation, a virtual machine must be allocated to a capacity reservation.
- If not already complete, follow guidance to create a capacity reservation group and capacity reservation. Or increment the quantity of an existing capacity reservation so there's unused reserved capacity.
- Deallocate the VM.
- Update the capacity reservation group property on the VM.
- Restart the VM.
Deallocate the VM.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroupname}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}/deallocate?api-version=2021-04-01
Add the
capacityReservationGroup
property to the VM. Construct the following PUT request to Microsoft.Compute provider:PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}?api-version=2021-04-01
In the request body, include the
capacityReservationGroup
property:{ "location": "eastus", "properties": { "capacityReservation": { "capacityReservationGroup": { "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}" } } } }
View VM association with Instance View
Once the capacityReservationGroup
property is set, an association now exists between the VM and the group. Azure automatically finds the matching Capacity Reservation in the group and consumes a reserved slot. The Capacity Reservation’s Instance View will reflect the new VM in the virtualMachinesAllocated
property:
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"
}
]
}
]
}
}
}
Next steps
משוב
https://aka.ms/ContentUserFeedback.
בקרוב: במהלך 2024, נפתור בעיות GitHub כמנגנון המשוב לתוכן ונחליף אותו במערכת משוב חדשה. לקבלת מידע נוסף, ראה:שלח והצג משוב עבור