建立容量保留

發行項
10/02/2024

適用於：✔️ Linux VM ✔️ Windows VM ✔️ 統一擴展集 ✔️ 彈性擴展集

容量保留一律會建立為容量保留群組的一部分。第一個步驟是建立群組 (如果尚無適當的群組)，然後建立保留。保留在成功建立後，隨即可供虛擬機器 (VM) 使用。只要保留未刪除，容量就會保留給您使用。

對容量保留群組提出格式正確的要求應一律會成功，因為該群組不會保留任何容量。它只是作為保留的容器。不過，如果您沒有 VM 系列所需的配額，或 Azure 沒有足夠的容量可滿足要求，則容量保留的要求可能會失敗。請要求更多配額，或嘗試不同的 VM 大小、位置或區域組合。

容量保留的建立成功或失敗都是整體性的。若要求保留 10 個執行個體，則只有在 10 個執行個體全都可配置時，才會傳回成功訊息。否則，容量保留建立會失敗。

考量

容量保留必須符合下列規則：

location 參數必須符合父容量保留群組的 location 屬性。不相符會導致錯誤。
VM 大小必須適用於目標區域中。否則，保留建立會失敗。
訂用帳戶必須有可用的配額，且數量必須大於或等於要為 VM 系列和整體區域保留的 VM 數量。如有需要，請要求更多配額。
- 為滿足現有的配額限制，可以分階段為單一 VM 完成。使用較小的數量建立容量保留，並重新配置該數量的 VM。此方法會釋出配額，以增加保留的數量，以及新增更多 VM。或者，如果訂用帳戶在相同的系列中使用不同的 VM 大小，請為第一個大小保留並重新部署 VM。然後，將保留新增至另一個大小的群組，並將新大小的 VM 重新部署至保留群組。重複此流程，直到完成為止。
- 針對擴展集，除非擴展集或您刪除其 VM 執行個體、保留了容量，而且使用保留容量新增擴展集執行個體，否則需要可用的配額。如果使用藍綠部署更新了擴展集，請保留容量，並在下一次更新時將新的擴展集部署至保留容量。
每個容量保留群組針對特定 VM 大小只能有一個保留。例如，針對 VM 大小 Standard_D2s_v3，您只能建立一個容量保留。若嘗試在同一個容量保留群組中為 Standard_D2s_v3 建立第二個保留，會導致錯誤。不過，針對其他 VM 大小 (例如 Standard_D4s_v3 與 Standard_D8s_v3)，您可以在相同的群組中建立另一個保留。
針對支援區域的容量保留群組，每個保留類型都會由 VM 大小和區域的組合所定義。例如，支援 Zone 1 中的 Standard_D2s_v3 有一個容量保留、Zone 2 中的 Standard_D2s_v3 有另一個容量保留，Zone 3 中的 Standard_D2s_v3 有第三個容量保留。

檢查區域中容量保留可用的 VM 大小

建立容量保留之前，您可以檢查特定區域的保留可用 VM 大小。

開啟 Azure 入口網站。
在搜尋列中，輸入容量保留群組。
從選項中選取 [容量保留群組]。
選取建立。
在 [基本] 索引標籤上，建立容量保留群組：
1. 選取 [訂用帳戶]。
2. 選取或建立資源群組。
3. 為群組命名。
4. 選取區域。
5. 選擇性地選取 [可用性區域]，或允許 Azure 為您選擇。
選取 [下一步]。
在 [VM 大小] 上，選取 [查看所有大小] 來檢查容量保留可用的 VM 大小。

建立容量保留之前，您可以檢查所選區域的保留可用 VM 大小。下列範例會列出使用 Azure CLI 在美國東部位置可用的容量保留 VM 大小：

 az vm list-skus -l eastus --resource-type virtualMachines --query "[?contains(capabilities[?name == 'CapacityReservationSupported' && value == 'True'].name,'CapacityReservationSupported')].name"

建立容量保留之前，您可以使用資源類型 virtualMachines 的 capability 屬性 Get-AzComputeResourceSku，檢查所選區域可用的容量保留 VM 大小。下列範例會列出在美國東部位置可用的容量保留 VM 大小：

 $vmsizes = Get-AzComputeResourceSku -Location eastus | where {$_.ResourceType -eq "virtualMachines"}
 foreach($vmsize in $vmsizes) { foreach($capability in $vmsize.capabilities) {  if($capability.Name -eq 'CapacityReservationSupported' -and $capability.Value -eq 'true'){ $vmsize.name  } } }

建立容量保留

建立容量保留群組。

若要建立容量保留群組，請在 Microsoft.Compute 提供者上建構下列 PUT 要求：
```
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/CapacityReservationGroups/{CapacityReservationGroupName}&api-version=2021-04-01
```
在要求本文中，納入下列參數：
```
{ 
  "location":"eastus"
} 
```
系統會建立此群組以包含美國東部位置的保留。

下列範例中的群組只支援區域 (regional) 保留，因為在建立時並未指定區域 (zone)。若要建立區域群組，請在要求本文中傳遞額外的參數 zone：
```
{ 
  "location":"eastus",
  "zones": ["1", "2", "3"] 
} 
```

建立容量保留。

若要建立保留，請在 Microsoft.Compute 提供者上建構下列 PUT 要求：

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/CapacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2021-04-01

在要求本文中，納入下列參數：

{ 
  "location": "eastus", 
  "sku": { 
    "name": "Standard_D2s_v3", 
    "capacity": 5 
  }, 
 "tags": { 
        "environment": "testing" 
}

上述要求在美國東部位置建立了五個 D2s_v3 VM 大小的保留。

建立容量保留之前，請先使用 az group create 建立資源群組。下列範例會在美國東部位置建立一個資源群組 myResourceGroup。
```
az group create 
-l eastus 
-g myResourceGroup
```
現在，使用 az capacity reservation group create 建立容量保留群組。下列範例會在美國東部位置為全部三個可用性區域建立群組 myCapacityReservationGroup。
```
az capacity reservation group create 
-n myCapacityReservationGroup 
-l eastus 
-g myResourceGroup 
--zones 1 2 3 
```
容量保留群組建立後，請使用 az capacity reservation create 建立新的容量保留。下列範例會在美國東部位置的區域 1 中為五個 Standard_D2s_v3 VM 大小建立 myCapacityReservation。
```
az capacity reservation create 
-c myCapacityReservationGroup 
-n myCapacityReservation 
-l eastus 
-g myResourceGroup 
--sku Standard_D2s_v3 
--capacity 5 
--zone 1
```

建立容量保留之前，請先使用 New-AzResourceGroup 建立資源群組。下列範例會在美國東部位置建立一個資源群組 myResourceGroup。
```
New-AzResourceGroup
-ResourceGroupName "myResourceGroup"
-Location "eastus"
```
現在，使用 New-AzCapacityReservationGroup 建立容量保留群組。下列範例會在美國東部位置為全部三個可用性區域建立群組 myCapacityReservationGroup。
```
New-AzCapacityReservationGroup
-ResourceGroupName "myResourceGroup"
-Location "eastus"
-Zone "1","2","3"
-Name "myCapacityReservationGroup"
```

容量保留群組建立後，請使用 New-AzCapacityReservation 建立新的容量保留。下列範例會在美國東部位置的區域 1 中為五個 Standard_D2s_v3 VM 大小建立 myCapacityReservation。

New-AzCapacityReservation
-ResourceGroupName "myResourceGroup"
-Location "eastus"
-Zone "1"
-ReservationGroupName "myCapacityReservationGroup"
-Name "myCapacityReservation"
-Sku "Standard_D2s_v3"
-CapacityToReserve 5

若要深入了解，請參閱 Azure PowerShell 命令 New-AzResourceGroup (英文)、New-AzCapacityReservationGroup (英文) 和 New-AzCapacityReservation (英文)。

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

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

若要建立區域性容量保留群組，請參閱下列ARM範本。將資源名稱取代為您自己的名稱。下列範例會在這三個區域中建立名為 myZonalCapacityReservationGroup 的容量保留群組，其 SKU 的容量保留D2s_v3。

或者，您可以移除區域資訊，以建立區域容量保留群組。

{
   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {
       "location": {
           "type":"string",
           "defaultValue": "[resourceGroup().location]",
           "metadata": {
               "description": "Azure region for the resource"
           }
       },
         "Zones": {
           "type":"array",
           "defaultValue": ["1","2","3"],
           "metadata": {
               "description": "Zone(s) to use for Capacity Reservation Group"
           }
       },
       "CRGName": {
           "type":"string",
           "defaultValue": "myZonalCapacityReservationGroup",
           "metadata": {
               "description": "Name of Capacity Reservation Group"
           }
       },
       "CR1Name": {
           "type":"string",
           "defaultValue": "myCapacityReservation1",
           "metadata": {
               "description": "Name of Capacity Reservation 1"
           }
       },
       "CR1Zone": {
           "type":"array",
           "defaultValue": ["1"],
           "metadata": {
               "description": "Zone of Capacity Reservation 1"
           }
       },
       "CR2Name": {
           "type":"string",
           "defaultValue": "myCapacityReservation2",
           "metadata": {
               "description": "Name of Capacity Reservation 2"
           }
       },
        "CR2Zone": {
           "type":"array",
           "defaultValue": ["2"],
           "metadata": {
               "description": "Zone of Capacity Reservation 2"
           }
       },
       "CR3Name": {
           "type":"string",
           "defaultValue": "myCapacityReservation3",
           "metadata": {
               "description": "Name of Capacity Reservation 3"
           }
       },
        "CR3Zone": {
          "type":"array",
           "defaultValue": ["3"],
           "metadata": {
               "description": "Zone of Capacity Reservation 3"
           }
       },
       "SKU": {
           "type": "string",
           "defaultValue": "Standard_D2s_v3",
           "metadata": {
               "description": "VM size to be reserved. Customers are allowed to create reservations for different VM sizes for every capacity reservation within a capacity reservation group"
           }
       },
        "quantityReserved": {
           "type": "string",
           "defaultValue": "2",
           "metadata": {
               "description": "Quantity of VMs to be reserved across all three Capacity Reservation. Customers are allowed to reserve different quantities across all 3 reservations"
           }
       }
   },
   "variables": {},
   "resources": [
       {
           "type": "Microsoft.Compute/capacityReservationGroups",
           "name": "[parameters('CRGName')]",
           "apiVersion": "2020-06-01",
           "location": "[parameters('location')]",
           "zones": "[parameters('Zones')]"    
       },
       {
           "type": "Microsoft.Compute/capacityReservationGroups/capacityReservations",
           "name": "[concat(parameters('CRGName'),'/',parameters('CR1Name'))]",
           "apiVersion": "2020-06-01",
           "location": "[parameters('location')]",
           "zones": "[parameters('CR1Zone')]",  
           "dependsOn": ["[concat('Microsoft.Compute/capacityReservationGroups','/',parameters('CRGName'))]"],
           "sku":{
               "name": "[parameters('SKU')]",
               "capacity":"[parameters('quantityReserved')]"
           }  
       },
       {
           "type": "Microsoft.Compute/capacityReservationGroups/capacityReservations",
           "name": "[concat(parameters('CRGName'),'/',parameters('CR2Name'))]",
           "apiVersion": "2020-06-01",
           "location": "[parameters('location')]",
           "zones": "[parameters('CR2Zone')]",
           "dependsOn": ["[concat('Microsoft.Compute/capacityReservationGroups','/',parameters('CRGName'))]"],
           "sku":{
               "name": "[parameters('SKU')]",
               "capacity":"[parameters('quantityReserved')]"
           }
       },
       {
           "type": "Microsoft.Compute/capacityReservationGroups/capacityReservations",
           "name": "[concat(parameters('CRGName'),'/',parameters('CR3Name'))]",
           "apiVersion": "2020-06-01",
           "location": "[parameters('location')]",
           "zones": "[parameters('CR3Zone')]", 
           "dependsOn": ["[concat('Microsoft.Compute/capacityReservationGroups','/',parameters('CRGName'))]"],
           "sku":{
               "name": "[parameters('SKU')]",
               "capacity":"[parameters('quantityReserved')]"
           }
       }
   ]
}

檢查您的容量保留

容量保留成功建立後，隨即可搭配 VM 使用。

GET  
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/CapacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2021-04-01

{ 
    "name": "<CapacityReservationName>", 
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{CapacityReservationName}", 
    "type": "Microsoft.Compute/capacityReservationGroups/capacityReservations", 
    "location": "eastus", 
    "tags": { 
        "environment": "testing" 
    }, 
    "sku": { 
        "name": "Standard_D2s_v3", 
        "capacity": 5 
    }, 
    "properties": { 
        "reservationId": "<reservationId>", 
         "provisioningTime": "<provisioningTime>", 
         "provisioningState": "Updating" 
    } 
}

az capacity reservation show 
-c myCapacityReservationGroup 
-n myCapacityReservation 
-g myResourceGroup

檢查您的容量保留：

Get-AzCapacityReservation
-ResourceGroupName <"ResourceGroupName">
-ReservationGroupName <"CapacityReservationGroupName">
-Name <"CapacityReservationName">

若要尋找 VM 大小和保留的數量，請使用下列命令：

$CapRes =
Get-AzCapacityReservation
-ResourceGroupName <"ResourceGroupName">
-ReservationGroupName <"CapacityReservationGroupName">
-Name <"CapacityReservationName">

$CapRes.sku

若要深入了解，請參閱 Azure PowerShell 命令 Get-AzCapacityReservation (英文)。

後續步驟

了解如何修改您的容量保留 (部分機器翻譯)

共用方式為

建立容量保留

考量

檢查區域中容量保留可用的 VM 大小

建立容量保留

檢查您的容量保留

後續步驟

意見反應

其他資源