VM を容量予約グループに関連付ける

適用対象: ✔️ Windows Virtual Machines ✔️ Linux Virtual Machines

容量予約グループは、新規または既存の仮想マシンで使用できます。 容量予約の詳細については、概要について説明した記事を参照してください。

新しい VM を関連付ける

新しい VM を容量予約グループに関連付けるには、仮想マシンのプロパティとしてグループを明示的に参照する必要があります。 このリファレンスでは、アプリケーションや、使用が意図されているワークロードのグループ内の予約照合を保護します。

API

VM に capacityReservationGroup プロパティを追加するには、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": { 
     …     
    } 
  } 
} 

ポータル

1. Azure portal を開きます。
2. 検索バーに「仮想マシン」と入力します。
3. [サービス] で、 [仮想マシン] を選択します。
4. [仮想マシン] ページで、 [作成] を選択してから、 [仮想マシン] を選択します。
5. [基本] タブの [プロジェクトの詳細] で、適切なサブスクリプションを選択してから、新しいリソース グループを作成するか、既存のものを使用するかを選択します。
6. [インスタンスの詳細] で、仮想マシンの名前を入力し、リージョンを選択します。
7. イメージと VM のサイズを選択します。
8. [管理者アカウント] で、ユーザー名とパスワードを指定します。
   1. パスワードは 12 文字以上で、定義された複雑さの要件を満たす必要があります。
9. [詳細設定] セクションに移動します。
10. [容量予約] ドロップダウンで、VM を関連付ける容量予約グループを選択します。
11. [確認および作成] ボタンを選択します。
12. 検証の実行後、 [作成] ボタンを選択します。
13. デプロイが完了したら、 [リソースに移動] を選択します。

CLI

az vm create を使用して新しい VM を作成し、capacity-reservation-group プロパティを追加して既存の容量予約グループに関連付けます。 次の例では、米国東部の場所に Standard_D2s_v3 VM を作成し、その VM を容量予約グループに関連付けます。

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

New-AzVM を使用して新しい VM を作成し、CapacityReservationGroupId プロパティを追加して既存の容量予約グループに関連付けます。 次の例では、米国東部の場所に Standard_D2s_v3 VM を作成し、その VM を容量予約グループに関連付けます。

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

詳細については、Azure PowerShell コマンド「New-AzVM」を参照してください。

ARM テンプレート

ARM テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。 このテンプレートでは、宣言型の構文が使用されています。 宣言型の構文では、デプロイしようとしているものを、デプロイを作成する一連のプログラミング コマンドを記述しなくても記述できます。

ARM テンプレートを使用して、関連するリソースのグループをデプロイできます。 1 つのテンプレートで、容量予約グループと容量予約を作成できます。 テンプレートは、Azure portal、Azure CLI、Azure PowerShell からデプロイすることも、継続的インテグレーション/継続的デリバリー (CI/CD) パイプラインから呼び出すこともできます。

既存の VM を関連付ける

容量予約の初期リリースでは、仮想マシンを容量予約に割り当てる必要があります。

• まだ完了していない場合は、ガイダンスに従って、容量予約グループと容量予約を作成します。 または、使用されていない予約容量が残るように、既存の容量予約の数量を増やします。
• VM の割り当てを解除します。
• VM の容量予約グループのプロパティを更新します。
• VM を再起動します。

API

1. VM の割り当てを解除します。

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

2. 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": {
       "capacityReservation": {
           "capacityReservationGroup": {
               "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}"
           }
       }
   }
   }
   

ポータル

1. Azure portal を開きます。
2. 仮想マシンに移動します。
3. [概要] を選択します
4. ページ上部にある [停止] を選択して VM の割り当てを解除します。
5. 左側の [構成] に移動します。
6. [容量予約グループ] ドロップダウンで、VM を関連付けるグループを選択します。

CLI

1. VM の割り当てを解除する

   az vm deallocate 
   -g myResourceGroup 
   -n myVM
   

2. VM を容量予約グループに関連付ける

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

PowerShell

1. VM の割り当てを解除する

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

2. VM を容量予約グループに関連付ける

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

詳細については、Azure PowerShell コマンド「Stop-AzVM」、「Get-AzVM」、「Update-AzVM」を参照してください。

インスタンス ビューで VM の関連付けを表示する

capacityReservationGroup プロパティが設定されると、VM とグループの間に関連付けが存在するようになります。 Azure により、グループ内で一致する容量予約が自動的に検出され、予約済みスロットが消費されます。 容量予約のインスタンス ビューでは、virtualMachinesAllocated プロパティに新しい VM が反映されます。

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

CLI

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

詳細については、Azure PowerShell コマンド「Get-AzCapacityReservation」を参照してください。

ポータル

1. Azure portal を開きます。
2. 容量予約グループに移動します
3. 左側の [設定] で [リソース] を選択します。
4. テーブルを参照して、容量予約グループに関連付けられているすべての VM を確認します。

次のステップ

容量予約グループに対する VM の関連付けを削除する