VM を容量予約グループに関連付ける
適用対象: ✔️ Windows Virtual Machines ✔️ Linux Virtual Machines
容量予約グループは、新規または既存の仮想マシン (VM) で使用できます。 容量予約の詳細については、容量予約の概要に関する記事を参照してください。
新しい仮想マシンを関連付ける
新しい仮想マシンを容量予約グループに関連付けるには、VM のプロパティとしてグループを明示的に参照する必要があります。 このリファレンスでは、アプリケーションや、使用が意図されているワークロードのグループ内の予約照合を保護します。
capacityReservationGroup プロパティを VM に追加するには、Microsoft.Compute プロバイダーに対して次の PUT 要求を作成します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}?api-version=2021-04-01
要求本文に、capacityReservationGroup プロパティを含めます。
{
"location": "eastus",
"properties": {
"hardwareProfile": {
"vmSize": "Standard_D2s_v3"
},
…
"capacityReservation":{
"capacityReservationGroup":{
"id":"subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/CapacityReservationGroups/{CapacityReservationGroupName}"
}
"storageProfile": {
…
},
"osProfile": {
…
},
"networkProfile": {
…
}
}
}
既存の仮想マシンを関連付ける
容量予約の初期リリースでは、仮想マシンを容量予約に割り当てる必要があります。
- 必要に応じて、ガイダンスに従って、容量予約グループと容量予約を作成します。 または、使用されていない予約容量が残るように、既存の容量予約の数量を増やします。
- 仮想マシンの割り当てを解除する。
- VM の容量予約グループのプロパティを更新します。
- VM を再起動します。
次の手順に従って、仮想マシンを容量予約グループに関連付けます。
仮想マシンの割り当てを解除します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroupname}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}/deallocate?api-version=2021-04-01capacityReservationGroupプロパティを VM に追加します。Microsoft.Computeプロバイダーに対して次のPUT要求を作成します。PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName}?api-version=2021-04-01要求本文に、
capacityReservationGroupプロパティを含めます。{ "location": "eastus", "properties": { "capacityReservation": { "capacityReservationGroup": { "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}" } } } }
インスタンス ビューで VM の関連付けを表示する
capacityReservationGroup プロパティが設定されると、VM とグループの間に関連付けが存在するようになります。 Azure により、グループ内で一致する容量予約が自動的に検出され、予約済みスロットが消費されます。 容量予約のインスタンス ビューでは、virtualMachinesAllocated プロパティに新しい VM が反映されます。
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"
}
]
}
]
}
}
}