Partilhar via

Datasets - Post Dataset User In Group

Serviço:
Power BI REST APIs
Versão da API:
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 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/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ório O direito de acesso a ser concedido ao usuário para o conjunto de dados.
identifier True

string

Para o tipo Userprincipal, 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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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 Userprincipal, 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