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

• Permissões de item

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 ReshareRead permissão. No entanto, você não pode remover a permissão de um usuário que tenha ambas e ReshareRead permissões, tentando adicionar a ReshareRead permissão.

  • Conjuntos de dados - Post Dataset User
  • Conjuntos de dados - Publicar usuário do conjunto de dados no grupo

• 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.

  • Conjuntos de dados - Colocar usuário do conjunto de dados
  • Conjuntos de dados - Colocar o usuário do conjunto de dados no grupo

• As APIs GET retornam uma lista de entidades que têm acesso ao conjunto de dados especificado.

  • Conjuntos de dados - Obter usuários do conjunto de dados
  • Conjuntos de dados - Obter usuários do conjunto de dados no grupo

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.