Guia de resolução de problemas de conectores para relatórios de impacto (versão preliminar)

Importante

O Relatório de Impacto do Azure está atualmente em pré-visualização. Para obter os termos legais que se aplicam aos recursos do Azure que estão em versão beta, em visualização ou ainda não lançados em disponibilidade geral, consulte Termos de uso suplementares para Visualizações do Microsoft Azure.

Este artigo descreve soluções para erros comuns que você pode encontrar ao criar um conector do Azure Impact Reporting. Para problemas não abordados aqui, entre em contato com a equipa de conectores do Relatório de Impacto.

O script Bash falha imediatamente após o início

Verifique se o script tem permissões de execução. Use este comando para torná-lo executável:

chmod +x create-impact-reporting-connector.sh

No script Bash, o início de sessão do Azure falha (o comando az sign-in não funciona)

Verifique se a CLI do Azure está instalada e atualizada para a versão mais recente. Tente iniciar sessão manualmente usando az login para verificar se aparecem mais prompts ou erros.

Erro: "ID de assinatura ou caminho do arquivo com lista de IDs de assinatura necessários"

  • Bash: Certifique-se de fornecer o --subscription-id argumento ou --file-path quando executar o script. Não forneça ambos.
  • PowerShell: Certifique-se de fornecer o -SubscriptionId parâmetro ou o -FilePath parâmetro quando invocar o script. Não forneça ambos.

Erro: "Falha ao localizar o arquivo: [file_path]"

  • Bash: verifique se o caminho de ficheiro fornecido --file-path existe e está acessível. Certifique-se de usar o caminho correto.
  • PowerShell: verifique se o caminho do arquivo fornecido com -FilePath existe e está acessível. Certifique-se de usar o caminho correto e confirme se o arquivo não está bloqueado ou em uso por outro processo.

O script não é executado com erros de permissão

Certifique-se de que tem permissão de Colaborador para iniciar sessão no Azure, registar fornecedores de recursos e criar conectores nas subscrições do Azure. Você também precisa ter permissão de Administrador de Acesso de Usuário para criar e atribuir funções personalizadas.

A execução do script para inesperadamente sem ser concluída

Verifique se o módulo do Azure PowerShell está instalado e atualizado. Use Update-Module -Name Az para atualizar o módulo do Azure PowerShell. Certifique-se de que $ErrorActionPreference está definido como Continue para ignorar temporariamente erros não críticos.

O registro de namespace ou recurso leva muito tempo ou falha

Estas operações podem demorar vários minutos. Certifique-se de que sua conta do Azure tenha acesso de Colaborador nas assinaturas. Execute novamente o script depois que o acesso necessário for concedido. Se o problema persistir, entre em contato com a equipe de conectores do Relatório de Impacto.

Falha na criação ou atribuição de função personalizada

  1. Verifique se o principal de serviço do Azure AzureImpactReportingConnector existe, inserindo-o na caixa de pesquisa de recursos do Azure. Se não, aguarde alguns minutos para que ele seja criado. Se ele não for criado após uma hora, entre em contato com a equipe de conectores do Relatório de Impacto.

  2. Verifique se sua conta tem permissão de Administrador de Acesso de Usuário para criar funções e atribuí-las.

A criação do conector leva muito tempo

O registro de namespace que permite a criação de recursos de conector pode levar de 15 a 20 minutos. Se o script ainda estiver em execução após 30 minutos, cancele sua execução e execute-o novamente. Se esta segunda execução também ficar bloqueada, entre em contacto com a equipa de conectores do Relatório de Impacto.

Falha na criação do conector

  1. Verifique se o provedor de Microsoft.Impact recursos está registrado. Pode registar a subscrição de duas formas:

    • No portal do Azure, vá para Assinatura>Provedores de Recursos.

    • Procure Microsoft.Impact e registe-se:

      • Bash: Executar az provider show -n "Microsoft.Impact" -o json --query "registrationState".
      • PowerShell: Execute Get-AzResourceProvider -ProviderNamespace Microsoft.Impact.
  2. Certifique-se de que os sinalizadores de funcionalidades AllowImpactReporting e AzureImpactReportingConnector estão registados relativamente à funcionalidade Microsoft.Impact:

    • Bash
      • az feature list -o json --query "[?contains(name, 'Microsoft.Impact/AllowImpactReporting')].{Name:name,State:properties.state}"
      • az feature list -o json --query "[?contains(name, 'Microsoft.Impact/AzureImpactReportingConnector')].{Name:name,State:properties.state}"
    • PowerShell
      • Get-AzProviderFeature -ProviderNamespace "Microsoft.Impact" -FeatureName AzureImpactReportingConnector"
      • Get-AzProviderFeature -ProviderNamespace "Microsoft.Impact" -FeatureName AllowImpactReporting
  3. Certifique-se de que tem acesso de Colaborador às subscrições.