Solucionar erros comuns de implantação do Azure
Este artigo descreve como solucionar problemas de erros comuns de implantação do Azure e fornece informações sobre soluções. Os recursos do Azure podem ser implantados com modelos do Azure Resource Manager (modelos ARM) ou arquivos Bicep. Se não encontrar o código de erro para o erro de implantação, confira Localizar código de erro.
Se o código de erro não estiver listado, envie um problema do GitHub. No lado direito da página, selecione Comentários. Na parte inferior da página, em Comentários, selecione Esta página. Forneça seus comentários sobre a documentação, mas não inclua informações confidenciais porque os problemas do GitHub são públicos.
Códigos do Erro
| Código do erro | Atenuação | Mais informações |
|---|---|---|
| AccountNameInvalid | Siga as diretrizes de nomenclatura para contas de armazenamento. | Solucione erros de nomes de conta de armazenamento |
| AccountPropertyCannotBeSet | Verifique as propriedades da conta de armazenamento disponível. | storageAccounts |
| AllocationFailed | O cluster ou a região não tem recursos disponíveis ou não é compatível com o tamanho solicitado de VM. Repita a solicitação mais tarde ou solicite um tamanho de VM diferente. | Problemas de provisionamento e alocação do Linux Problemas de provisionamento e alocação do Windows Solucionar problemas de falhas de alocação |
| AnotherOperationInProgress | 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 a que sua conta pertence e seu acesso para o escopo da implantação. É possível receber esse erro quando um provedor de recursos necessário não está registrado. |
RBAC do Azure (controle de acesso baseado em função do Azure) Resolver registro |
| BadRequest | Você enviou valores de implantação que não coincidem com o que é esperado pelo Resource Manager. 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 do ARM Local do recurso no arquivo Bicep Resolver modelo inválido |
| Conflito | Você está solicitando uma operação não permitida no estado atual do recurso. Por exemplo, o redimensionamento do disco é permitido apenas ao criar uma VM ou quando a VM é desalocada. | |
| DeploymentActiveAndUneditable | Aguarde a conclusão da implantação simultânea nesse grupo de recursos. | |
| DeploymentFailedCleanUp | Ao usar o modo completo para a implantação, todos os recursos que não estão no modelo são excluídos. Esse erro acontece quando não há permissões adequadas para excluir todos os recursos que não estão no modelo. Para evitá-lo, altere o modo de implantação para incremental. | Modos de implantaçã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 resolvê-lo. Examine os detalhes do erro em busca de um código de erro que fornece mais informações. | Encontrar código do erro |
| DeploymentQuotaExceeded | Caso você atinja o limite de 800 implantações por grupo de recursos, exclua do histórico as implantações que não são mais necessárias. | Resolver o erro que ocorre quando há mais de 800 implantações |
| DeploymentJobSizeExceeded | Simplifique seu modelo para reduzir o tamanho. | Resolver os erros de tamanho do modelo |
| DnsRecordInUse | O nome do registro DNS deve ser exclusivo. Insira um nome diferente. | |
| ImageNotFound | Verifique as configurações de imagem da VM. | |
| InaccessibleImage | Falha na implantação da Instância de Contêiner do Azure. Talvez seja necessário incluir a marca da imagem com a sintaxe registry/image:tag para implantar o contêiner. Para um registro privado, verifique se as credenciais estão corretas. |
Encontrar código do erro |
| InternalServerError | Causado por um problema temporário. Tente novamente a implantação. | |
| InUseSubnetCannotBeDeleted | Esse erro poderá ocorrer quando você tentar atualizar um recurso, se o processo de solicitação excluir e criar o recurso. Certifique-se de especificar todos os valores inalterados. | Atualizar recurso |
| InvalidAuthenticationTokenTenant | Obtenha o token de acesso do locatário correto. Você só pode obter o token do locatário a que sua conta pertence. | |
| InvalidContentLink | Você provavelmente tentou criar um vínculo com um modelo aninhado que não está disponível. Verifique uma segunda vez o URI que você forneceu para o modelo aninhado. Caso o modelo exista em uma conta de armazenamento, verifique se o URI está acessível. Pode ser necessário transmitir um token SAS. No momento, não é possível criar um vínculo com um modelo que está em uma conta de armazenamento atrás de um firewall do Armazenamento do Azure. Considere mover o modelo para outro repositório, como o GitHub. | Modelos do ARM vinculados e aninhados Módulos Bicep |
| 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 do modelo do ARM Implantação de assinatura do Bicep |
| InvalidParameter | Um dos valores que você forneceu para um recurso não corresponde ao valor esperado. Esse erro pode ser decorrente de várias 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 do ARM Parâmetros do Bicep |
| InvalidRequestContent | Os valores da implantação incluem valores não reconhecidos ou os valores necessários estão ausentes. Confirme se os valores para seu tipo de recurso. | Referência de modelo |
| InvalidRequestFormat | Habilite o log da depuração ao executar a implantação e verifique o conteúdo da solicitação. | Registro em log de depuração |
| InvalidResourceLocation | Forneça um nome exclusivo para a conta de armazenamento. | Solucione erros de nomes de conta de armazenamento |
| InvalidResourceNamespace | Verifique o namespace do recurso especificado na propriedade type. | Referência de modelo |
| InvalidResourceReference | O recurso ainda não existe ou foi referenciado incorretamente. Verifique se você precisa adicionar uma dependência. Verifique se o uso da função referência inclui os parâmetros necessários para seu cenário. | Resolver dependências |
| InvalidResourceType | Verifique o tipo de recurso do recurso especificado na propriedade type. | Referência de modelo |
| InvalidSubscriptionRegistrationState | Registre sua assinatura no provedor de recursos. | Resolver registro |
| InvalidTemplateDeployment InvalidTemplate |
Verifique se há erros na sintaxe do modelo. | Resolver modelo inválido |
| InvalidTemplateCircularDependency | Remova as dependências desnecessárias. | Resolver as dependências circulares |
| JobSizeExceeded | Simplifique seu modelo para reduzir o tamanho. | Resolver os erros de tamanho do modelo |
| LinkedAuthorizationFailed | Verifique se sua conta pertence ao mesmo locatário do grupo de recursos em que você está realizando a implantação. | |
| LinkedInvalidPropertyId | A ID de um recurso não está 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 do ARM Local do recurso no arquivo Bicep |
| MismatchingResourceSegments | Verifique se um recurso aninhado tem o número correto de segmentos em nome e tipo. | Resolver segmentos de recurso |
| MissingRegistrationForLocation | Verifique o status do registro do provedor de recursos e os locais com suporte. | Resolver registro |
| MissingSubscriptionRegistration | Registre sua assinatura no provedor de recursos. | Resolver registro |
| NoRegisteredProviderFound | Verifique o status do registro do provedor de recursos. | Resolver registro |
| NotFound | É possível que você esteja tentando implantar um recurso dependente em paralelo com o recurso pai. Verifique se você precisa adicionar uma dependência. | Resolver dependências |
| OperationNotAllowed | Pode haver vários motivos para essa mensagem de erro. 1. A implantação está tentando realizar uma operação que não é permitida no SKU especificado. 2. A implantação está tentando realizar uma operação que excede a cota da assinatura, do grupo de recursos ou da região. Se possível, revise sua implantação para permanecer dentro das cotas. Caso contrário, considere solicitar uma alteração de suas cotas. |
Resolver cotas |
| OperationNotAllowedOnVMImageAsVMsBeingProvisioned | Você pode estar tentando excluir uma imagem que está sendo usada atualmente para provisionar VMs. Você não pode excluir uma imagem que está sendo usada por qualquer máquina virtual durante o processo de implantação. Tente novamente a operação de exclusão da imagem após a conclusão da implantação da VM. | |
| ParentResourceNotFound | Verifique se há um recurso pai antes de criar os recursos filho. | Resolver recurso pai |
| PasswordTooLong | Você pode ter selecionado uma senha com muitos caracteres ou convertido o valor da senha em uma cadeia de caracteres segura antes de transmiti-la como um parâmetro. Se o modelo inclui um parâmetro cadeia de caracteres segura, não é necessário converter o valor em uma cadeia de caracteres segura. Forneça o valor da senha como texto. | |
| PrivateIPAddressInReservedRange | O endereço IP especificado contém 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 da sub-rede. Altere o endereço IP para que ele fique 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 suas alterações às propriedades permitidas. | Atualizar recurso |
| PublicIPCountLimitReached | Você atingiu o limite de número de IPs públicos em execução. Desligue os recursos desnecessários ou entre em contato com o suporte do Azure para solicitar um aumento. Por exemplo, no Azure Databricks, confira Terminação de cluster inesperada e limite de endereço IP impede a criação do cluster. | Limites do endereço IP público |
| RegionDoesNotAllowProvisioning | Selecione uma região diferente ou envie uma solicitação de suporte de cota para obter 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. Localize a política que bloqueia a ação. Se possível, modifique 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 recurso 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 precisa já existir em sua assinatura. Verifique o contexto de sua assinatura. | CLI do Azure PowerShell |
| ResourceNotFound | Sua implantação referencia 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 seu cenário. | Resolver referências |
| ResourceQuotaExceeded | A implantação está tentando criar recursos que ultrapassam a cota da assinatura, do grupo de recursos ou da região. Se possível, revise sua infraestrutura para permanecer dentro das cotas. Caso contrário, considere solicitar uma alteração de suas cotas. | Resolver cotas |
| SkuNotAvailable | Selecione o SKU (por exemplo, o tamanho da VM) disponível para a localização que você selecionou. | Resolver SKU |
| StorageAccountAlreadyTaken StorageAccountAlreadyExists |
Forneça um nome exclusivo para a conta de armazenamento. | Solucione erros de nomes de conta de armazenamento |
| StorageAccountInAnotherResourceGroup | Forneça um nome exclusivo para a conta de armazenamento. | Solucione erros de nomes de conta de armazenamento |
| StorageAccountNotFound | Verifique a assinatura, o grupo de recursos e o nome da conta de armazenamento que você está tentando usar. | |
| SubnetsNotInSameVnet | Uma máquina virtual pode ter apenas uma rede virtual. Ao implantar várias NICs, certifique-se de que elas pertencem à mesma rede virtual. | VM do Windows com várias NICs VM do Linux com 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. | Gerenciar sub-redes e Perguntas frequentes sobre rede virtual Endereços IP privados |
| SubscriptionNotFound | Uma assinatura especificada para a implantação não pode ser acessada. A ID da assinatura pode estar incorreta, o usuário que está implantando o modelo pode não ter as permissões adequadas para a implantação na assinatura ou a ID da assinatura pode estar no formato incorreto. Ao usar implantações aninhadas do modelo do ARM para a implantação entre escopos, forneça o GUID da assinatura. | Implantação entre escopos do modelo do ARM Implantação entre escopos do arquivo Bicep |
| SubscriptionNotRegistered | Quando um recurso é implantado, o provedor de recursos deve ser registrado para sua assinatura. Ao usar um modelo do Azure Resource Manager para a implantação, o provedor de recursos é registrado automaticamente na assinatura. Às vezes, o registro automático não é concluído a tempo. Para evitar esse erro intermitente, registre o provedor de recursos antes da implantação. | Resolver registro |
| SubscriptionRequestsThrottled | O Resource Manager do Azure limita as solicitações no nível da assinatura ou do locatário. Provedores de recursos como Microsoft.Compute também limitam solicitações específicas para suas operações. Quando um limite é atingido, você recebe uma mensagem e um valor com o tempo que deve aguardar 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 valor Retry-After que especifica o número de segundos a aguardar antes de enviar outra solicitação. |
Restrição de solicitações do Resource Manager Solucionar problemas de erros de limitação de API – máquinas virtuais Limitação do Serviço de Kubernetes do Azure |
| TemplateResourceCircularDependency | Remova as dependências desnecessárias. | Resolver as dependências circulares |
| TooManyTargetResourceGroups | Reduza o número de grupos de recursos para uma única implantação. | Implantação entre escopos do modelo do ARM Implantação entre escopos do arquivo Bicep |
Próximas etapas
- Para obter informações sobre erros de validação ou implantação, confira Encontrar códigos de erro.
- Para obter mais detalhes e solucionar problemas de implantação, confira Habilitar os logs de depuração.
- Para isolar a causa de um erro de implantação, confira Criar um modelo de solução de problemas.