Datasets - Put Dataset User

Atualiza as permissões de modelo semântico existentes do usuário especificado para as permissões especificadas. O modelo semântico pode residir em Meu workspace ou outro workspace, desde que o chamador tenha as permissões necessárias.

Quando as permissões de usuário para um conjunto de dados foram atualizadas recentemente, as novas permissões podem não estar disponíveis imediatamente por meio de chamadas à API. Para atualizar as permissões do usuário, use a chamada à API atualizar permissões de usuário . Essa chamada à API pode ser usada para remover todas as permissões do conjunto de dados do usuário especificado usando datasetUserAccessRight: None

Escopo necessário

Dataset.ReadWrite.All

Permissions

As permissões para essa chamada de API são listadas em permissões de conjuntos de dados.

Limitações

• Não há suporte para a atualização de permissões para entidades de serviço (app principalType)
• O chamador deve ter permissões ReadWriteReshare no conjunto de dados. Ou seja, administradores de pastas, membros e colaboradores com permissões de recompartilhamento ou proprietários de conjuntos de dados.
• Essa API não pode ser usada para adicionar ou remover a permissão de gravação .
• Essa API não pode ser usada para remover permissões herdadas no nível da pasta. Para administradores de pastas e membros, a permissão ReadWriteReshareExplore nos conjuntos de dados da pasta é herdada. Para colaboradores de pasta, a permissão ReadWriteExplore nos conjuntos de dados da pasta é herdada. Para visualizadores de pasta, o permissão Leitura nos conjuntos de dados da pasta é herdado.
  
  

PUT https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/users

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Example

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Example for updating security group dataset permissions to ReadExplore

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Definições

DatasetUserAccess

Uma entrada correta de acesso de entidade do Power BI para um conjunto de dados

DatasetUserAccessRight

O direito de acesso que o usuário tem para o conjunto de dados (nível de permissão)

PrincipalType

O tipo principal