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
AccountNameInvalid Siga as diretrizes de nomenclatura para contas de armazenamento. Resolver erros para nomes de contas de armazenamento
AccountPropertyCannotBeSet Verifique as propriedades da conta de armazenamento disponíveis. storageContas
AllocationFailed 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.
AuthorizationFailed 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.
Controle de acesso baseado em função do Azure (Azure RBAC)

Resolver registo
BadRequest 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.
DeploymentActiveAndUneditable Aguarde a conclusão da implantação simultânea neste grupo de recursos.
DeploymentFailedCleanUp 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
DeploymentNameInvalidCharacters O nome da implantação só pode conter letras, dígitos, hífen (-), ponto (.) ou sublinhado (_).
DeploymentNameLengthLimitExceeded Os nomes de implantação são limitados a 64 caracteres.
DeploymentFailed 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
DeploymentQuotaExceeded 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
DeploymentJobSizeExceeded 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.
ImageNotFound 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
InternalServerError Causado por um problema temporário. Repita a implantação.
InUseSubnetCannotBeDeleted 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
InvalidAuthenticationTokenTenant 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
InvalidDeploymentLocation 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
InvalidParameter 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
InvalidRequestContent 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
InvalidRequestFormat Habilite o log de depuração ao executar a implantação e verifique o conteúdo da solicitação. Registo de depuração
InvalidResourceLocation Indique um nome único para a conta de armazenamento. Resolver erros para nomes de contas de armazenamento
InvalidResourceNamespace Verifique o namespace de recurso especificado na propriedade type . Referência de modelo
InvalidResourceReference 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
InvalidResourceType Verifique o tipo de recurso especificado na propriedade type . Referência de modelo
InvalidSubscriptionRegistrationState Registe a sua subscrição junto do fornecedor de recursos. Resolver registo
InvalidTemplateDeployment
InvalidTemplate
Verifique se há erros na sintaxe do modelo. Resolver modelo inválido
InvalidTemplateCircularDependency Remova dependências desnecessárias. Resolver dependências circulares
JobSizeExceeded Simplifique seu modelo para reduzir o tamanho. Resolver erros de tamanho de modelo
LinkedAuthorizationFailed 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
LocationRequired 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
MissingRegistrationForLocation Verifique o status de registro do provedor de recursos e os locais suportados. Resolver registo
MissingSubscriptionRegistration Registe a sua subscrição junto do fornecedor de recursos. Resolver registo
NoRegisteredProviderFound Verifique o status de registro do provedor de recursos. Resolver registo
NotFound 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
OperationNotAllowed 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
OperationNotAllowedOnVMImageAsVMsBeingProvisioned 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.
ParentResourceNotFound 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.
PrivateIPAddressInReservedRange 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
PrivateIPAddressNotInSubnet 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
PropertyChangeNotAllowed Algumas propriedades não podem ser alteradas em um recurso implantado. Ao atualizar um recurso, limite as alterações às propriedades permitidas. Atualizar recurso
PublicIPCountLimitReached 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
RegionDoesNotAllowProvisioning Selecione uma região diferente ou envie uma solicitação de suporte de cota para acesso à região.
RequestDisallowedByPolicy 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
ResourceGroupBeingDeleted Aguarde a conclusão da exclusão.
ResourceGroupNotFound 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 CLI PowerShell
ResourceNotFound 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
ResourceQuotaExceeded 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
SkuNotAvailable Selecione SKU (como tamanho da VM) disponível para o local selecionado. Resolver SKU
StorageAccountAlreadyTaken
StorageAccountJáExiste
Indique um nome único para a conta de armazenamento. Resolver erros para nomes de contas de armazenamento
StorageAccountInAnotherResourceGroup Indique um nome único para a conta de armazenamento. Resolver erros para nomes de contas de armazenamento
StorageAccountNotFound 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
SubnetIsFull 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
SubscriptionRequestsThrottled 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
TemplateResourceCircularDependency Remova dependências desnecessárias. Resolver dependências circulares
TooManyTargetResourceGroups 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.