Datasets - Get Dataset Users

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Retorna uma lista de entidades de segurança que têm acesso 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 Atualizar Permissões de Usuário API.

Permissões

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

Escopo necessário

Dataset.Read.All ou Dataset.ReadWrite.All

Limitações

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.

GET 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

Respostas

Nome	Tipo	Description
200 OK	DatasetUsersAccess	OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

Definições

Nome	Description
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)
DatasetUsersAccess	O wrapper de resposta OData para uma lista de entidades de segurança do Power BI com acesso a um conjunto de dados
PrincipalType	O tipo principal

DatasetUserAccess

Objeto

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

Nome	Tipo	Description
datasetUserAccessRight	DatasetUserAccessRight	Os direitos de acesso a serem atribuídos ao usuário para o conjunto de dados (nível de permissão)
identifier	string	Para de tipo principal, forneça oUPN . Caso contrário, forneça o de ID do objeto da entidade de segurança.
principalType	PrincipalType	O tipo principal

DatasetUserAccessRight

Enumeração

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

Valor	Description
None	Remove a permissão para o conteúdo no conjunto de dados
Read	Concede acesso de leitura ao conteúdo no conjunto de dados
ReadWrite	Concede acesso de leitura e gravação ao conteúdo no conjunto de dados
ReadReshare	Concede acesso de leitura e compartilhamento ao conteúdo no conjunto de dados
ReadWriteReshare	Concede acesso de leitura, gravação 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
ReadWriteExplore	Concede acesso de leitura, gravação e exploração ao conteúdo no conjunto de dados
ReadWriteReshareExplore	Concede acesso de leitura, gravação, compartilhamento e exploração ao conteúdo no conjunto de dados

DatasetUsersAccess

Objeto

O wrapper de resposta OData para uma lista de entidades de segurança do Power BI com acesso a um conjunto de dados

Nome	Tipo	Description
@odata.context	string
value	DatasetUserAccess[]	A lista de usuários com acesso a um conjunto de dados

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