Resolver erros de implementação do Azure comuns
Este artigo descreve como resolver erros comuns de implementaçã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 Feedback , selecione Esta página. Forneça os 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 de erro
| Código de erro | Mitigação | Mais informações |
|---|---|---|
| AccountNameInvalid | Siga as diretrizes de nomenclatura das contas de armazenamento. | Resolver erros de nomes de contas de armazenamento |
| AccountPropertyCannotBeSet | Verifique as propriedades da conta de armazenamento disponíveis. | storageAccounts |
| AllocationFailed | O cluster ou a região não tem recursos disponíveis ou não suporta o tamanho de VM pedido. Repita o pedido mais tarde ou peça 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 |
| AnotherOperationInProgress | Aguarde pela conclusão da operação simultânea. | |
| Falha na Autorização | A sua conta ou principal de serviço não tem acesso suficiente para concluir a implementação. Verifique a função à qual pertence a sua conta e o respetivo acesso para o âmbito de implementação. Poderá receber este erro quando um fornecedor de recursos necessário não estiver registado. |
Controlo de acesso baseado em funções do Azure (RBAC do Azure) Resolver o registo |
| BadRequest | Enviou valores de implementação que não correspondem ao esperado por Resource Manager. Consulte a mensagem de estado interno para obter ajuda com a resolução de problemas. Valide a sintaxe do modelo para resolver erros de implementação ao utilizar um modelo que foi exportado a partir de um recurso do Azure existente. |
Referência de modelo Localização do recurso no modelo do ARM Localização do recurso no ficheiro Bicep Resolver modelo inválido |
| Conflito | Está a pedir uma operação que não é permitida no estado atual do recurso. Por exemplo, o redimensionamento do disco só é permitido ao criar uma VM ou quando a VM é desalocada. | |
| DeploymentActiveAndUneditable | Aguarde pela conclusão da implementação simultânea neste grupo de recursos. | |
| DeploymentFailedCleanUp | Quando implementa no modo completo, todos os recursos que não estiverem no modelo são eliminados. Recebe este erro quando não tem as permissões adequadas para eliminar todos os recursos que não estão no modelo. Para evitar o erro, altere o modo de implementação para incremental. | Modos de implementação do Azure Resource Manager |
| DeploymentNameInvalidCharacters | O nome da implementação só pode conter letras, dígitos, hífen (-), ponto (.) ou caráter de sublinhado (_). |
|
| DeploymentNameLengthLimitExceeded | Os nomes de implementação estão limitados a 64 carateres. | |
| Falha na Implementação | O erro DeploymentFailed é um erro geral que não fornece os detalhes necessários para resolver o erro. Veja os detalhes do erro para obter um código de erro que forneça mais informações. | Localizar código de erro |
| DeploymentQuotaExceeded | Se atingir o limite de 800 implementações por grupo de recursos, elimine as implementações do histórico que já não são necessárias. | Resolver o erro quando a contagem de implementações excede as 800 |
| DeploymentJobSizeExceeded | Simplifique o modelo para reduzir o tamanho. | Resolver erros de tamanho do modelo |
| DnsRecordInUse | O nome do registo DNS tem de ser exclusivo. Introduza um nome diferente. | |
| ImageNotFound | Verifique as definições da imagem da VM. | |
| InaccessibleImage | A implementação do Azure Container Instance falha. Poderá ter de incluir a etiqueta da imagem com a sintaxe registry/image:tag para implementar o contentor. Para um registo privado, verifique se as credenciais estão corretas. |
Localizar código de erro |
| InternalServerError | Causado por um problema temporário. Repita a implementação. | |
| InUseSubnetCannotBeDeleted | Este erro pode ocorrer quando tenta atualizar um recurso, se o processo de pedido eliminar e criar o recurso. Certifique-se de que especifica todos os valores inalterados. | Atualizar recurso |
| InvalidAuthenticationTokenTenant | Obtenha o token de acesso para o inquilino adequado. Só pode obter o token do inquilino ao qual pertence a sua conta. | |
| InvalidContentLink | É provável que tenha tentado ligar a um modelo aninhado que não está disponível. Verifique novamente o URI que forneceu para o modelo aninhado. Se o modelo existir numa conta de armazenamento, certifique-se de que o URI está acessível. Poderá ter de transmitir um token de SAS. Atualmente, não pode ligar a um modelo que esteja numa conta de armazenamento protegida por uma firewall do Armazenamento do Azure. Considere mover o modelo para outro repositório, como o GitHub. | Modelos arm ligados e aninhados Módulos bicep |
| InvalidDeploymentLocation | Ao implementar ao nível da subscrição, forneceu uma localização diferente para um nome de implementação utilizado anteriormente. | Implementação da subscrição do modelo arm Implementação da subscrição bicep |
| 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 palavra-passe pode ser insuficiente ou um nome de blob pode estar incorreto. A mensagem de erro deve indicar que valor tem de ser corrigido. | Parâmetros do modelo ARM Parâmetros do Bicep |
| InvalidRequestContent | Os valores de implementação incluem valores que não são reconhecidos ou os valores necessários estão em falta. Confirme os valores do seu tipo de recurso. | Referência de modelo |
| InvalidRequestFormat | Ative o registo de depuração ao executar a implementação e verifique o conteúdo do pedido. | Registo de depuração |
| InvalidResourceLocation | Indique um nome único para a conta de armazenamento. | Resolver erros de nomes de contas de armazenamento |
| InvalidResourceNamespace | Verifique o espaço de nomes de recursos que especificou na propriedade type . | Referência de modelo |
| InvalidResourceReference | O recurso ainda não existe ou é referenciado incorretamente. Verifique se precisa de adicionar uma dependência. Verifique se a utilização da função de referência inclui os parâmetros necessários para o seu cenário. | Resolver dependências |
| InvalidResourceType | Verifique o tipo de recurso que especificou na propriedade type . | Referência de modelo |
| InvalidSubscriptionRegistrationState | Registe a sua subscrição no fornecedor de recursos. | Resolver o registo |
| InvalidTemplateDeployment InvalidTemplate |
Verifique se existem erros na sintaxe do modelo. | Resolver modelo inválido |
| InvalidTemplateCircularDependency | Remover dependências desnecessárias. | Resolver dependências circulares |
| JobSizeExceeded | Simplifique o modelo para reduzir o tamanho. | Resolver erros de tamanho do modelo |
| LinkedAuthorizationFailed | Verifique se a sua conta pertence ao mesmo inquilino do grupo de recursos no qual está a implementar. | |
| LinkedInvalidPropertyId | O ID de recurso de um recurso não está resolvido. Verifique se forneceu todos os valores necessários para o ID do recurso. Por exemplo, o ID da subscrição, o nome do grupo de recursos, o tipo de recurso, o nome do recurso principal (se necessário) e o nome do recurso. | Resolver erros de nome e tipo de recurso |
| LocationRequired | Forneça uma localização para o recurso. | Localização do recurso no modelo do ARM Localização do recurso no ficheiro Bicep |
| Erro de correspondênciaResourceSegments | Certifique-se de que um recurso aninhado tem o número correto de segmentos no nome e no tipo. | Resolver segmentos de recursos |
| MissingRegistrationForLocation | Verifique o estado de registo do fornecedor de recursos e as localizações suportadas. | Resolver o registo |
| MissingSubscriptionRegistration | Registe a sua subscrição no fornecedor de recursos. | Resolver o registo |
| NoRegisteredProviderFound | Verifique o estado de registo do fornecedor de recursos. | Resolver o registo |
| NotFound | Pode estar a tentar implementar um recurso dependente em paralelo com um recurso principal. Verifique se precisa de adicionar uma dependência. | Resolver dependências |
| OperationNotAllowed | Pode haver vários motivos para esta mensagem de erro. 1. A implementação está a tentar uma operação que não é permitida no SKU spcecified. 2. A implementação está a tentar uma operação que excede a quota da subscrição, grupo de recursos ou região. Se possível, reveja a implementação para permanecer dentro das quotas. Caso contrário, considere pedir uma alteração às quotas. |
Resolver quotas |
| OperationNotAllowedOnVMImageAsVMsBeingProvisioned | Poderá estar a tentar eliminar uma imagem que está atualmente a ser utilizada para aprovisionar VMs. Não pode eliminar uma imagem que esteja a ser utilizada por qualquer máquina virtual durante o processo de implementação. Repita a operação de eliminação de imagens após a conclusão da implementação da VM. | |
| ParentResourceNotFound | Certifique-se de que existe um recurso principal antes de criar os recursos subordinados. | Resolver o recurso principal |
| PasswordTooLong | Pode ter selecionado uma palavra-passe com demasiados carateres ou convertido o valor da palavra-passe numa cadeia segura antes de a transmitir como um parâmetro. Se o modelo incluir um parâmetro de cadeia segura , não precisa de converter o valor numa cadeia segura. Indique o valor da palavra-passe 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 se enquadrar no intervalo da sub-rede. | Endereços IP privados |
| PropertyChangeNotAllowed | Algumas propriedades não podem ser alteradas num recurso implementado. Ao atualizar um recurso, limite as alterações às propriedades permitidas. | Atualizar recurso |
| PublicIPCountLimitReached | Atingiu o limite do número de IPs públicos em execução. Encerre recursos desnecessários ou contacte suporte do Azure para pedir um aumento. Por exemplo, no Azure Databricks, veja Terminação inesperada do cluster e limite de endereços IP impede a criação do cluster. | Limites de endereços IP públicos |
| RegionDoesNotAllowProvisioning | Selecione uma região diferente ou submeta um pedido de suporte de quota para o acesso à Região. | |
| RequestDisallowedByPolicy | A sua subscrição inclui uma política de recursos que impede uma ação que está a tentar efetuar durante a implementação. Localize a política que bloqueia a ação. Se possível, altere a implementação para cumprir as limitações da política. | Resolver políticas |
| ReservedResourceName | Indique um nome de recurso que não inclua um nome reservado. | Nomes de recursos reservados |
| ResourceGroupBeingDeleted | Aguarde que a eliminação seja concluída. | |
| ResourceGroupNotFound | Verifique o nome do grupo de recursos de destino da implementação. O grupo de recursos de destino já tem de existir na sua subscrição. Verifique o contexto da sua subscrição. | PowerShell da CLI do Azure |
| ResourceNotFound | A sua implementação faz referência a um recurso que não pode ser resolvido. Verifique se a utilização da função de referência inclui os parâmetros necessários para o seu cenário. | Resolver referências |
| ResourceQuotaExceeded | A implementação está a tentar criar recursos que excedam a quota da subscrição, grupo de recursos ou região. Se possível, reveja a sua infraestrutura para se manter dentro das quotas. Caso contrário, considere pedir uma alteração às quotas. | Resolver quotas |
| SkuNotAvailable | Selecione SKU (como o tamanho da VM) que está disponível para a localização que selecionou. | Resolver SKU |
| StorageAccountAlreadyTaken StorageAccountAlreadyExists |
Indique um nome único para a conta de armazenamento. | Resolver erros de nomes de contas de armazenamento |
| StorageAccountInAnotherResourceGroup | Indique um nome único para a conta de armazenamento. | Resolver erros de 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. | |
| SubnetsNotInSameVnet | Uma máquina virtual só pode ter uma rede virtual. Ao implementar vários NICs, certifique-se de que pertencem à mesma rede virtual. | Várias NICs de VM do Windows VM do Linux com vários NICs |
| SubnetIsFull | Não existem endereços disponíveis suficientes na sub-rede para implementar recursos. Pode libertar endereços da sub-rede, utilizar uma sub-rede diferente ou criar uma nova sub-rede. | Gerir sub-redes e FAQ da rede virtual Endereços IP privados |
| SubscriptionNotFound | Não é possível aceder a uma subscrição especificada para implementação. Pode ser que o ID da subscrição esteja errado, o utilizador que está a implementar o modelo não tem permissões adequadas para implementar na subscrição ou o ID da subscrição está no formato errado. Ao utilizar implementações aninhadas de modelo do ARM para implementar entre âmbitos, forneça o GUID da subscrição. | Implementação de modelos do ARM entre âmbitos Implementação de ficheiros bicep entre âmbitos |
| SubscriptionNotRegistered | Quando um recurso é implementado, o fornecedor de recursos tem de estar registado na sua subscrição. Quando utiliza um modelo de Resource Manager do Azure para implementação, o fornecedor de recursos é registado automaticamente na subscrição. Por vezes, o registo automático não é concluído a tempo. Para evitar este erro intermitente, registe o fornecedor de recursos antes da implementação. | Resolver o registo |
| SubscriptionRequestsThrottled | O Azure Resource Manager limita os pedidos ao nível da subscrição ou ao nível do inquilino. Os fornecedores de recursos, como Microsoft.Compute também, limitam os pedidos específicos às suas operações. Quando é atingido um limite, recebe uma mensagem e um valor com a quantidade de tempo que deve aguardar antes de enviar um novo pedido. 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 devolve 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 outro pedido. |
Limitação dos pedidos do Resource Manager Resolver erros de limitação da API – máquinas virtuais limitação de Azure Kubernetes Service |
| TemplateResourceCircularDependency | Remover dependências desnecessárias. | Resolver dependências circulares |
| TooManyTargetResourceGroups | Reduzir o número de grupos de recursos para uma única implementação. | Implementação de modelos do ARM entre âmbitos Implementação de ficheiros bicep entre âmbitos |
Passos seguintes
- Para obter informações sobre erros de validação ou implementação, veja Localizar códigos de erro.
- Para obter mais detalhes para resolver problemas de implementação, veja Ativar o registo de depuração.
- Para isolar a causa de um erro de implementação, veja Criar um modelo de resolução de problemas.