Gateways - Add Datasource User

  • Referência
Service:
Power BI REST APIs
API Version:
v1.0

Concede ou atualiza as permissões necessárias para usar a fonte de dados especificada para o usuário especificado.

Permissões

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

Escopo necessário

Dataset.ReadWrite.All

Limitações

Não há suporte para gateways de VNet (rede virtual). Não há suporte para a adição de grupos por meio da API. 

POST 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.

Corpo da solicitação

Nome Obrigatório Tipo Description
datasourceAccessRight True

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.

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example
Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Request Body
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Sample Response

Status code:
200

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Request Body
{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Sample Response

Status code:
200

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

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