Datasets - Post Dataset User In Group

  • Referência
Service:
Power BI REST APIs
API Version:
v1.0

Concede as permissões do usuário especificado ao conjunto de dados especificado.

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 de Permissões de Usuário de Atualização .

Escopo necessário

Dataset.ReadWrite.All

Limitações

  • Não há suporte para adicionar permissões a entidades de serviço (entidades de serviço)
  • O chamador deve ter permissões ReadReshare no conjunto de dados.
  • Essa chamada de API não pode ser usada para conceder permissão de gravação do conjunto de dados no conjunto de dados

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/users

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
 path True

string

A ID do conjunto de dados
groupId
 path True

string

uuid

A ID do workspace

Corpo da solicitação

Nome Obrigatório Tipo Description
datasetUserAccessRight True

DatasetUserAccessRightEntry

Obrigatórios. O direito de acesso a conceder ao usuário para o conjunto de dados.
identifier True

string

Para o tipo Userde entidade de segurança, forneça o UPN. Caso contrário, forneça a ID do objeto da entidade de segurança.
principalType True

PrincipalType

O tipo principal

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

Example
Example for granting ReadExplore right to a security group

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Request Body
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:
200

Example for granting ReadExplore right to a security group

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Request Body
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:
200

Definições

Nome Description
DatasetUserAccessRightEntry

Obrigatórios. O direito de acesso a conceder ao usuário para o conjunto de dados.
PostDatasetUserAccess

Uma entrada certa de acesso de usuário do Power BI para um conjunto de dados
PrincipalType

O tipo principal

DatasetUserAccessRightEntry

Obrigatórios. O direito de acesso a conceder ao usuário para o conjunto de dados.

Nome Tipo Description
Read

string

Concede acesso de leitura ao conteúdo no conjunto de dados
ReadExplore

string

Concede acesso de leitura e exploração ao conteúdo no conjunto de dados
ReadReshare

string

Concede acesso de leitura e compartilhamento ao conteúdo no conjunto de dados
ReadReshareExplore

string

Concede acesso de Leitura, Recompartilhamento e Exploração ao conteúdo no conjunto de dados

PostDatasetUserAccess

Uma entrada certa de acesso de usuário do Power BI para um conjunto de dados

Nome Tipo Description
datasetUserAccessRight

DatasetUserAccessRightEntry

Obrigatórios. O direito de acesso a conceder ao usuário para o conjunto de dados.
identifier

string

Para o tipo Userde entidade de segurança, forneça o UPN. Caso contrário, forneça a ID do objeto da entidade de segurança.
principalType

PrincipalType

O tipo principal

PrincipalType

O tipo principal

Nome Tipo Description
App

string

Tipo de entidade de serviço
Group

string

Tipo de entidade de segurança do grupo
None

string

Nenhum tipo de entidade de segurança. Use todo o acesso ao nível da organização.
User

string

Tipo de entidade de usuário