Solucionar problemas com APIs REST do Power BI

Solucionar erros 401 em chamadas à API REST do Power BI

Talvez seja necessário uma captura do Fiddler para investigar mais. O aplicativo registrado no Microsoft Entra ID pode estar perdendo o escopo de permissão necessário. Verifique se o escopo necessário está presente no registro do aplicativo para Microsoft Entra ID no portal do Azure.

A entidade de serviço retorna 401 ao chamar APIs de administração

Quando uma entidade de serviço chama as APIs REST de administrador do Power BI, a chamada pode retornar um HTTP 401 Não autorizado, embora a entidade de serviço se autentique com êxito e obtenha um token. Esse problema afeta chamadas diretas à API REST e cmdlets do PowerShell, incluindo:

• Obter eventos de atividade (GET /admin/activityevents)
• Obter grupos como administrador (GET /admin/groups)
• Outros pontos de extremidade em /admin/
• Cmdlets do PowerShell, como Get-PowerBIWorkspace -Scope Organization, Get-PowerBIActivityEvente Invoke-PowerBIRestMethod em rotas de administrador

Um erro típico do PowerShell tem esta aparência:

Get-PowerBIWorkspace : Operation returned an invalid status code Unauthorized

Uma resposta 401 nesse cenário geralmente indica uma lacuna de configuração de registro de locatário ou aplicativo em vez de uma falha de autenticação. Faça as verificações a seguir, na ordem:

1. Confirme se as configurações de locatário relevantes estão habilitadas. No portal de administração do Microsoft Fabric, verifique se Permitir que entidades de serviço usem APIs de administrador do Power BI somente leitura está habilitada para as APIs de administrador ou se Permitir que entidades de serviço usem APIs do Power BI está habilitada para as APIs de usuário. Essas duas configurações são configurações de locatário separadas. Uma chamada à API de administrador falhará com 401 se você habilitar apenas a configuração da API de usuário. Para obter mais informações, consulte Habilitar a autenticação da entidade de serviço para APIs de administrador.
2. Confirme se a entidade de serviço está no grupo de segurança com escopo. Cada configuração de locatário se aplica a um ou mais grupos de segurança Microsoft Entra. Verifique se o service principal é membro do grupo de segurança ao qual a configuração faz referência. Para obter mais informações, consulte Registrar um aplicativo Microsoft Entra.
3. Confirme se o token OAuth usa o recurso correto. Quando você solicita o token de acesso, o valor do recurso (audiência) deve ser https://analysis.windows.net/powerbi/api para a nuvem global. O Power BI rejeita tokens emitidos para um recurso diferente, como o Microsoft Graph, com um erro 401.
4. Verifique as permissões de registro do aplicativo. Confirme se o registro de aplicativo possui as permissões de aplicativo exigidas pela API de administrador específica e se um administrador do Microsoft Entra concedeu o consentimento de administrador. Não misture permissões delegadas e de aplicativo no mesmo registro de aplicativo – use uma ou outra com base no fluxo de autenticação.
5. Validar parâmetros de Eventos de Atividade. Quando você chama a API REST get activity events , os startDateTime parâmetros e endDateTime devem estar no formato ISO 8601 UTC , por exemplo, 2026-06-30T00:00:00Z. Um carimbo de data/hora mal formatado pode causar um erro 401.

Solucionar erros 403 em chamadas à API REST do Power BI

Um erro 403 pode ocorrer por qualquer um dos motivos a seguir. Talvez seja necessário uma captura do Fiddler para investigar mais.

• Você excedeu a quantidade de tokens de inserção que pode gerar em uma capacidade compartilhada. Para gerar tokens de incorporação, compre capacidades do Azure e atribua o espaço de trabalho a essa capacidade. Consulte Criar capacidade do Power BI Embedded no portal do Azure.
• O token de autorização Microsoft Entra expirou.
• O usuário autenticado não é membro do grupo (workspace).
• O usuário autenticado não é um administrador do grupo (workspace).
• O usuário autenticado não tem permissões. Atualize as permissões usando a API refreshUserPermissions.
• O cabeçalho de autorização pode não estar listado corretamente. Verifique se não há erros de digitação.

O back-end do aplicativo pode precisar atualizar o token de autorização antes de chamar GenerateToken. Para saber mais, confira Atualizar o token de acesso.

GET https://wabi-us-north-central-redirect.analysis.windows.net/metadata/cluster HTTP/1.1
Host: wabi-us-north-central-redirect.analysis.windows.net
...
Authorization: Bearer eyJ0eXAiOi...
...

HTTP/1.1 403 Forbidden
...

{"error":{"code":"TokenExpired","message":"Access token has expired, resubmit with a new access token"}}

Corrigir exceções de tempo limite ao usar APIs de importação e exportação

Quando você envia uma solicitação de API REST Power BI, ela pode chegar a um cluster que não contém os dados do locatário. Nesse caso, o redirecionamento da solicitação pode falhar devido a um tempo limite.

Para corrigir a exceção de tempo limite, reenviar a solicitação com o preferClientRouting parâmetro de consulta de URL definido como true. Se a solicitação chegar ao cluster errado, o serviço do Power BI retornará uma resposta HTTP de Redirecionamento Temporário 307. Nesses casos, você precisa redirecionar sua solicitação para o novo endereço especificado no cabeçalho de localização HTTPS de resposta.

Os parâmetros de atualização ou a API de fontes de dados de atualização falham após alguns minutos

Às vezes, o seguinte erro genérico é retornado no cabeçalho de resposta:

HTTP/1.1 500 Internal Server Error

An error has occurred

Quando você usa as APIs Conjuntos de dados - Atualizar parâmetros no grupo ou Conjuntos de dados - Atualizar fontes de dados no grupo, esse erro pode indicar que você está atualizando um conjunto de dados grande que não está usando o formato conjunto de dados grande. Use o formato de conjunto de dados grande para evitar o erro.

Conteúdo relacionado

Perguntas Frequentes do Power BI Embedded

Mais perguntas? Pergunte à Comunidade do Power BI