Localizar códigos de erro

Quando uma implantação de recursos do Azure falha usando modelos do ARM ou arquivos Bicep e é recebido um código de erro. Este artigo descreve como encontrar códigos de erro para que você possa solucionar o problema. Para obter mais informações sobre códigos de erro, consulte erros comuns de implantação.

Tipos de erro

Há três tipos de erros relacionados a uma implantação:

• Os erros de validação ocorrem antes do início de uma implantação e são causados por erros de sintaxe em seu arquivo. Um editor de código como Visual Studio Code pode identificar esses erros.
• Erros de validação de simulação ocorrem quando um comando de implantação é executado, mas os recursos não são implantados. Esses erros são encontrados sem que seja necessário iniciar a implantação. Por exemplo, se um valor de parâmetro estiver incorreto, o erro será encontrado na validação de simulação.
• Os erros de implantação ocorrem durante o processo de implantação e só podem ser encontrados por meio da avaliação do progresso da implantação no seu ambiente do Azure.

Todos os tipos de erros retornam um código de erro que você usa para solucionar problemas de implantação. Os erros de validação de simulação são mostrados no log de atividades, mas não aparecem no histórico de implantação. Um arquivo Bicep com erros de sintaxe não é compilado em JSON nem mostrado no log de atividades.

Para identificar erros de sintaxe, você pode usar o Visual Studio Code com a extensão Bicep mais recente ou a extensão ferramentas do Azure Resource Manager.

Erros de validação

Os modelos são validados durante o processo de implantação e os códigos de erro são exibidos. Antes de executar uma implantação, você pode identificar erros de validação e pré-vôo executando testes de validação com o Azure PowerShell ou a CLI do Azure.

Portal

Um modelo de ARM pode ser implementado a partir do portal. Se o modelo tiver erros de sintaxe, você verá um erro de validação ao tentar executar a implantação. Para obter mais informações sobre implantações de portal, consulte implantar recursos do modelo personalizado.

O exemplo a seguir tenta implantar uma conta de armazenamento e ocorre um erro de validação.

Selecione a mensagem para obter mais detalhes. O modelo tem um erro de sintaxe com código InvalidTemplatede erro. O Resumo mostra que uma expressão está faltando um parêntese de fechamento.

PowerShell

Para validar um modelo do ARM antes da implantação, execute Test-AzResourceGroupDeployment.

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

A saída exibe códigos de erro como InvalidTemplateDeployment ou AccountNameInvalid que você pode usar para solucionar problemas e corrigir o modelo.

Para um arquivo Bicep, a saída para um problema de validação de sintaxe mostra um erro de parâmetro.

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.

Para obter mais informações de solução de problemas, use o comando de build do Bicep. A saída mostra a linha e o número da coluna de cada erro entre parênteses e a mensagem de erro.

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.

Outros escopos

Há cmdlets do Azure PowerShell para validar modelos de implantação para os escopos de assinatura, grupo de gerenciamento e locatário.

Escopo	Cmdlets
Subscrição	Test-AzDeployment
Grupo de gerenciamento	Test-AzManagementGroupDeployment
Inquilino	Test-AzTenantDeployment

Azure CLI

Para validar um modelo do ARM antes da implantação, execute az deployment group validate.

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

A saída exibe códigos de erro como InvalidTemplateDeployment ou AccountNameInvalid que você pode usar para solucionar problemas e corrigir o modelo.

Para um arquivo Bicep, a saída mostra o número de linha e coluna de cada erro entre parênteses e a mensagem de erro.

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.

Outros escopos

Há comandos da CLI do Azure para validar modelos de implantação para os escopos de assinatura, grupo de gerenciamento e locatário.

Escopo	Comandos
Subscrição	az deployment sub validate
Grupo de gerenciamento	az deployment mg validate
Inquilino	az deployment tenant validate

Erros de implantação

Várias operações são processadas para implantar um recurso do Azure. Erros de implantação ocorrem quando uma operação passa pela validação, mas falha durante a implantação. Você pode exibir mensagens sobre cada operação de implantação e cada implantação para um grupo de recursos.

Portal

Para ver mensagens sobre as operações de uma implantação, use o log de atividades do grupo de recursos:

1. Entre no portal do Azure.

2. Vá para grupos de recursos e selecione o nome do grupo de recursos da implantação.

3. Selecione o log de atividades.

4. Use os filtros para localizar o log de erros de uma operação.

   

5. Selecione o log de erros para ver os detalhes da operação.

   

Para exibir o resultado de uma implantação:

1. Vá para o grupo de recursos.

2. Selecione Configurações>Implantações.

3. Selecione Detalhes do erro para implantação.

   

4. A mensagem de erro e o código NoRegisteredProviderFound de erro são mostrados.

   

PowerShell

Para ver mensagens de operação de uma implantação com o PowerShell, use Get-AzResourceGroupDeploymentOperation.

Para mostrar todas as operações de uma implantação:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Para especificar um tipo de propriedade específico:

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

Para obter o resultado de uma implantação, use Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Outros escopos

Existem cmdlets do Azure PowerShell para obter informações de implantação para os escopos de assinatura, grupo de gerenciamento e locatário.

Escopo	Cmdlets
Subscrição	Get-AzDeploymentOperation Get-AzDeployment
Grupo de gerenciamento	Get-AzManagementGroupDeploymentOperation Get-AzManagementGroupDeployment
Inquilino	Get-AzTenantDeploymentOperation Get-AzTenantDeployment

Azure CLI

Para ver mensagens de operações de uma implantação com a CLI do Azure, use az deployment operation group list.

Para mostrar todas as operações de uma implantação:

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

Para especificar um tipo de propriedade específico:

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

Para obter o resultado de uma implantação, use az deployment group show.

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

Outros escopos

Existem cmdlets da CLI do Azure para obter informações de implantação para os escopos de assinatura, grupo de gerenciamento e locatário.

Escopo	Comandos
Subscrição	az deployment operation sublist az deployment sub show
Grupo de gerenciamento	az deployment operation mg list az deployment mg show
Inquilino	az deployment operation tenant list az deployment tenant show

Próximas etapas

• Erros de implantação comuns
• Habilitar o log de depuração
• Criar modelo de solução de problemas