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

如何更新现有蓝图分配

重要

2026 年 7 月 11 日,蓝图(预览版)将弃用。 将现有蓝图定义和分配迁移到模板规格部署堆栈。 蓝图项目将转换为 ARM JSON 模板或用于定义部署堆栈的 Bicep 文件。 若要了解如何将项目创作为 ARM 资源,请参阅:

分配蓝图时可更新分配。 众多原因导致要更新现有分配,其中包括:

更新分配

  1. 在左侧窗格中,选择“所有服务”。 搜索并选择“蓝图”。

  2. 从左侧页面选择“分配的蓝图”

  3. 在蓝图列表中,左键单击蓝图分配。 然后使用“更新分配”按钮,或者选择并按住(或右键单击)蓝图分配并选择“更新分配”。

    突出显示了“更新分配”按钮的“蓝图分配”页面的屏幕截图。

  4. “分配蓝图”页将加载预先填写的来自原始分配的所有值。 可以更改“蓝图定义版本”、“锁定分配”状态,以及蓝图定义上存在的任何动态参数。 完成更改时,选择“分配”。

  5. 在更新后的分配详细信息页上,查看新状态。 在此示例中,我们向分配添加了“锁定”

    显示锁定模式已更改的更新蓝图分配屏幕截图。

  6. 使用下拉列表了解有关其他“分配操作”的详细信息。 “受管理资源”表通过选择的分配操作进行更新。

    显示分配操作及其状态的更新后蓝图分配的屏幕截图。

更新分配规则

更新分配部署遵循几个重要规则。 这些规则决定了已部署的资源会发生什么情况。 所请求的更改和要部署或更新的项目资源决定了要采取的操作。

  • 角色分配
    • 如果角色或角色代理人(用户、组或应用程序)发生更改,则创建新的角色分配。 以前部署的角色分配将会保留。
  • 策略分配
    • 如果策略分配的参数已发生更改,则更新现有分配。
    • 如果策略分配的定义已发生更改,则会创建一个新的策略分配。 以前部署的策略分配将会保留。
    • 如果从蓝图中删除策略分配项目,已部署的策略分配将会保留。
  • Azure 资源管理器模板(ARM 模板)
    • 该模板通过资源管理器作为 PUT 处理。 由于每个资源类型以不同的方式处理此操作,因此请查看包含的每个资源的文档,以确定在蓝图运行时该操作的影响。

更新分配上可能出现的错误

更新分配时,在执行期间进行更改可能会导致中断。 一个示例是在部署完成后更改资源组的位置。 资源管理器支持的任何更改都可以进行,但是任何会在资源管理器中导致错误的更改也将导致分配失败。

可以更新分配的次数没有限制。 如果发生错误,请确定该错误并对分配进行其他更新。 示例错误场景:

  • 不正确的参数
  • 已经存在的对象
  • 资源管理器不支持的更改

后续步骤