Partager via

Gateways - Add Datasource User

Service:
Power BI REST APIs
Version d'API:
v1.0

Accorde 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) du 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) qu’un utilisateur a sur la source de données
displayName

string

Nom complet du principal
emailAddress

string

Adresse e-mail de l’utilisateur
identifier

string

ID d’objet du principal
principalType

PrincipalType

Type de principal
profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

Réponses

Nom Type Description
200 OK

D’ACCORD

Exemples

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

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Exemple de requête

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

Exemple de réponse

Code d’état:
200

Example

Exemple de requête

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

Exemple de réponse

Code d’état:
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) qu’un utilisateur a sur la source de données
PrincipalType

Type de principal
ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

DatasourceUser

Object

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

Nom Type Description
datasourceAccessRight

DatasourceUserAccessRight

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

string

Nom complet du principal
emailAddress

string

Adresse e-mail de l’utilisateur
identifier

string

ID d’objet du principal
principalType

PrincipalType

Type de principal
profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

DatasourceUserAccessRight

Énumération

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

Valeur Description
None

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

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

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

PrincipalType

Énumération

Type de principal

Valeur Description
None

Aucun type de principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User

Type de principal de l’utilisateur
Group

Type de principal de groupe
App

Type de principal de service

ServicePrincipalProfile

Object

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

Nom Type Description
displayName

string

Nom du profil du principal de service
id

string (uuid)

ID de profil du principal de service