FAQ sobre erros de CLI para desenvolvedores Azure

Este artigo apresenta soluções para erros comuns que pode encontrar ao usar a CLI do Azure Developer (azd).

Autorização falhada para escrita de atribuição de funções

Mensagem de erro:

Cause: Não tem permissões suficientes para atribuir funções na subscrição ou grupo de recursos de Azure alvo. Isto é comum quando a tua conta de utilizador tem acesso mas não tem acesso . Permite criar recursos mas não conceder permissões (atribuir papéis) a esses recursos.

Resolução: Garanta que a sua conta tem o papel de Proprietário ou Administrador de Acesso ao Utilizador na subscrição ou grupo de recursos onde está a efetuar a implementação. Se não conseguires obter estas funções, pede a um administrador que realize a implantação inicial ou as atribuições de funções por ti. Para mais informações, consulte funções integradas do Azure.

A atribuição de função já existe

Mensagem de erro:

Causa: Este erro ocorre quando a implementação tenta criar uma atribuição de função que já existe no recurso. Enquanto as implementações do Azure Resource Manager (ARM) são idempotentes, certas configurações ou condições de corrida nos modelos podem desencadear este erro quando se faz uma nova implantação.

Resolução: Este erro é frequentemente intermitente ou benigno.

1. Repita a implementação: Execute ou novamente.
2. Verifique os modelos Bicep: Se mantiver o modelo, assegure que as atribuições de papéis utilizam propriedades válidas name (frequentemente GUIDs estritamente determinísticos) para garantir a idempotência. Use a função guid() Bicep para gerar nomes determinísticos.

ID de arrendatário, ID principal ou âmbito não pode ser atualizado

Mensagem de erro:

Causa: Estás a tentar redistribuir uma atribuição de função com propriedades que diferem da atribuição existente. As atribuições de funções são imutáveis; não podes alterar o principal ID (o utilizador/app que recebe a função) nem o âmbito de um ID de atribuição existente.

Resolution:

1. Verificar parâmetros: Assegure-se de que não está a transmitir acidentalmente um ID de principal diferente (por exemplo, alternar entre um utilizador e um principal de serviço) para o mesmo recurso de atribuição de funções.
2. Clean up: Se precisares de alterar a atribuição, elimina manualmente a atribuição de funções em conflito no Azure portal ou via CLI usando az role assignment delete, e, em seguida, reimplantes.

Capacidade regional ou SKU indisponível

Mensagem de erro: (ou 'básico')

Causa: A região de Azure selecionada está temporariamente fora de capacidade para o SKU de serviço solicitado. Isto é atualmente comum em serviços de IA (como Azure OpenAI) em regiões populares como eastus2.

Resolution:

1. Mudança de localização: Execute para mudar para uma região com melhor disponibilidade (por exemplo, , , ).
2. Verificar disponibilidade: Use a página Azure Produtos por Região ou execute az account list-locations para verificar as regiões onde o serviço e o SKU estão disponíveis.

Quota de TPM excedida para modelos de IA

Mensagem de erro:

Causa: A sua subscrição atingiu o limite de quota para Tokens Por Minuto (TPM) para o modelo OpenAI Azure especificado na região-alvo.

Resolution:

1. Solicitar Quota: Solicitar aumento de quota através do Azure AI Studio ou portal Azure. Para mais informações, consulte Gerir Azure OpenAI Service quota.
2. Mudança de Modelo/Região: Muda para uma região onde tenhas quotas não usadas ou usa uma versão diferente que se encaixe nos teus limites.

If-Match precondição falhou

Mensagem de erro:

Causa: Esta questão indica tipicamente um conflito de concorrência. Dois processos podem estar a tentar atualizar o mesmo recurso simultaneamente, ou o seu estado local está fora de sincronia com o recurso na cloud (ETag obsoleto).

Resolução: Tente novamente a operação. Se o erro persistir:

1. Garanta que nenhuma outra implementação (pipelines CI/CD, outros colegas) esteja a direcionar-se para o mesmo ambiente simultaneamente.
2. Se estiver a usar Bicep, verifique se o seu modelo define corretamente as dependências (dependsOn) para evitar modificações paralelas no mesmo recurso.

Conta de Serviços Cognitivos em estado Aceito

Mensagem de erro:

Cause: Este erro é uma questão de timing em que um recurso dependente tenta interagir com a conta de Serviços Cognitivos (IA Azure) antes de esta estar totalmente provisionada e ativa. Também podes adicionar um gancho de comando (por exemplo, ) para pausar ou verificar a prontidão dos recursos antes de prosseguir.

Provisão de revisão da aplicação de container expirada

Mensagem de erro:

Cause: A aplicação do Azure Container falhou ao iniciar dentro do período de tempo predefinido. Motivos comuns:

• A imagem do contentor é demasiado grande e demora demasiado tempo a puxar.
• A aplicação crasha ao arrancar.
• A aplicação demora demasiado tempo a ouvir na porta configurada.

Resolution:

1. Verifique Logs: Veja os registos do contentor no portal Azure (Log Stream) ou usando azd monitor para ver se a aplicação está a crashar.
2. Rever Configuração: Certifica-te de que a porta na tua configuração corresponde à porta onde a tua app escuta. Para mais passos de resolução de problemas, veja Resolução de problemas Azure Container Apps
3. Verifique Logs: Veja os registos do contentor no portal Azure (Log Stream) ou usando azd monitor para ver se a aplicação está a crashar.
4. Rever Configuração: Certifica-te de que a porta na tua configuração corresponde à porta onde a tua app escuta.
5. Otimizar a Imagem: Reduza o tamanho da imagem do seu contentor para acelerar a extração.