Solucionar erros comuns de implantação do Azure

  • Artigo

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