Usando as APIs REST do Power BI
As APIs REST do Power BI fornecem pontos de extremidade de serviço para inserção, administração, governança e recursos de usuário.
Com as APIs REST do Power BI, você pode fazer o seguinte:
Gerenciar conteúdo do Power BI
Executar operações de administrador
Inserir conteúdo do Power BI
Nota
Algumas das APIs do Power BI referem-se a workspaces como grupos. Qualquer referência a grupos significa que você está trabalhando com workspaces.
Ao acessar a API REST do Power BI, o conteúdo e os dados de solicitação e resposta podem ser processados por data centers em regiões diferentes da região inicial do seu locatário do Power BI.
Escopos
Para usar as APIs REST do Power BI, você precisa registrar um aplicativo do Azure AD (Azure Active Directory) no Azure. O aplicativo do Azure AD estabelece permissões para recursos REST do Power BI e permite o acesso às APIs REST do Power BI. Para saber como registrar um aplicativo, consulte Registrar um aplicativo do Azure AD para usar com o Power BI.
Depois de registrar um aplicativo do Azure AD, você pode autenticar nele usando o Azure AD (v1.0; ADAL) ou a plataforma de identidade da Microsoft (v2.0; Pontos de extremidade MSAL). Para saber mais sobre como esses métodos de autenticação funcionam, consulte Por que atualizar para a plataforma de identidade da Microsoft (v2.0)?
Para obter mais informações sobre permissões de acesso do Power BI, consulte permissões de e consentimento no ponto de extremidade da plataforma de identidade da Microsoft.
Usando uma entidade de serviço
Os escopos não serão necessários se você estiver usando uma entidade de serviço . Depois de habilitar uma entidade de serviço a ser usada com o Power BI, as permissões do AD do aplicativo não entrarão mais em vigor. Ao usar uma entidade de serviço, as permissões do aplicativo são gerenciadas por meio do portal de administração do Power BI. Para obter mais informações, consulte Habilitar as configurações de administrador de serviços do Power BI.
Adicionando escopos
Para adicionar permissões ao seu aplicativo do Azure AD, siga estas etapas:
Abra seu aplicativo no Azure.
À esquerda, em Gerenciar, selecione permissões de API.
Selecione Adicionar umde permissão.
Na janela permissões da API de Solicitação de, selecione do Serviço do Power BI.
Selecione permissões delegadas. Uma lista de APIs é exibida.
Expanda a API à qual você deseja adicionar permissões e selecione as permissões que deseja adicionar a ela.
Selecione Adicionar permissões.
Removendo escopos
Para remover permissões de seu aplicativo do Azure AD, siga estas etapas:
Abra seu aplicativo no Azure.
À esquerda, em Gerenciar, selecione permissões de API.
Selecione o menu Contexto (reticências de permissão).
Selecione Removerde permissão.
Limitação
O Power BI usa a limitação para manter o desempenho e a confiabilidade ideais. Para evitar o uso excessivo de recursos de usuários únicos, o Power BI limita o número de chamadas à API em uma janela de tempo por usuário.
Quando um usuário envia várias solicitações que excedem um limite predeterminado durante uma janela de tempo, o Power BI limita as solicitações adicionais desse usuário por um curto período.
Quando os aplicativos experimentam limitação, o Power BI retorna um código de status HTTP 429 (muitas solicitações) com um cabeçalho HTTP Retry-After na resposta, indicando quantos segundos o aplicativo de chamada precisa aguardar antes de fazer uma nova solicitação.
Download entre regiões geográficas
As operações que envolvem o download de arquivos em uma região diferente da região em que a chamada foi executada podem levar mais tempo do que o esperado.
Grupos de operações REST
Esta tabela lista os grupos de operações da API REST do Power BI.
Nota
Para gerenciar capacidades de do Power BI Embedded, use as APIs REST do Azure Resource Manager Do Power BI Embedded.
| Grupo de operações | Descrição |
|---|---|
| de Administração | Operações para trabalhar com tarefas administrativas. |
| aplicativos | Operações para trabalhar com aplicativos. |
| recursos disponíveis | Operações que retornam recursos disponíveis. |
| capacidades | Operações para trabalhar com capacidades. |
| dashboards | Operações para trabalhar com dashboards. |
| contas de armazenamento de fluxo de dados | Operações para trabalhar com contas de armazenamento de fluxo de dados. |
| de fluxos de dados | Operações para trabalhar com fluxos de dados. |
| conjuntos de dados | Operações para trabalhar com conjuntos de dados. |
| de Token de Inserção | Operações para trabalhar com tokens de inserção. |
| gateways | Operações para trabalhar com gateways. |
| grupos de | Operações para trabalhar com grupos. |
| Importações | Operações para trabalhar com importações. |
| Pipelines | Operações para trabalhar com pipelines de implantação. |
| efetuar push de conjuntos de dados | Operações para trabalhar com conjuntos de dados por push. |
| relatórios | Operações para trabalhar com relatórios. |
| aplicativos de modelo | Operações para trabalhar com aplicativos de modelo. |
| usuários | Operações para trabalhar com usuários. |