Datasets - Post Dataset User

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Concede as permissões do usuário especificado ao modelo semântico especificado. 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 .

Escopo necessário

Dataset.ReadWrite.All

Limitações

Não há suporte para adicionar permissões a entidades de serviço (app principalType)
O chamador deve ter permissões ReadReshare no conjunto de dados.
Essa chamada à 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ório O direito de acesso a ser concedido ao usuário para o conjunto de dados.
identifier	True	string	Para o tipo `User`principal, 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		OKEY

Exemplos

Example

Example for granting ReadExplore right to a security group

Example

Solicitação de exemplo

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

Corpo da solicitação

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

Resposta de exemplo

Código de status:: 200

Example for granting ReadExplore right to a security group

Solicitação de exemplo

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

Corpo da solicitação

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

Resposta de exemplo

Código de status:: 200

Definições

Nome	Description
DatasetUserAccessRightEntry	Obrigatório O direito de acesso a ser concedido 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

Enumeração

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

Valor	Description
Read	Concede acesso de leitura ao conteúdo no conjunto de dados
ReadReshare	Concede acesso de leitura e compartilhamento ao conteúdo no conjunto de dados
ReadExplore	Concede acesso de leitura e exploração ao conteúdo no conjunto de dados
ReadReshareExplore	Concede acesso de leitura, compartilhamento e exploração ao conteúdo no conjunto de dados

PostDatasetUserAccess

Objeto

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

Nome	Tipo	Description
datasetUserAccessRight	DatasetUserAccessRightEntry	Obrigatório O direito de acesso a ser concedido ao usuário para o conjunto de dados.
identifier	string	Para o tipo `User`principal, forneça o UPN. Caso contrário, forneça a ID do objeto da entidade de segurança.
principalType	PrincipalType	O tipo principal

PrincipalType

Enumeração

O tipo principal

Valor	Description
None	Nenhum tipo de entidade de segurança. Use todo o acesso ao nível da organização.
User	Tipo de entidade de usuário
Group	Tipo de entidade de grupo
App	Tipo de entidade de serviço