你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

创建容量预留

适用于：✔️ 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 大小。

Portal

1. 打开 Azure 门户。
2. 在搜索栏中，输入“产能预留组”。
3. 从选项中选择“产能预留组”。
4. 选择创建。
5. 在“基本”选项卡上，创建一个产能预留组：
   1. 选择一个“订阅” 。
   2. 选择或创建资源组。
   3. 为该组命名。
   4. 选择区域。
   5. （可选）选择“可用性区域”或允许 Azure 为你选择。
6. 选择下一步。
7. 在“VM 大小”上，选择“查看所有大小”，检查哪些 VM 大小可用于产能预留。

CLI

在创建产能预留之前，可以查看所选区域的预留可用的 VM 大小。 以下示例使用 Azure CLI 列出了在美国东部位置提供的产能预留 VM 大小：

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

PowerShell

在创建产能预留之前，可以通过对资源类型 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  } } }

创建容量预留

API

1. 创建产能预留组。

   若要创建产能预留组，请在 Microsoft.Compute 提供程序上构造以下 PUT 请求：

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

   在请求正文中，添加以下参数：

   { 
     "location":"eastus"
   } 
   

   创建此组以包含美国东部位置的预留。

   以下示例中的组仅支持 Azure 区域预留，因为在创建时没有指定可用性区域。 若要创建可用性区域组，请在请求正文中传递一个额外的参数 zone：

   { 
     "location":"eastus",
     "zones": ["1", "2", "3"] 
   } 
   

2. 创建产能预留。

   若要创建预留，请在 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 大小创建一个预留。

Portal

1. 打开 Azure 门户。
2. 在搜索栏中，输入“产能预留组”。
3. 从选项中选择“产能预留组”。
4. 选择创建。
5. 在“基本”选项卡上，创建一个产能预留组：
   1. 选择一个订阅。
   2. 选择或创建资源组。
   3. 为该组命名。
   4. 选择区域。
   5. （可选）选择“可用性区域”或允许 Azure 为你选择。
6. 选择下一步。
7. 在“预留”选项卡上，至少创建一个产能预留：
   1. 为每个预留指定“预留名称”、VM 实例的数量，并选择唯一的“VM 大小”。
   2. 基于你的选择的账单信息会显示在“费用/月”列中。
8. 选择下一步。
9. 在“标记”选项卡上，可选择性地创建标记。
10. 选择下一步。
11. 在“查看 + 创建”选项卡上，核对产能预留组信息。
12. 选择创建。

CLI

1. 在可创建容量预留之前，请使用 az group create 创建资源组。 以下示例在美国东部位置创建了一个资源组 myResourceGroup。

   az group create 
   -l eastus 
   -g myResourceGroup
   

2. 现在使用 az capacity reservation group create 创建一个产能预留组。 以下示例在美国东部位置为全部三个可用性区域创建了一个组 myCapacityReservationGroup。

   az capacity reservation group create 
   -n myCapacityReservationGroup 
   -l eastus 
   -g myResourceGroup 
   --zones 1 2 3 
   

3. 创建产能预留组后，使用 az capacity reservation create 创建一个新的产能预留。 以下示例在美国东部位置的区域 1 中为 5 个 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
   

PowerShell

1. 在可创建容量预留之前，请使用 New-AzResourceGroup 创建资源组。 以下示例在美国东部位置创建了一个资源组 myResourceGroup。

   New-AzResourceGroup
   -ResourceGroupName "myResourceGroup"
   -Location "eastus"
   

2. 现在使用 New-AzCapacityReservationGroup 创建一个产能预留组。 以下示例在美国东部位置为全部三个可用性区域创建了一个组 myCapacityReservationGroup。

   New-AzCapacityReservationGroup
   -ResourceGroupName "myResourceGroup"
   -Location "eastus"
   -Zone "1","2","3"
   -Name "myCapacityReservationGroup"
   

3. 创建产能预留组后，使用 New-AzCapacityReservation 创建一个新的产能预留。 以下示例在美国东部位置的区域 1 中为 5 个 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。

ARM 模板

Azure 资源管理器模板（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 使用。

API

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

CLI

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

PowerShell

查看你的产能预留：

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

要查找 VM 大小和预留数量，请使用以下命令：

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

$CapRes.sku

若要了解详细信息，请参阅 Azure PowerShell 命令 Get-AzCapacityReservation。

Portal

1. 打开 Azure 门户。
2. 在搜索栏中，输入“产能预留组”。
3. 从选项中选择“产能预留组”。
4. 从列表中，选择你创建的产能预留组名称。
5. 选择“概述”。
6. 选择“预留”。
7. 在此视图中，你可以看到组中的所有预留以及 VM 大小和预留数量。

下一步

了解如何修改容量预留