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.