將 VM 關聯至容量保留群組

適用於： ✔️ Windows 虛擬機器 ✔️ Linux 虛擬機器

容量保留群組可以與新的或現有的虛擬機器 (VM) 搭配使用。 若要深入了解容量保留，請參閱容量保留概觀 (部分機器翻譯)。

關聯新的虛擬機器

若要將新的虛擬機器關聯至容量保留群組，必須明確參考該群組做為 VM 的屬性。 此參考可保護群組中的相符保留，以供所需的應用程式與工作負載使用。

API

若要將 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": { 
     …     
    } 
  } 
} 

入口網站

1. 開啟 Azure 入口網站。
2. 在搜尋列中，輸入虛擬機器。
3. 在 [服務] 底下，選取 [虛擬機器]。
4. 在 [虛擬機器] 頁面上，選取 [建立]，然後選取 [虛擬機器]。
5. 在 [基本資料] 索引標籤上，從 [專案詳細資料] 底下選取正確的訂用帳戶。 接著建立新的資源群組，或選擇現有的資源群組。
6. 在 [執行個體詳細資料] 下，輸入 VM 名稱並選擇您的區域。
7. 選取 [映像] 和 VM 大小。
8. 在 [系統管理員帳戶] 下，輸入使用者名稱與密碼。 密碼長度至少必須有 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 範本

Azure Resource Manager 範本 (ARM 範本) 是一個 JavaScript 物件標記法 (JSON) 檔案，其定義專案的基礎結構和設定。 範本使用宣告式語法。 在宣告式語法中，您不需要撰寫用於建立部署的程式設計命令序列，就能建立您所需的部署。

ARM 範本可讓您部署相關資源的群組。 您可以在單一範本中建立容量保留群組和容量保留。 您可以透過 Azure 入口網站、Azure CLI 或 Azure PowerShell，或從持續整合/持續傳遞 (CI/CD) 管線部署範本。

若要將 VM 與容量保留群組產生關聯，請參閱下列 ARM 範本。 將資源名稱取代為您自己的名稱。 下列範例會建立 SKU 的 VM D2s_v3，並將它與容量保留群組產生關聯。

或者，您可以移除 區域 資訊來建立區域 VM，並將它與容量保留群組產生關聯。

{
   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {
       "adminUsername": {
           "type": "string",
           "metadata": {
               "description": "Username for the Virtual Machine."
           }
       },
       "adminPassword": {
           "type": "securestring",
           "minLength": 12,
           "metadata": {
               "description": "Password for the Virtual Machine."
           }
       },
       "dnsLabelPrefix": {
           "type": "string",
           "defaultValue": "[toLower(concat(parameters('vmName'),'-', uniqueString(resourceGroup().id, parameters('vmName'))))]",
           "metadata": {
               "description": "Unique DNS Name for the Public IP used to access the Virtual Machine."
           }
       },
       "publicIpName": {
           "type": "string",
           "defaultValue": "myPublicIP",
           "metadata": {
               "description": "Name for the Public IP used to access the Virtual Machine."
           }
       },
       "publicIPAllocationMethod": {
           "type": "string",
           "defaultValue": "Dynamic",
           "allowedValues": [
               "Dynamic",
               "Static"
           ],
           "metadata": {
               "description": "Allocation method for the Public IP used to access the Virtual Machine."
           }
       },
       "publicIpSku": {
           "type": "string",
           "defaultValue": "Basic",
           "allowedValues": [
               "Basic",
               "Standard"
           ],
           "metadata": {
               "description": "SKU for the Public IP used to access the Virtual Machine."
           }
       },
       "OSVersion": {
           "type": "string",
           "defaultValue": "2019-Datacenter",
           "allowedValues": [
               "2008-R2-SP1",
               "2012-Datacenter",
               "2012-R2-Datacenter",
               "2016-Nano-Server",
               "2016-Datacenter-with-Containers",
               "2016-Datacenter",
               "2019-Datacenter",
               "2019-Datacenter-Core",
               "2019-Datacenter-Core-smalldisk",
               "2019-Datacenter-Core-with-Containers",
               "2019-Datacenter-Core-with-Containers-smalldisk",
               "2019-Datacenter-smalldisk",
               "2019-Datacenter-with-Containers",
               "2019-Datacenter-with-Containers-smalldisk"
           ],
           "metadata": {
               "description": "The Windows version for the VM. This will pick a fully patched image of this given Windows version."
           }
       },
       "vmSize": {
           "type": "string",
           "defaultValue": "Standard_D2s_v3",
           "metadata": {
               "description": "Size of the virtual machine."
           }
       },
       "location": {
           "type": "string",
           "defaultValue": "[resourceGroup().location]",
           "metadata": {
               "description": "Location for all resources."
           }
       },
       "vmName": {
           "type": "string",
           "defaultValue": "myD2v3VM",
           "metadata": {
               "description": "Name of the virtual machine."
           }
       }
   },
   "variables": {
       "storageAccountName": "[concat('bootdiags', uniquestring(resourceGroup().id))]",
       "nicName": "myVMNic",
       "addressPrefix": "10.0.0.0/16",
       "subnetName": "Subnet",
       "subnetPrefix": "10.0.0.0/24",
       "virtualNetworkName": "MyVNET",
       "subnetRef": "[resourceId('Microsoft.Network/virtualNetworks/subnets', variables('virtualNetworkName'), variables('subnetName'))]",
       "networkSecurityGroupName": "default-NSG"
   },
   "resources": [{
           "type": "Microsoft.Storage/storageAccounts",
           "apiVersion": "2019-06-01",
           "name": "[variables('storageAccountName')]",
           "location": "[parameters('location')]",
           "sku": {
               "name": "Standard_LRS"
           },
           "kind": "Storage",
           "properties": {}
       }, {
           "type": "Microsoft.Network/publicIPAddresses",
           "apiVersion": "2020-06-01",
           "name": "[parameters('publicIPName')]",
           "location": "[parameters('location')]",
           "sku": {
               "name": "[parameters('publicIpSku')]"
           },
           "properties": {
               "publicIPAllocationMethod": "[parameters('publicIPAllocationMethod')]",
               "dnsSettings": {
                   "domainNameLabel": "[parameters('dnsLabelPrefix')]"
               }
           }
       }, {
           "type": "Microsoft.Network/networkSecurityGroups",
           "apiVersion": "2020-06-01",
           "name": "[variables('networkSecurityGroupName')]",
           "location": "[parameters('location')]",
           "properties": {
               "securityRules": [{
                       "name": "default-allow-3389",
                       "properties": {
                           "priority": 1000,
                           "access": "Allow",
                           "direction": "Inbound",
                           "destinationPortRange": "3389",
                           "protocol": "Tcp",
                           "sourcePortRange": "*",
                           "sourceAddressPrefix": "*",
                           "destinationAddressPrefix": "*"
                       }
                   }
               ]
           }
       }, {
           "type": "Microsoft.Network/virtualNetworks",
           "apiVersion": "2020-06-01",
           "name": "[variables('virtualNetworkName')]",
           "location": "[parameters('location')]",
           "dependsOn": [
               "[resourceId('Microsoft.Network/networkSecurityGroups', variables('networkSecurityGroupName'))]"
           ],
           "properties": {
               "addressSpace": {
                   "addressPrefixes": [
                       "[variables('addressPrefix')]"
                   ]
               },
               "subnets": [{
                       "name": "[variables('subnetName')]",
                       "properties": {
                           "addressPrefix": "[variables('subnetPrefix')]",
                           "networkSecurityGroup": {
                               "id": "[resourceId('Microsoft.Network/networkSecurityGroups', variables('networkSecurityGroupName'))]"
                           }
                       }
                   }
               ]
           }
       }, {
           "type": "Microsoft.Network/networkInterfaces",
           "apiVersion": "2020-06-01",
           "name": "[variables('nicName')]",
           "location": "[parameters('location')]",
           "dependsOn": [
               "[resourceId('Microsoft.Network/publicIPAddresses', parameters('publicIPName'))]",
               "[resourceId('Microsoft.Network/virtualNetworks', variables('virtualNetworkName'))]"
           ],
           "properties": {
               "ipConfigurations": [{
                       "name": "ipconfig1",
                       "properties": {
                           "privateIPAllocationMethod": "Dynamic",
                           "publicIPAddress": {
                               "id": "[resourceId('Microsoft.Network/publicIPAddresses', parameters('publicIPName'))]"
                           },
                           "subnet": {
                               "id": "[variables('subnetRef')]"
                           }
                       }
                   }
               ]
           }
       }, {
           "type": "Microsoft.Compute/virtualMachines",
           "apiVersion": "2020-06-01",
           "name": "[parameters('vmName')]",
           "location": "[parameters('location')]",
           "zones": "[parameters('Zones')]",
           "dependsOn": [
               "[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]",
               "[resourceId('Microsoft.Network/networkInterfaces', variables('nicName'))]"
           ],
           "properties": {
               "hardwareProfile": {
                   "vmSize": "[parameters('vmSize')]"
               },
               "capacityReservation": {
                   "capacityReservationGroup": {
                       "id": "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}"
                   }
               },
               "osProfile": {
                   "computerName": "[parameters('vmName')]",
                   "adminUsername": "[parameters('adminUsername')]",
                   "adminPassword": "[parameters('adminPassword')]"
               },
               "storageProfile": {
                   "imageReference": {
                       "publisher": "MicrosoftWindowsServer",
                       "offer": "WindowsServer",
                       "sku": "[parameters('OSVersion')]",
                       "version": "latest"
                   },
                   "osDisk": {
                       "createOption": "FromImage",
                       "managedDisk": {
                           "storageAccountType": "StandardSSD_LRS"
                       }
                   },
                   "dataDisks": [{
                           "diskSizeGB": 1023,
                           "lun": 0,
                           "createOption": "Empty"
                       }
                   ]
               },
               "networkProfile": {
                   "networkInterfaces": [{
                           "id": "[resourceId('Microsoft.Network/networkInterfaces', variables('nicName'))]"
                       }
                   ]
               },
               "diagnosticsProfile": {
                   "bootDiagnostics": {
                       "enabled": true,
                       "storageUri": "[reference(resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))).primaryEndpoints.blob]"
                   }
               }
           }
       }
   ],
   "outputs": {
       "hostname": {
           "type": "string",
           "value": "[reference(parameters('publicIPName')).dnsSettings.fqdn]"
       }
   }
}

關聯現有的虛擬機器

針對容量保留的初始版本，必須將虛擬機器配置給容量保留：

1. 視需要遵循指導方針來建立容量保留群組和容量保留。 或是遞增現有容量保留的數量，這樣才會有未使用的保留容量。
2. 解除配置虛擬機器。
3. 更新 VM 上的容量保留群組屬性。
4. 重新啟動 VM。

依照步驟將虛擬機器關聯至容量保留群組。

API

1. 解除配置虛擬機器：

   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 入口網站。
2. 移至您的 VM。
3. 選取 [概觀]。
4. 選取頁面頂端的 [停止] 以解除配置 VM。
5. 移至左側的 [設定]。
6. 在 [容量保留群組] 下拉式清單中，選取您要關聯至 VM 的群組。

CLI

1. 解除配置虛擬機器：

   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. 解除配置虛擬機器：

   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 入口網站。
2. 移至您的容量保留群組。
3. 在左側的 [設定] 下，選取 [資源]。
4. 查看資料表，以查看與容量保留群組相關聯的所有 VM。

後續步驟

移除與容量保留群組的 VM 關聯 (部分機器翻譯)