Partilhar via

Gateways - Get Datasource Users

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna uma lista de usuários que têm acesso à fonte de dados especificada.

Permissões

O usuário deve ter permissões de administrador de gateway.

Escopo necessário

Dataset.ReadWrite.All ou Dataset.Read.All

Limitações

Não há suporte para gateways de rede virtual (VNet). 

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasourceId
 path True

string (uuid)

A ID da fonte de dados
gatewayId
 path True

string (uuid)

A ID do gateway. Ao usar um cluster de gateway, a ID do gateway refere-se ao gateway primário (primeiro) no cluster. Nesses casos, a ID do gateway é semelhante à ID do cluster do gateway.

Respostas

Nome Tipo Description
200 OK

DatasourceUsers

OKEY

Exemplos

Example

Solicitação de exemplo

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Resposta de exemplo

Código de status:
200 
{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definições

Nome Description
DatasourceUser

Um usuário do Power BI com acesso à fonte de dados
DatasourceUserAccessRight

O direito de acesso (nível de permissão) que um usuário tem na fonte de dados
DatasourceUsers

O wrapper de resposta OData para uma lista de usuários do Power BI com acesso a uma fonte de dados
PrincipalType

O tipo principal
ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.

DatasourceUser

Objeto

Um usuário do Power BI com acesso à fonte de dados

Nome Tipo Description
datasourceAccessRight

DatasourceUserAccessRight

O direito de acesso (nível de permissão) que um usuário tem na fonte de dados
displayName

string

O nome de exibição da entidade de segurança
emailAddress

string

O endereço de email do usuário
identifier

string

A ID do objeto da entidade de segurança
principalType

PrincipalType

O tipo principal
profile

ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.

DatasourceUserAccessRight

Enumeração

O direito de acesso (nível de permissão) que um usuário tem na fonte de dados

Valor Description
None

Nenhuma permissão para acessar a fonte de dados. Aplica-se somente ao atualizar as permissões do usuário.
Read

Conjuntos de dados pertencentes ao usuário têm acesso de leitura à fonte de dados
ReadOverrideEffectiveIdentity

O usuário pode substituir a identidade efetiva do Power BI Embedded. Aplicável somente para fontes de dados locais do Analysis Services.

DatasourceUsers

Objeto

O wrapper de resposta OData para uma lista de usuários do Power BI com acesso a uma fonte de dados

Nome Tipo Description
@odata.context

string

value

DatasourceUser[]

A lista de usuários com acesso a uma fonte 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

ServicePrincipalProfile

Objeto

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.

Nome Tipo Description
displayName

string

O nome do perfil da entidade de serviço
id

string (uuid)

A ID do perfil da entidade de serviço