Устранение ошибок, связанных с отсутствием ресурса

Статья
2025-04-28

В этой статье описывается ошибка, которую вы видите, когда ресурс не удается найти во время операции. Как правило, эта ошибка возникает при развертывании ресурсов с помощью Bicep-файла или шаблона Azure Resource Manager (шаблона ARM). Эта ошибка также возникает при выполнении задач управления и Azure Resource Manager не может найти необходимый ресурс. Например, если вы пытаетесь добавить теги в ресурс, который не существует, вы получите эту ошибку.

Симптомы

Существует два кода ошибки, указывающие, что ресурс не найден. Ошибка 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.

Причина

Resource Manager должен получить свойства ресурса, но не удается найти ресурс в подписке.

Решение 1. Проверка свойств ресурса

В случае возникновения этой ошибки во время выполнения задачи управления проверьте значения, предоставленные для ресурса. Ниже приведены три проверяемых значения:

Имя ресурса
Имя группы ресурсов
Подписка

Если вы используете PowerShell или Azure CLI, убедитесь, что вы выполняете команды в подписке, содержащей ресурс. Вы можете изменить подписку командой Set-AzContext или az account set. У многих команд есть параметр подписки, позволяющий задать другую подписку, отличающуюся от текущего контекста.

Если вы не можете проверить свойства, войдите на портал Microsoft Azure. Найдите ресурс, который пытаетесь использовать, и проверьте имя ресурса, группу ресурсов и подписку.

Решение 2. Установка зависимостей

Если при развертывании шаблона возникает эта ошибка, может потребоваться добавить зависимость. Resource Manager оптимизирует развертывания, создавая ресурсы параллельно, когда это возможно.

Например, при развертывании веб-приложения план службы приложений должен существовать. Если вы не указали, что веб-приложение зависит от плана службы приложений, Resource Manager создает оба ресурса одновременно. Веб-приложение завершается ошибкой, что ресурс плана службы приложений не найден, так как он еще не существует. Эту ошибку можно предотвратить, задав зависимость в веб-приложении.

Бицепс
JSON

Используйте неявную зависимость , а не функцию resourceId . Зависимость создается с помощью символьного имени ресурса и свойства идентификатора.

Например, свойство веб-приложения serverFarmId использует servicePlan.id для создания зависимости от плана App Service.

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')]"
  ],
  ...
}

Функции ссылок и списков создают неявную зависимость от указанного ресурса, когда этот ресурс развертывается в том же шаблоне и ссылается на его имя (а не идентификатор ресурса). Таким образом, у вас может быть больше зависимостей, чем зависимости, указанные в свойстве dependsOn .

Функция resourceId не создает неявную зависимость или проверяет, существует ли ресурс. Ссылочная функция и функции list* не создают неявную зависимость, если ресурс ссылается на его идентификатор ресурса. Чтобы создать неявную зависимость, передайте имя ресурса, развернутого в том же шаблоне.

Порядок развертывания

При появлении проблем с зависимостью необходимо получить представление о порядке развертывания ресурсов. Вы можете использовать портал для просмотра порядка операций развертывания:

Войдите на портал.
На странице Обзор группы ресурсов выберите ссылку на историю развертывания.
Для названия развертывания, которое вы хотите просмотреть, выберите Связанные события.
Проверьте последовательность событий для каждого ресурса. Обратите внимание на состояние каждой операции и метку времени. Например, на следующем рисунке показаны три учетные записи хранения, развернутые параллельно. Обратите внимание, что три развертывания учетных записей хранения начались одновременно.

На следующем рисунке показаны три учетные записи хранения, которые не развертываются параллельно. Вторая учетная запись хранения зависит от первой учетной записи хранения, а третья учетная запись хранения зависит от второй учетной записи хранения. Первая учетная запись хранения помечена как "Запущено", "Принято" и "Выполнено успешно " до следующего запуска.

Bicep использует символьное имя для создания неявной зависимости от другого ресурса. Существующее ключевое слово ссылается на развернутый ресурс. Если существующий ресурс находится в другой группе ресурсов, отличной от ресурса, который требуется развернуть, включите область и используйте функцию resourceGroup .

В этом примере веб-приложение развертывается, использующее существующий план службы приложений из другой группы ресурсов.

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 функции являются необязательными. Если они не предоставляются, они по умолчанию соответствуют текущей подписке и группе ресурсов. При работе с ресурсом в другой группе ресурсов или подписке убедитесь, что эти значения указаны.

В следующем примере возвращается идентификатор ресурса для ресурса, находящегося в другой группе ресурсов.

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

Решение 4. Получение управляемого удостоверения из ресурса

Бицепс
JSON

Если вы развертываете ресурс с управляемым удостоверением, необходимо подождать, пока не завершится его развертывание, прежде чем получать значения в управляемом удостоверении. Используйте неявную зависимость для ресурса, к которому применена идентичность. Такой подход гарантирует, что ресурс и управляемое удостоверение развертываются до использования зависимостей с помощью Resource Manager.

Вы можете получить идентификатор участника и идентификатор арендатора для управляемого удостоверения, примененного к виртуальной машине. Например, если ресурс виртуальной машины имеет символическое имя vm, используйте следующий синтаксис:

vm.identity.principalId

vm.identity.tenantId

Если вы развертываете ресурс с управляемым удостоверением, необходимо подождать, пока этот ресурс не будет развернут, прежде чем получать значения управляемого удостоверения. Если передать имя управляемого удостоверения в эталонную функцию, Resource Manager пытается разрешить ссылку перед развертыванием ресурса и удостоверения. Вместо этого передайте имя ресурса, к которому применяется идентификатор. Этот подход гарантирует, что ресурс и управляемое удостоверение развертываются перед тем как Resource Manager начнёт разрешение ссылки.

В справочной функции используйте 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]"

Ваш шаблон потерпит неудачу.

Например, чтобы получить идентификатор субъекта для управляемого удостоверения, применяемого к виртуальной машине, используйте следующий формат:

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

Или, чтобы получить идентификатор клиента для управляемого удостоверения, применяемого к масштабируемому набору виртуальных машин, используйте следующий формат:

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

Решение 5. Проверка функций

Бицепс
JSON

Символьное имя ресурса можно использовать для получения значений из ресурса. Вы можете ссылаться на учетную запись хранения в той же группе ресурсов или другой группе ресурсов с помощью символьного имени. Чтобы получить значение из развернутого ресурса, используйте существующее ключевое слово. Если ресурс находится в другой группе ресурсов, используйте scope функцию resourceGroup . В большинстве случаев ссылочная функция не требуется.

В следующем примере осуществляется ссылка на существующую учетную запись хранения в другой группе ресурсов.

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

При развертывании шаблона найдите выражения, использующие функции reference или listKeys. Указанные значения зависят от того, находится ли ресурс в одном шаблоне, группе ресурсов и подписке. Убедитесь, что вы предоставляете необходимые значения параметров для вашего сценария. Если ресурс находится в другой группе ресурсов, укажите полный идентификатор ресурса. Например, чтобы ссылаться на учетную запись хранения в другой группе ресурсов, используйте следующую команду:

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

Решение 6. После удаления ресурса

При удалении ресурса может потребоваться некоторое время, когда ресурс появится на портале, но недоступен. Если выбрать ресурс, вы получите сообщение об ошибке о том, что ресурс не найден.

Снимок экрана: портал Azure с удаленным ресурсом с сообщением об ошибке

Обновите портал и удаленный ресурс следует удалить из списка доступных ресурсов. Если удаленный ресурс продолжает отображаться как доступный в течение более чем нескольких минут, обратитесь в службу поддержки.