Устранение ошибок типа "Ресурс не найден"

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

Причина

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

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

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

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

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

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

Решение 2. Задание зависимостей

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

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

Bicep

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

Например, свойство 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 для создания явной зависимости.

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

JSON

Если ресурс необходимо развернуть после другого, используйте в шаблоне элемент dependsOn.

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

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

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

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

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

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

1. Войдите на портал.

2. В группе ресурсов Обзорвыберите ссылку на историю развертывания.

   

3. Для имени развертывания, которое вы хотите просмотреть, выберите Связанные события.

   

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

   

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

   

Решение 3. Получение внешнего ресурса

Bicep

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

JSON

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

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

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

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

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

Bicep

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

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

vm.identity.principalId

vm.identity.tenantId

JSON

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

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

Bicep

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

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

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

JSON

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

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

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

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

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