Localizar códigos de erro

Quando uma implementação de recursos do Azure falha ao utilizar modelos de Resource Manager do Azure (modelos do ARM) ou ficheiros Bicep, é recebido um código de erro. Este artigo descreve como localizar 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

Existem três tipos de erros relacionados com uma implementação:

• Os erros de validação ocorrem antes do início de uma implantação e são causados por erros de sintaxe no arquivo. Um editor de código como o Visual Studio Code pode identificar esses erros.
• Os erros de validação de comprovação ocorrem quando um comando de implantação é executado, mas os recursos não são implantados. Estes erros são encontrados antes de começar a implementação. Por exemplo, se o valor de um parâmetro estiver incorreto, o erro é encontrado na validação de verificação prévia.
• Os erros de implantação ocorrem durante o processo de implantação e só podem ser encontrados avaliando o progresso da implantação em seu ambiente do Azure.

Todos os tipos de erros devolvem um código de erro que deve utilizar para resolver os problemas da implementação. Os erros de validação e verificação prévia são apresentados no registo de atividades, mas não aparecem no seu histórico de implementações. Um ficheiro Bicep com erros de sintaxe não é compilado em JSON e não é apresentado no registo 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 Azure Resource Manager Tools.

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 comprovação executando testes de validação com o Azure PowerShell ou a CLI do Azure.

Portais

Um modelo ARM pode ser implantado 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 de 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 encerramento.

PowerShell

Para validar um modelo 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 sobre solução de problemas, use o comando build do Bicep. A saída mostra o número da linha e 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 âmbitos de aplicação

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

Âmbito de aplicação	Cmdlets
Subscrição	Test-AzDeployment
Grupo de gestão	Test-AzManagementGroupDeployment
Inquilino	Test-AzTenantDeployment

Azure CLI

Para validar um modelo 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 da linha e da 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 âmbitos de aplicação

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

Âmbito de aplicação	Comandos
Subscrição	Subvalidação de implantação AZ
Grupo de gestão	AZ implantação mg validar
Inquilino	Validação de locatário de implantação AZ

Erros de implementação

Várias operações são processadas para implantar um recurso do Azure. Os erros de implantação ocorrem quando uma operação passa na 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.

Portais

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

1. Inicie sessão no portal do Azure.

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

3. Selecione Registro 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>de implantações.

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

   

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

   

PowerShell

Para ver as mensagens de operações 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 âmbitos de aplicação

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

Âmbito de aplicação	Cmdlets
Subscrição	Get-AzDeploymentOperation Get-AzDeployment
Grupo de gestão	Get-AzManagementGroupDeploymentOperation Get-AzManagementGroupDeployment
Inquilino	Get-AzTenantDeploymentOperation Get-AzTenantDeployment

Azure CLI

Para ver as 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 âmbitos de aplicação

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

Âmbito de aplicação	Comandos
Subscrição	lista de suboperações de implantação az subshow de implantação az
Grupo de gestão	Lista MG da operação de implantação AZ az implantação mg show
Inquilino	Lista de locatários da operação de implantação AZ AZ Deployment Tenant Show

Próximos passos

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