Permissões da API REST do modelo semântico
Este artigo descreve as permissões do Power BI em geral e as permissões do modelo semântico no contexto das APIs REST do Power BI.
Permissões do Power BI
O Power BI tem dois conjuntos de permissões:
Permissões de espaço de trabalho
As permissões de espaço de trabalho, também conhecidas como permissões de pasta ou funções, são o nível mais alto de permissões no Power BI. Essas permissões substituem as permissões que são dadas a um item específico na pasta do espaço de trabalho.
A tabela abaixo lista os quatro tipos de funções de pasta. Ele mostra o nível de cada função e a cadeia de caracteres de código retornada pelas APIs REST do Power BI. Admin é o nível de permissão de espaço de trabalho mais alto e visualizador é o mais baixo. Cada nível de permissão inclui os recursos das permissões abaixo dele. Você pode revisar os recursos de cada permissão em funções de Espaço de trabalho.
| Função da pasta | Nível | Permissões derivadas para modelos semânticos criados no espaço de trabalho |
|---|---|---|
| Admin | 4 | ReadWriteReshareExplore |
| Membro | 3 | ReadWriteReshareExplore |
| Contribuidor | 2 | ReadWriteExplore |
| Visualizador | 5 | Read |
Nota
A permissão de gravação é aplicada a modelos semânticos do Power BI criados por usuários administradores, membros e colaboradores em um espaço de trabalho de sua propriedade. A permissão de gravação pode ser concedida ou excluída usando apenas permissões de espaço de trabalho. Ele não pode ser concedido ou excluído diretamente de um item do Power BI.
Obter e adicionar permissões de espaço de trabalho com APIs
Para obter e adicionar permissões de espaço de trabalho programaticamente, use estas APIs:
Grupos - Adicionar usuário de grupo - UMA API POST para adicionar permissões de espaço de trabalho
Grupos - Atualizar usuário do grupo - UMA API PUT para alterar as permissões do espaço de trabalho
Grupos - Obter usuários de grupo - A GET API para obter permissões de espaço de trabalho
Permissões de item
Os itens do Power BI, como relatórios, modelos semânticos e painéis têm suas próprias permissões. As permissões de item não podem substituir as permissões de espaço de trabalho e só podem ser concedidas por alguém que tenha pelo menos o mesmo nível de permissão.
Permissões de modelo semântico e APIs REST
As permissões do modelo semântico fazem parte das permissões do item. A tabela abaixo lista as permissões do modelo semântico do Power BI e sua representação nas APIs REST do Power BI.
Gorjeta
Embora as permissões de API sejam idênticas às permissões de serviço do Power BI, build as permissões são chamadas de permissões de exploração nas APIs.
| Permissão | Lida | Explorar | Partilhar novamente |
|---|---|---|---|
| Description | Permite ao usuário ler o conteúdo do modelo semântico | Equivalente a permissões de compilação | Permite que o usuário compartilhe o conteúdo do modelo semântico com outros usuários que receberão permissões de leitura, compartilhamento ou exploração para ele |
| ReadReshareExplore | 
|
|
|
| ReadReshare |
|
|
|
| LerExplorar |
|
|
|
| Ler |
|
|
|
Nota
Para permitir que um usuário execute operações de gravação em um modelo semântico, primeiro altere as permissões do espaço de trabalho.
Permissões de compilação e APIs REST
Nas APIs REST do Power BI, a permissão é retornada build como explorar. Por exemplo, uma cadeia de caracteres com as permissões de leitura, recompartilhamento e compilação terá esta aparência: ReadReshareExplore.
Quando você concede permissão a um usuário build , ele pode criar novo conteúdo em seu modelo semântico. Exemplos de conteúdo que eles podem criar são relatórios, painéis, blocos fixados de P&R, relatórios paginados e Insights Discovery.
Os usuários também precisam de build permissões para trabalhar com dados fora do Power BI:
Para exportar os dados subjacentes.
Para criar novo conteúdo no modelo semântico, como com Analisar no Excel.
Para acessar os dados através do ponto de extremidade XMLA.
Segurança ao nível da linha
Para um modelo semântico que usa segurança em nível de linha (RLS), quaisquer permissões superiores permitirão que build o usuário visualize todos os dados no modelo semântico. Builde permissões inferiores a build, só darão ao usuário do modelo semântico acesso aos dados que ele tem permissão para ver conforme configurado em suas configurações de RLS.
Obter e atualizar permissões de modelo semântico com APIs
As APIs POST permitem adicionar novas permissões a um modelo semântico. Você pode usar essas APIs para adicionar permissões para usuários, mas não para remover permissões. Por exemplo, você pode adicionar a permissão a um usuário que tenha a
ReshareReadpermissão. No entanto, você não pode remover a permissão de um usuário que tenha ambas eReshareReadpermissões, tentando adicionar aReshareReadpermissão.As APIs PUT atualizam as permissões do usuário para um determinado conjunto de dados. A API PUT não pode ser usada para alterar permissões de gravação ou permissões herdadas em nível de pasta. Essa API também oferece suporte à remoção de todas as permissões de um conjunto de dados para um determinado destino.
As APIs GET retornam uma lista de entidades que têm acesso ao conjunto de dados especificado.
Considerações e limitações
Cada uma das APIs acima vem com certas limitações em relação a quem pode usá-las e como. Para ver as limitações de cada API, selecione o link para essa API.
Conteúdos relacionados
- APIs REST do Power BI.
- Enviar conjuntos de dados por push.