Compartilhar via

Solucionar problemas com APIs REST

  • Artigo

A chamada à API retorna 401

Uma captura do fiddler pode ser necessária para uma investigação mais aprofundada. O escopo necessário da permissão pode estar ausente no aplicativo registrado no Microsoft Entra ID. Verifique se o escopo necessário está presente no registro do aplicativo para o Microsoft Entra ID no portal do Azure.

A chamada à API retorna 403

Um erro 403 pode ocorrer devido a qualquer um dos motivos a seguir. Uma captura do fiddler pode ser necessária para uma investigação mais aprofundada.

  • O usuário excedeu a quantidade de tokens de inserção que pode ser gerada em uma capacidade compartilhada. Compre capacidades do Azure para gerar tokens de inserção e atribuir o workspace a essa capacidade. Consulte Criar uma capacidade do Power BI Embedded no Portal do Azure.
  • O token de autorização do Microsoft Entra expirou.
  • O usuário autenticado não é membro do grupo (workspace).
  • O usuário autenticado não é administrador do grupo (workspace).
  • O usuário autenticado não tem permissões. As permissões podem ser atualizadas usando a API refreshUserPermissions.
  • O cabeçalho de autorização talvez não esteja exibido corretamente. Verifique se não há erros de digitação.

O back-end do aplicativo pode precisar atualizar o token de autenticaçã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 à API REST do Power BI, ela pode chegar a um cluster que não contém os dados de seu locatário. Nesse caso, o redirecionamento da solicitação poderá falhar devido a um tempo limite.

Para corrigir a exceção do tempo limite, reenvie a solicitação com o parâmetro de consulta de URL preferClientRouting 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 da 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

Ao usar 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 de conjunto de dados grande. Use o formato de conjunto de dados grande para evitar o erro.

Conteúdo relacionado

Perguntas frequentes sobre o Power BI Embedded

Mais perguntas? Perguntar à Comunidade do Power BI