Поиск кодов ошибок

Если при развертывании ресурсов Azure не удается использовать шаблоны Azure Resource Manager (шаблоны ARM) или файлы Bicep, то выдается код ошибки. В этой статье описывается, как найти коды ошибок, чтобы устранить проблему. Дополнительные сведения о кодах ошибок см. в распространенных ошибках развертывания.

Типы ошибок

Существует три типа ошибок, связанных с развертыванием.

• Ошибки проверки возникают перед началом развертывания и вызваны синтаксической ошибкой в файле. Редактор кода, например Visual Studio Code, может определить эти ошибки.
• Ошибки предварительной проверки возникают при выполнении команды развертывания, но ресурсы не развертываются. Эти ошибки обнаруживаются без запуска развертывания. Например, если значение параметра является неверным, то в ходе предварительной проверки будет обнаружена ошибка.
• Ошибки развертывания возникают во время процесса развертывания и могут быть найдены только путем оценки хода развертывания в среде Azure.

Ошибки всех типов возвращают код ошибки, с помощью которого можно устранить неполадки развертывания. Сведения об ошибках проверки перед запуском отображаются в журнале действий, но не отображаются в журнале развертывания. BICEP-файл с синтаксическими ошибками не компилируется в JSON-файл и не отображается в журнале действий.

Чтобы определить синтаксические ошибки, можно использовать Visual Studio Code с последним расширением Bicep или расширением средств Azure Resource Manager.

Ошибки проверки

Шаблоны проверяются во время процесса развертывания и отображаются коды ошибок. Перед запуском развертывания можно определить ошибки проверки и предварительной проверки, выполнив тесты проверки с помощью Azure PowerShell или Azure CLI.

Портал

Шаблон ARM можно развернуть на портале. Если шаблон имеет синтаксические ошибки, при попытке запустить развертывание появится ошибка проверки. Дополнительные сведения о развертываниях портала см. в статье о развертывании ресурсов из пользовательского шаблона.

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

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

PowerShell

Чтобы проверить шаблон ARM перед развертыванием, выполните Test-AzResourceGroupDeployment.

Test-AzResourceGroupDeployment `
  -ResourceGroupName examplegroup `
  -TemplateFile azuredeploy.json

В выходных данных отображаются коды ошибок, например InvalidTemplateDeployment или AccountNameInvalid которые можно использовать для устранения неполадок и исправления шаблона.

В файле Bicep выходные данные для проблемы проверки синтаксиса показывают ошибку параметра.

Test-AzResourceGroupDeployment: Cannot retrieve the dynamic parameters for the cmdlet.
Cannot find path '/tmp/11111111-1111-1111-1111-111111111111/main.json' because it does not exist.

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

bicep build main.bicep

/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
  unexpected new line character.

Другие области

Существуют командлеты Azure PowerShell для проверки шаблонов развертывания для подписки, группы управления и областей клиента.

Область действия	командлеты
Подписка	Test-AzDeployment
Группа управления	Test-AzManagementGroupDeployment
Арендатор	Test-AzTenantDeployment

Azure CLI

Чтобы проверить шаблон ARM перед развертыванием, выполните команду az deployment group validate.

az deployment group validate \
  --resource-group examplegroup \
  --template-file azuredeploy.json

В выходных данных отображаются коды ошибок, например InvalidTemplateDeployment или AccountNameInvalid которые можно использовать для устранения неполадок и исправления шаблона.

В файле Bicep выходные данные отображают номер строки и столбца каждой ошибки в скобках и сообщение об ошибке.

az deployment group validate \
  --resource-group examplegroup \
  --template-file main.bicep

/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
  unexpected new line character.

Другие области

Существуют команды Azure CLI для проверки шаблонов развертывания для подписки, группы управления и областей клиента.

Область действия	Команды
Подписка	az deployment sub validate
Группа управления	az deployment mg validate
Арендатор	az deployment tenant validate

Ошибки развертывания

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

Портал

Чтобы просмотреть сообщения об операциях развертывания, используйте журнал действий группы ресурсов:

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

2. Перейдите в группы ресурсов и выберите имя группы ресурсов развертывания.

3. Выберите журнал действий.

4. Используйте фильтры для поиска журнала ошибок операции.

   

5. Выберите журнал ошибок, чтобы просмотреть сведения об операции.

   

Чтобы просмотреть результат развертывания, выполните приведенные ниже действия.

1. Перейдите в группу ресурсов.

2. Выберите "Параметры>развертывания".

3. Выберите сведения об ошибке для развертывания.

   

4. Отображается сообщение об ошибке и код NoRegisteredProviderFound ошибки.

   

PowerShell

Чтобы просмотреть сообщения об операциях развертывания с помощью PowerShell, используйте Get-AzResourceGroupDeploymentOperation.

Чтобы отобразить все операции развертывания, выполните следующие действия.

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Чтобы указать определенный тип свойства, выполните указанные действия.

(Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup).StatusCode

Чтобы получить результат развертывания, используйте Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Другие области

Существуют командлеты Azure PowerShell для получения сведений о развертывании для подписки, группы управления и областей клиента.

Область действия	командлеты
Подписка	Get-AzDeploymentOperation Get-AzDeployment
Группа управления	Get-AzManagementGroupDeploymentOperation Get-AzManagementGroupDeployment (Get-AzManagementGroupDeployment)
Арендатор	Get-AzTenantDeploymentOperation Get-AzTenantDeployment

Azure CLI

Чтобы просмотреть сообщения об операциях развертывания с помощью Azure CLI, используйте az deployment operation group list.

Чтобы отобразить все операции развертывания, выполните следующие действия.

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties"

Чтобы указать определенный тип свойства, выполните указанные действия.

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties.statusCode"

Чтобы получить результат развертывания, используйте az deployment group show.

az deployment group show \
  --resource-group examplegroup \
  --name exampledeployment

Другие области

Существуют команды Azure CLI для получения сведений о развертывании для подписки, группы управления и областей клиента.

Область действия	Команды
Подписка	az deployment operation sub list az deployment sub show
Группа управления	az deployment operation mg list az deployment mg show
Арендатор	az deployment operation tenant list az deployment tenant show

Дальнейшие шаги

• Распространенные ошибки развертывания
• Включение ведения журнала отладки
• Создание шаблона устранения неполадок