Datasets - Post Dataset User

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/datasets/{datasetId}/users

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string	A ID do conjunto de dados

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/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/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