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

解决“找不到资源”错误

2025-05-08

当在操作期间找不到资源时，本文介绍您看到的错误。通常，在使用 Bicep 文件或 Azure 资源管理器模板（ARM 模板）部署资源时，会看到此错误。在执行管理任务和 Azure 资源管理器找不到所需的资源时，还会看到此错误。例如，如果尝试将标记添加到不存在的资源，则会收到此错误。

症状

有两个错误代码指示找不到资源。此错误 NotFound 返回的结果与以下类似：

Code=NotFound;
Message=Cannot find ServerFarm with name exampleplan.

ResourceNotFound 错误返回如下所示的结果：

Code=ResourceNotFound;
Message=The Resource 'Microsoft.Storage/storageAccounts/{storage name}' under resource
group {resource group name} was not found.

原因

资源管理器需要检索资源的属性，但找不到订阅中的资源。

解决方案 1：检查资源属性

如果在执行管理任务时收到此错误，请检查为资源提供的值。要检查的三个值为：

资源名称
资源组名称
订阅

如果使用 PowerShell 或 Azure CLI，请检查是否在包含资源的订阅中运行命令。可以使用 Set-AzContext 或 az account set 更改订阅。许多命令提供了一个订阅参数，使用该参数可以指定与当前上下文不同的订阅。

如果无法验证属性，请登录到 Microsoft Azure 门户。找到要尝试使用的资源，并检查资源名称、资源组和订阅。

解决方案 2：设置依赖项

如果在部署模板时收到此错误，则可能需要添加依赖项。如果可能，资源管理器会通过并行创建资源来优化部署。

例如，部署 Web 应用时，应用服务计划必须存在。如果尚未指定 Web 应用依赖于应用服务计划，资源管理器会同时创建这两个资源。 Web 应用失败，并出现无法找到应用服务计划资源的错误，因为它尚不存在。通过在 Web 应用中设置依赖项来阻止此错误。

肱二头肌
JSON

使用隐式依赖项，而不是 resourceId 函数。依赖项是使用资源的符号名称和 ID 属性创建的。

例如，Web 应用 serverFarmId 的属性使用 servicePlan.id 来创建对应用服务计划的依赖。

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  properties: {
    serverFarmId: servicePlan.id
  }
}

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  ...

对于大多数部署，没有必要使用 dependsOn 来创建显式依赖项。

避免设置不需要的依赖项。不必要的依赖项会延长部署持续时间，因为不会并行部署资源。此外，还可以创建阻止部署的循环依赖项。

如果必须在另一个资源之后部署资源，请使用模板中的 dependsOn 元素。

{
  "type": "Microsoft.Web/sites",
  "apiVersion": "2022-03-01",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  ...
}

避免设置不需要的依赖项。不必要的依赖项会延长部署持续时间，因为不会并行部署资源。此外，还可以创建阻止部署的循环依赖项。

引用和 list* 函数在引用的资源部署在同一模板中并且由其名称（而不是资源 ID）引用时，将创建对所引用资源的隐式依赖项。因此，你可能具有比属性中指定的 dependsOn 依赖项更多的依赖项。

resourceId 函数不会创建隐式依赖项或验证资源是否存在。引用函数和list*函数在通过其资源 ID 引用资源时不会创建隐式依赖项。若要创建隐式依赖项，请传递在同一模板中部署的资源的名称。

部署顺序

看到依赖项问题时，需要深入了解资源部署的顺序。可以使用门户查看部署作的顺序：

登录到门户。
从资源组的 “概述”中，选择部署历史记录的链接。
对于要查看的 部署名称 ，请选择 “相关事件”。
检查每个资源的事件序列。请注意每个操作的状态及其时间戳。例如，下图显示了三个并行部署的存储帐户。请注意，三个存储帐户部署同时启动。

下图显示了三个未并行部署的存储帐户。第二个存储帐户依赖于第一个存储帐户，第三个存储帐户依赖于第二个存储帐户。第一个存储帐户标记为 “已启动”、“ 已接受”和 “成功 ”，然后再启动下一个存储帐户。

Bicep 使用符号名称来创建对另一个资源的隐式依赖关系。现有关键字引用已部署的资源。如果现有资源与要部署的资源位于不同的资源组中，请包括范围并使用 resourceGroup 函数。

在此示例中，部署了一个 Web 应用，该应用使用另一个资源组中的现有应用服务计划。

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' existing = {
  name: hostingPlanName
  scope: resourceGroup(rgname)
}

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  name: siteName
  properties: {
    serverFarmId: servicePlan.id
  }
}

部署模板时，需要获取存在于其他订阅或资源组中的资源，请使用 resourceId 函数。此函数返回资源的完全限定名称。

函数中的 resourceId 订阅和资源组参数是可选的。如果您未提供这些信息，将默认使用当前的订阅和资源组。处理其他资源组或订阅中的资源时，请确保提供这些值。

以下示例获取另一个资源组中的资源的资源 ID。

"properties": {
  "name": "[parameters('siteName')]",
  "serverFarmId": "[resourceId('plangroup', 'Microsoft.Web/serverfarms', parameters('hostingPlanName'))]"
}

解决方案 4：从资源获取托管标识

肱二头肌
JSON

如果要部署具有托管标识的资源，则必须等到部署该资源，然后才能检索托管标识上的值。为应用了该标识的资源使用隐式依赖关系。此方法可确保在 Resource Manager 使用依赖项之前部署资源和托管标识。

可以获取应用于虚拟机的托管标识的主体 ID 和租户 ID。例如，如果虚拟机资源具有符号名称 vm，请使用以下语法：

vm.identity.principalId

vm.identity.tenantId

如果要部署具有托管标识的资源，则必须等到部署该资源，然后才能检索托管标识上的值。如果将托管标识名称传递给引用函数，资源管理器会尝试在部署资源和标识之前解析引用。请改为应用标识的资源的名称。此方法可确保在资源管理器解析引用函数之前部署资源和托管标识。

在引用函数中，使用 Full 来获取包括托管标识在内的所有属性。

模式为：

"[reference(resourceId(<resource-provider-namespace>, <resource-name>), <API-version>, 'Full').Identity.propertyName]"

重要

不要使用该模式：

"[reference(concat(resourceId(<resource-provider-namespace>, <resource-name>),'/providers/Microsoft.ManagedIdentity/Identities/default'),<API-version>).principalId]"

模板将失败。

例如，若要获取应用于虚拟机的托管标识的主体 ID，请使用：

"[reference(resourceId('Microsoft.Compute/virtualMachines', variables('vmName')), '2022-03-01', 'Full').identity.principalId]",

或者，若要获取应用于虚拟机规模集的托管标识的租户 ID，请使用：

"[reference(resourceId('Microsoft.Compute/virtualMachineScaleSets',  variables('vmNodeType0Name')), '2022-03-01', 'Full').Identity.tenantId]"

解决方案 5：检查函数

肱二头肌
JSON

可以使用资源的符号名称从资源获取值。可以使用符号名称引用同一资源组或其他资源组中的存储帐户。若要从已部署的资源获取值，请使用现有关键字。如果资源位于其他资源组中，请与 resourceGroup 函数一起使用scope。在大多数情况下，不需要引用函数。

以下示例引用其他资源组中的现有存储帐户。

resource stgAcct 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
  name: stgname
  scope: resourceGroup(rgname)
}

部署模板时，查找使用引用或 listKeys 函数的表达式。提供的值因资源是否位于同一模板、资源组和订阅中而异。检查是否为方案提供所需的参数值。如果资源位于其他资源组中，请提供完整的资源 ID。例如，若要引用另一个资源组中的存储帐户，请使用：

"[reference(resourceId('exampleResourceGroup', 'Microsoft.Storage/storageAccounts', 'myStorage'), '2022-05-01')]"

解决方案 6：删除资源后

删除资源时，可能会有一小段时间，资源仍显示在门户中但不可用。如果选择该资源，将收到一个错误，指出 找不到该资源。

Azure 门户的屏幕截图，其中显示了资源“概述”部分中出现“找不到”错误消息的已删除资源。

刷新门户，应从可用资源列表中删除已删除的资源。如果已删除的资源继续显示为可用超过几分钟，请联系支持人员。

通过