Gateways - Add Datasource User

  • Référence
Service:
Power BI REST APIs
API Version:
v1.0

Octroie ou met à jour les autorisations requises pour utiliser la source de données spécifiée pour l’utilisateur spécifié.

Autorisations

L’utilisateur doit disposer d’autorisations d’administrateur de passerelle.

Étendue requise

Dataset.ReadWrite.All

Limites

Les passerelles de réseau virtuel (VNet) ne sont pas prises en charge. L’ajout de groupes via l’API n’est pas pris en charge. 

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

Paramètres URI

Nom Dans Obligatoire Type Description
datasourceId
 path True

string

uuid

ID de source de données
gatewayId
 path True

string

uuid

ID de passerelle. Lors de l’utilisation d’un cluster de passerelle, l’ID de passerelle fait référence à la passerelle principale (première) dans le cluster. Dans ce cas, l’ID de passerelle est similaire à l’ID de cluster de passerelle.

Corps de la demande

Nom Obligatoire Type Description
datasourceAccessRight True

DatasourceUserAccessRight

Droit d’accès (niveau d’autorisation) d’un utilisateur sur la source de données
displayName

string

Nom d’affichage du principal
emailAddress

string

Adresse e-mail de l’utilisateur
identifier

string

ID d’objet du principal
principalType

PrincipalType

Type principal
profile

ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

Réponses

Nom Type Description
200 OK

Ok

Exemples

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

Définitions

Nom Description
DatasourceUser

Un utilisateur Power BI ayant accès à la source de données
DatasourceUserAccessRight

Droit d’accès (niveau d’autorisation) d’un utilisateur sur la source de données
PrincipalType

Type principal
ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

DatasourceUser

Un utilisateur Power BI ayant accès à la source de données

Nom Type Description
datasourceAccessRight

DatasourceUserAccessRight

Droit d’accès (niveau d’autorisation) d’un utilisateur sur la source de données
displayName

string

Nom d’affichage du principal
emailAddress

string

Adresse e-mail de l’utilisateur
identifier

string

ID d’objet du principal
principalType

PrincipalType

Type principal
profile

ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

DatasourceUserAccessRight

Droit d’accès (niveau d’autorisation) d’un utilisateur sur la source de données

Nom Type Description
None

string

Aucune autorisation d’accès à la source de données. S’applique uniquement lors de la mise à jour des autorisations utilisateur.
Read

string

Les jeux de données appartenant à l’utilisateur ont un accès en lecture à la source de données
ReadOverrideEffectiveIdentity

string

L’utilisateur peut remplacer l’identité effective pour Power BI Embedded. Applicable uniquement aux sources de données Analysis Services locales.

PrincipalType

Type principal

Nom Type Description
App

string

Type de principal de service
Group

string

Type de principal de groupe
None

string

Aucun type principal. Utilisez pour un accès de niveau organization entier.
User

string

Type de principal d’utilisateur

ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

Nom Type Description
displayName

string

Nom du profil principal de service
id

string

ID de profil du principal de service