Gateways - Get Datasource Users

Service:

Power BI REST APIs

API Version:

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 VNet (rede virtual).

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 de gateway.

Respostas

Nome	Tipo	Description
200 OK	DatasourceUsers	OK

Exemplos

Example

Sample Request

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

Sample Response

Status code:

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 de entidade de segurança
ServicePrincipalProfile	Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de multilocação.

DatasourceUser

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 de entidade de segurança
profile	ServicePrincipalProfile	Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de multilocação.

DatasourceUserAccessRight

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

Nome	Tipo	Description
None	string	Não há permissão para acessar a fonte de dados. Aplica-se somente ao atualizar permissões de usuário.
Read	string	Os conjuntos de dados pertencentes ao usuário têm acesso de leitura à fonte de dados
ReadOverrideEffectiveIdentity	string	O usuário pode substituir a identidade efetiva para Power BI Embedded. Aplicável somente para fontes de dados locais do Analysis Services.

DatasourceUsers

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

O tipo de entidade de segurança

Nome	Tipo	Description
App	string	Tipo de entidade de serviço
Group	string	Tipo de entidade de grupo
None	string	Nenhum tipo de entidade de segurança. Use para acesso em nível de organização inteiro.
User	string	Tipo de entidade de usuário

ServicePrincipalProfile

Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de multilocação.

Nome	Tipo	Description
displayName	string	O nome do perfil da entidade de serviço
id	string	A ID do perfil da entidade de serviço