Partilhar via

Gateways - Add Datasource User

Serviço:
Power BI REST APIs
Versão da API:
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 rede virtual (VNet). Não há suporte para adicionar 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 do 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 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.

Respostas

Nome Tipo Description
200 OK

OKEY

Exemplos

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

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200

Example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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 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.

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