Partilhar via


Resolver erros de implementação do Azure comuns

Este artigo descreve como solucionar erros comuns de implantação do Azure e fornece informações sobre soluções. Os recursos do Azure podem ser implementados com ficheiros do Bicep ou com modelos do Azure Resource Manager (modelos do ARM). Se não encontrar o código de erro para o erro de implementação, veja Localizar código de erro.

Se o código de erro não estiver listado, submeta um Problema do GitHub. No lado direito da página, selecione Feedback. Na parte inferior da página, em Comentários, selecione Esta página. Forneça seu feedback sobre a documentação, mas não inclua informações confidenciais porque os problemas do GitHub são públicos.

Códigos de erro

Código de erro Mitigação Mais informações
NomeDeContaInválido Siga as diretrizes de nomenclatura para contas de armazenamento. Resolver erros para nomes de contas de armazenamento
PropriedadeDaContaNãoPodeSerDefinida Verifique as propriedades da conta de armazenamento disponíveis. storageContas
FalhaNaAtribuição O cluster ou região não tem recursos disponíveis ou não pode suportar o tamanho de VM solicitado. Repita a solicitação posteriormente ou solicite um tamanho de VM diferente. Problemas de aprovisionamento e de alocação do Linux

Problemas de aprovisionamento e de alocação do Windows

Resolver problemas de falhas de alocação
OutraOperaçãoEm Progresso Aguarde a conclusão da operação simultânea.
Falha na Autorização Sua conta ou entidade de serviço não tem acesso suficiente para concluir a implantação. Verifique a função à qual sua conta pertence e seu acesso para o escopo de implantação.

Você pode receber esse erro quando um provedor de recursos necessário não estiver registrado.
Controlo de acesso baseado em funções do Azure (RBAC do Azure)

Resolver registo
Pedido Inválido Você enviou valores de implantação que não correspondem ao esperado pelo Gerenciador de Recursos. Verifique a mensagem de status interna para obter ajuda com a solução de problemas.

Valide a sintaxe do modelo para resolver erros de implantação ao usar um modelo que foi exportado de um recurso existente do Azure.
Referência de modelo

Local do recurso no modelo ARM

Local do recurso no arquivo Bicep

Resolver modelo inválido
Conflito Você está solicitando uma operação que não é permitida no estado atual do recurso. Por exemplo, o redimensionamento de disco é permitido somente ao criar uma VM ou quando a VM é deslocalizada.
DesdobramentoAtivoEInalterável Aguarde a conclusão da implantação simultânea neste grupo de recursos.
FalhaNaImplementaçãoLimpeza Quando você implanta no modo completo, todos os recursos que não estão no modelo são excluídos. Você recebe esse erro quando não tem permissões adequadas para excluir todos os recursos que não estão no modelo. Para evitar o erro, altere o modo de implantação para incremental. Modos de implementação do Azure Resource Manager
NomeDeImplementaçãoCaracteresInválidos O nome da implantação só pode conter letras, dígitos, hífen (-), ponto (.) ou sublinhado (_).
LimiteDeComprimentoDoNomeDeImplementaçãoExcedido Os nomes de implantação são limitados a 64 caracteres.
FalhaNaImplementação O erro DeploymentFailed é um erro geral que não fornece os detalhes necessários para resolver o erro. Procure nos detalhes do erro um código de erro que forneça mais informações. Localizar código de erro
Limite de Implementação Excedido Se você atingir o limite de 800 implantações por grupo de recursos, exclua as implantações do histórico que não são mais necessárias. Resolver o erro quando a contagem de implementações excede as 800
TamanhoDoTrabalhoDeImplantaçãoExcedido Simplifique seu modelo para reduzir o tamanho. Resolver erros de tamanho de modelo
DnsRecordInUse O nome do registro DNS deve ser exclusivo. Insira um nome diferente.
ImagemNãoEncontrada Verifique as configurações de imagem da VM.
Imagem inacessível A implantação da Instância de Contêiner do Azure falha. Talvez seja necessário incluir a tag da imagem com a sintaxe registry/image:tag para implantar o contêiner. Para um registro privado, verifique se suas credenciais estão corretas. Localizar código de erro
Erro Interno do Servidor Causado por um problema temporário. Repita a implantação.
Sub-redeEmUsoNãoPodeSerExcluída Este erro pode ocorrer quando você tenta atualizar um recurso, se o processo de solicitação exclui e cria o recurso. Certifique-se de especificar todos os valores inalterados. Atualizar recurso
Token de Autenticação Inválido do Inquilino Obtenha o token de acesso para o locatário apropriado. Só pode obter o token do inquilino a que a sua conta pertence.
InvalidContentLink Você provavelmente tentou vincular a um modelo aninhado que não está disponível. Verifique novamente o URI fornecido para o modelo aninhado. Se o modelo existir em uma conta de armazenamento, verifique se o URI está acessível. Talvez seja necessário passar um token SAS. Atualmente, você não pode vincular a um modelo que esteja em uma conta de armazenamento atrás de um firewall de Armazenamento do Azure. Considere mover seu modelo para outro repositório, como o GitHub. Modelos ARM vinculados e aninhados

Módulos bíceps
LocalizaçãoDeImplantaçãoInválida Ao implantar no nível de assinatura, você forneceu um local diferente para um nome de implantação usado anteriormente. Implantação de assinatura de modelo ARM

Implantação da assinatura do Bíceps
ParâmetroInválido Um dos valores fornecidos para um recurso não corresponde ao valor esperado. Este erro pode resultar de muitas condições diferentes. Por exemplo, uma senha pode ser insuficiente ou um nome de blob pode estar incorreto. A mensagem de erro deve indicar qual valor precisa ser corrigido. Parâmetros do modelo ARM

Parâmetros do bíceps
Conteúdo de Pedido Inválido Os valores de implantação incluem valores que não são reconhecidos ou os valores necessários estão faltando. Confirme os valores para o seu tipo de recurso. Referência de modelo
FormatoDePedidoInválido Habilite o log de depuração ao executar a implantação e verifique o conteúdo da solicitação. Registo de depuração
LocalizaçãoDeRecursoInválida Indique um nome único para a conta de armazenamento. Resolver erros para nomes de contas de armazenamento
Espaço de Nomes Inválido Verifique o namespace de recurso especificado na propriedade type . Referência de modelo
ReferênciaDeRecursoInválida O recurso ainda não existe ou está referenciado incorretamente. Verifique se você precisa adicionar uma dependência. Verifique se o uso da função de referência inclui os parâmetros necessários para o cenário. Resolver dependências
TipoDeRecursoInválido Verifique o tipo de recurso especificado na propriedade type . Referência de modelo
EstadoDeRegistoDeSubscriçãoInválido Registe a sua subscrição junto do fornecedor de recursos. Resolver registo
InvalidTemplateDeployment
ModeloInválido
Verifique se há erros na sintaxe do modelo. Resolver modelo inválido
InvalidTemplateCircularDependency (Dependência Circular de Modelo Inválida) Remova dependências desnecessárias. Resolver dependências circulares
TamanhoDoTrabalhoExcedido Simplifique seu modelo para reduzir o tamanho. Resolver erros de tamanho de modelo
FalhaNaAutorizaçãoVinculada Verifique se sua conta pertence ao mesmo locatário do grupo de recursos no qual você está implantando.
LinkedInvalidPropertyId A ID do recurso de um recurso não foi resolvida. Verifique se você forneceu todos os valores necessários para a ID do recurso. Por exemplo, ID da assinatura, nome do grupo de recursos, tipo de recurso, nome do recurso pai (se necessário) e nome do recurso. Resolver erros de nome e tipo de recurso
Localização Obrigatória Forneça um local para o recurso. Local do recurso no modelo ARM

Local do recurso no arquivo Bicep
IncompatibilidadeResourceSegments Verifique se um recurso aninhado tem o número correto de segmentos no nome e no tipo. Resolver segmentos de recursos
Falta de Registo para Localização Verifique o status de registro do provedor de recursos e os locais suportados. Resolver registo
Registo de Subscrição em Falta Registe a sua subscrição junto do fornecedor de recursos. Resolver registo
Nenhum Fornecedor Registado Encontrado Verifique o status de registro do provedor de recursos. Resolver registo
Não encontrado Você pode estar tentando implantar um recurso dependente em paralelo com um recurso pai. Verifique se você precisa adicionar uma dependência. Resolver dependências
OperaçãoNãoPermitida Pode haver várias razões para essa mensagem de erro.

1. A implantação está tentando uma operação que não é permitida no SKU especificado.

2. A implantação está tentando uma operação que excede a cota para a assinatura, grupo de recursos ou região. Se possível, revise sua implantação para permanecer dentro das cotas. Caso contrário, considere solicitar uma alteração às suas quotas.
Resolver cotas
OperaçãoNãoPermitidaNaImagemVMEnquantoVMsEstãoSendoProvisionadas Você pode estar tentando excluir uma imagem que está sendo usada atualmente para provisionar VMs. Não é possível excluir uma imagem que está sendo usada por qualquer máquina virtual durante o processo de implantação. Repita a operação de exclusão de imagem após a conclusão da implantação da VM.
RecursoPaiNãoEncontrado Verifique se existe um recurso pai antes de criar os recursos filho. Resolver recurso pai
SenhaTooLong Você pode ter selecionado uma senha com muitos caracteres ou convertido o valor da senha em uma cadeia de caracteres segura antes de passá-la como parâmetro. Se o modelo incluir um parâmetro de cadeia de caracteres segura, você não precisará converter o valor em uma cadeia de caracteres segura. Forneça o valor da senha como texto.
Endereço IP Privado em Faixa Reservada O endereço IP especificado inclui um intervalo de endereços exigido pelo Azure. Altere o endereço IP para evitar o intervalo reservado. Endereços IP privados
EndereçoIPPrivadoForaDaSub-rede O endereço IP especificado está fora do intervalo de sub-rede. Altere o endereço IP para estar dentro do intervalo de sub-rede. Endereços IP privados
AlteraçãoDePropriedadeNãoPermitida Algumas propriedades não podem ser alteradas em um recurso implantado. Ao atualizar um recurso, limite as alterações às propriedades permitidas. Atualizar recurso
LimiteDoContadorDeIPsPúblicosAtingido Você atingiu o limite para o número de IPs públicos em execução. Desligue recursos desnecessários ou entre em contato com o suporte do Azure para solicitar um aumento. Por exemplo, no Azure Databricks, consulte Terminação inesperada de cluster e limite de endereço IP impede a criação de cluster. Limites de endereços IP públicos
A região não permite o provisionamento Selecione uma região diferente ou envie uma solicitação de suporte de cota para acesso à região.
PedidoNegadoPorPolítica Sua assinatura inclui uma política de recursos que impede uma ação que você está tentando fazer durante a implantação. Encontre a política que bloqueia a ação. Se possível, altere sua implantação para atender às limitações da política. Resolver políticas
ReservedResourceName Forneça um nome de recurso que não inclua um nome reservado. Nomes de recursos reservados
GrupoDeRecursosASerEliminado Aguarde a conclusão da exclusão.
GrupoDeRecursosNãoEncontrado Verifique o nome do grupo de recursos de destino para a implantação. O grupo de recursos de destino já deve existir na sua assinatura. Verifique o contexto da sua subscrição. Azure CLIPowerShell
RecursoNãoEncontrado Sua implantação faz referência a um recurso que não pode ser resolvido. Verifique se o uso da função de referência inclui os parâmetros necessários para o cenário. Resolver referências
Cota de Recursos Excedida A implantação está tentando criar recursos que excedem a cota para a assinatura, grupo de recursos ou região. Se possível, reveja a sua infraestrutura para se manter dentro das quotas. Caso contrário, considere solicitar uma alteração às suas quotas. Resolver cotas
SKUIndisponível Selecione SKU (como tamanho da VM) disponível para o local selecionado. Resolver SKU
ContaDeArmazenamentoJáUtilizada
StorageAccountJáExiste
Indique um nome único para a conta de armazenamento. Resolver erros para nomes de contas de armazenamento
ContaDeArmazenamentoNoutroGrupoDeRecursos Indique um nome único para a conta de armazenamento. Resolver erros para nomes de contas de armazenamento
Conta de Armazenamento Não Encontrada Verifique a subscrição, o grupo de recursos e o nome da conta de armazenamento que está a tentar utilizar.
Sub-redesNotInSameVnet Uma máquina virtual só pode ter uma rede virtual. Ao implantar várias NICs, verifique se elas pertencem à mesma rede virtual. VM do Windows várias NICs

VM Linux várias NICs
Sub-rede Está Cheia Não há endereços disponíveis suficientes na sub-rede para implantar recursos. Você pode liberar endereços da sub-rede, usar uma sub-rede diferente ou criar uma nova sub-rede. Perguntas frequentes sobre gerenciamento de sub-redes e rede virtual

Endereços IP privados
AssinaturaNotFound Não é possível aceder a uma subscrição especificada para implementação. Pode ser que o ID da assinatura esteja errado, o usuário que implanta o modelo não tenha permissões adequadas para implantar na assinatura ou o ID da assinatura esteja no formato errado. Ao usar implantações aninhadas de modelo ARM para implantar em escopos, forneça o GUID da assinatura. Modelo ARM implantado em escopos

Implantação do arquivo Bicep em escopos
SubscriçãoNotRegistered Quando um recurso é implantado, o provedor de recursos deve estar registrado para sua assinatura. Quando você usa um modelo do Azure Resource Manager para implantação, o provedor de recursos é registrado automaticamente na assinatura. Por vezes, o registo automático não é concluído a tempo. Para evitar esse erro intermitente, registre o provedor de recursos antes da implantação. Resolver registo
SolicitaçõesDeAssinaturaLimiteExcedido O Azure Resource Manager limita as solicitações no nível de assinatura ou no nível de locatário. Provedores de recursos como Microsoft.Compute também aceleram solicitações específicas para suas operações.

Quando um limite é atingido, você recebe uma mensagem e um valor com a quantidade de tempo que você deve esperar antes de enviar uma nova solicitação. Por exemplo: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds.

Uma resposta HTTP retorna uma mensagem como HTTP status code 429 Too Many Requests com um Retry-After valor que especifica o número de segundos a aguardar antes de enviar outra solicitação.
Limitação dos pedidos do Resource Manager

Solução de problemas de erros de limitação de API - máquinas virtuais

Limitação do Serviço Kubernetes do Azure
Template de Dependência Circular de Recursos Remova dependências desnecessárias. Resolver dependências circulares
GruposDeRecursosAlvoEmExcesso Reduza o número de grupos de recursos para uma única implantação. Modelo ARM implantado em escopos

Implantação do arquivo Bicep em escopos

Próximos passos

  • Para obter informações sobre erros de validação ou implantação, consulte Localizar códigos de erro.
  • Para obter mais detalhes sobre como solucionar problemas de uma implantação, consulte Habilitar log de depuração.
  • Para isolar a causa de um erro de implantação, consulte Criar um modelo de solução de problemas.