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

修改产能预留

适用于：✔️ Linux VM ✔️ Windows VM ✔️ 统一规模集 ✔️ 灵活规模集

创建产能预留组和产能预留后，你可能想要修改预留。 本文介绍如何使用 API、Azure 门户和 PowerShell 执行以下操作。

• 更新容量预留中预留的实例数
• 重设与产能预留组关联的 VM 的大小
• 删除产能预留组和产能预留

更新预留的实例数

更新产能预留中预留的虚拟机实例数。

重要

在 Azure 无法满足增加现有容量预留的预留数量这一请求等极少数情况下，预留状态可能会更改为“失败”且变得不可用，直到数量还原到原始数额。

API

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

在请求正文中，将 capacity 属性更新为要保留的新计数：

{
    "sku":
    {
        "capacity": 5
    }
} 

请注意，在此示例中，capacity 属性现在设置为 5。

Portal

1. 打开 Azure 门户
2. 转到你的产能预留组
3. 选择“概述”
4. 选择“预留”
5. 选择顶部的“管理预留”
6. 在“管理预留”页面上，在“实例”字段中输入要预留的新数量
7. 选择“保存”

CLI

要更新预留数量，请将 az capacity reservation update 与更新后的 capacity 属性一起使用。

az capacity reservation update 
-c myCapacityReservationGroup 
-n myCapacityReservation 
-g myResourceGroup2 
--capacity 5

PowerShell

要更新预留数量，请将 New-AzCapacityReservation 与更新后的 capacityToReserve 属性一起使用。

Update-AzCapacityReservation
-ResourceGroupName "myResourceGroup"
-ReservationGroupName "myCapacityReservationGroup"
-Name "myCapacityReservation"
-CapacityToReserve 5

要了解详细信息，请转到 Azure PowerShell 命令 Update-AzCapacityReservation。

重设与产能预留组关联的 VM 的大小

如果要重设大小的 VM 当前已附加到产能预留组，并且该组没有目标大小预留，则必须执行以下选项之一：

• 为该大小创建新预留
• 在重设大小之前，从预留组中删除虚拟机。

检查目标大小是否属于预留组：

API

1. 获取组内所有容量预留的名称。

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

   { 
       "name": "<CapacityReservationGroupName>", 
       "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}", 
       "type": "Microsoft.Compute/capacityReservationGroups", 
       "location": "eastUS", 
       "zones": [ 
           "1" 
       ], 
       "properties": { 
           "capacityReservations": [ 
               { 
                   "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName1}" 
               }, 
   { 
                   "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName2}" 
               } 
           ] 
       } 
   } 
   

2. 查找每个预留所预留的 VM 大小。 以下示例适用于 capacityReservationName1，但可以对其他预留重复此步骤。

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

   { 
       "name": "capacityReservationName1", 
       "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{CapacityReservationGroupName}/capacityReservations/{capacityReservationName1}", 
       "type": "Microsoft.Compute/capacityReservationGroups/capacityReservations", 
       "location": "eastUS", 
       "sku": { 
           "name": "Standard_D2s_v3", 
           "capacity": 3 
       }, 
       "zones": [ 
           "1" 
       ], 
       "properties": { 
           "reservationId": "<reservationId>", 
           "provisioningTime": "<provisioningTime>", 
           "provisioningState": "Succeeded" 
       } 
   }  
   

3. 请考虑下列情形：

   1. 如果目标 VM 大小不属于该组，请为目标 V​​M 创建新的产能预留
   2. 如果组中已存在目标 VM 大小，请重设虚拟机大小

Portal

1. 打开 Azure 门户
2. 转到你的产能预留组
3. 选择“概述”
4. 选择“预留”
5. 查看每个预留所预留的 VM 大小
   1. 如果目标 VM 大小不属于该组，请为目标 V​​M 创建新的产能预留
   2. 如果组中已存在目标 VM 大小，请重设虚拟机大小

CLI

1. 使用 az capacity reservation group show 获取产能预留组内所有产能预留的名称

   az capacity reservation group show 
   -g myResourceGroup
   -n myCapacityReservationGroup 
   

2. 从响应中，查找所有产能预留的名称

3. 运行以下命令查找每个预留所预留的 VM 大小

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

4. 请考虑下列情形：

   1. 如果目标 VM 大小不属于该组，请为目标 V​​M 创建新的产能预留
   2. 如果组中已存在目标 VM 大小，请重设虚拟机大小

PowerShell

1. 使用 Get-AzCapacityReservationGroup 获取组内所有容量预留的名称

   Get-AzCapacityReservationGroup
   -ResourceGroupName "myResourceGroup"
   -Name "myCapacityReservationGroup"
   

2. 从响应中，查找所有产能预留的名称

3. 运行以下命令查找每个预留所预留的 VM 大小

   $CapRes =
   Get-AzCapacityReservation
   -ResourceGroupName "myResourceGroup"
   -ReservationGroupName "myCapacityReservationGroup"
   -Name "mycapacityReservation"
   
   $CapRes.Sku
   

4. 请考虑下列情形：

   1. 如果目标 VM 大小不属于该组，请为目标 V​​M 创建新的产能预留
   2. 如果组中已存在目标 VM 大小，请重设虚拟机大小

要了解详细信息，请转到 Azure PowerShell 命令 Get-AzCapacityReservationGroup 和 Get-AzCapacityReservation。

删除产能预留组和产能预留

如果某个组的所有成员产能预留均已删除且没有 VM 与该组关联，那么 Azure 允许删除该组。

若要删除产能预留，请先查找与其关联的所有虚拟机。 虚拟机列表位于 virtualMachinesAssociated 属性下。

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/{VirtualMachineName1}" 
            }, 
            { 
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName2}" 
            } 
        ], 
        "instanceView": { 
            "capacityReservations": [ 
                { 
                    "name": "{capacityReservationName}", 
                    "utilizationInfo": { 
                        "virtualMachinesAllocated": [ 
                            { 
                                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VirtualMachineName1}" 
                            } 
                        ] 
                    }, 
                    "statuses": [ 
                        { 
                            "code": "ProvisioningState/succeeded", 
                            "level": "Info", 
                            "displayStatus": "Provisioning succeeded", 
                            "time": "<time>" 
                        } 
                    ] 
                } 
            ] 
        } 
    } 
}  

从上述响应中，查找 virtualMachinesAssociated 属性下所有虚拟机的名称，并按照删除与产能预留的 VM 关联中的步骤将它们从产能预留组中删除。

从产能预留组中删除所有虚拟机后，删除成员产能预留：

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

最后，删除父产能预留组。

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

Portal

1. 打开 Azure 门户
2. 转到你的产能预留组
3. 选择“资源”
4. 查找与该组关联的所有虚拟机
5. 解除每个虚拟机的关联
6. 删除组中的每个容量预留
   1. 转到“预留”
   2. 选择每个预留
   3. 选择“删除”
7. 删除产能预留组
   1. 转到产能预留组
   2. 选择页面顶部的“删除”

CLI

查找与产能预留组关联的所有虚拟机并将它们取消关联。

1. 运行以下命令：

   az capacity reservation group show
   -g myResourceGroup
   -n myCapacityReservationGroup
   

2. 从上述响应中，找出 VirtualMachinesAssociated 属性下所有虚拟机的名称，并按照从产能预留组中删除虚拟机关联中详述的步骤将它们从产能预留组中删除。

3. 从组中删除所有虚拟机后，继续执行后续步骤。

4. 删除容量预留：

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

5. 删除产能预留组：

   az capacity reservation group delete 
   -g myResourceGroup 
   -n myCapacityReservationGroup
   

PowerShell

查找与产能预留组关联的所有虚拟机并将它们取消关联。

1. 运行以下命令：

   Get-AzCapacityReservationGroup
   -ResourceGroupName "myResourceGroup"
   -Name "myCapacityReservationGroup"
   

2. 从上述响应中，找出 VirtualMachinesAssociated 属性下所有虚拟机的名称，并按照从产能预留组中删除虚拟机关联中详述的步骤将它们从产能预留组中删除。

3. 从组中删除所有虚拟机后，继续执行后续步骤。

4. 删除容量预留：

   Remove-AzCapacityReservation
   -ResourceGroupName "myResourceGroup"
   -ReservationGroupName "myCapacityReservationGroup"
   -Name "myCapacityReservation"
   

5. 删除产能预留组：

   Remove-AzCapacityReservationGroup
   -ResourceGroupName "myResourceGroup"
   -Name "myCapacityReservationGroup"
   

要了解详细信息，请转到 Azure PowerShell 命令 Get-AzCapacityReservationGroup、Remove-AzCapacityReservation 和 Remove-AzCapacityReservationGroup。

还原实例数量

无论与预留关联的 VM 数量如何，格式正确的预留数量减少请求都应始终成功。 但是，要增加预留数量，可能需要更多配额，并且只有 Azure 才能满足额外的容量请求。 在 Azure 无法满足增加现有预留的预留数量这一请求等极少数场景中，预留状态可能会更改为“失败”且变得不可用，直到预留数量还原到原始数额。

注意

如果预留处于“失败”状态，则与预留关联的所有 VM 都将继续正常工作。

例如，假设 myCapacityReservation 的预留数量为 5。 你请求 5 个额外的实例，使预留总数量等于 10。 但是，由于该区域的容量受到限制，Azure 无法满足请求的额外 5 个数量。 在这种情况下，myCapacityReservation 将无法满足其预留数量为 10 的预期状态，并且状态会更改为“失败”。

要解决此失败，请执行以下步骤来查找旧的预留数量值：

1. 转到 Azure 门户中的应用程序更改分析
2. 在筛选器中选择适用的“订阅”、“资源组”和“时间范围”
   • 在“时间范围”筛选器中，最多只能追溯到过去 14 天
3. 搜索产能预留的名称
4. 查找对该预留的 sku.capacity 属性所做的更改
   • 旧的预留数量将是“旧值”列下的值

将 myCapacityReservation 更新为旧的预留数量。 更新后，预留可立即供虚拟机使用。

后续步骤

了解如何从容量预留中删除 VM