Partager via

Gateways - Get Datasource Users

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

Retourne la liste des utilisateurs qui ont accès à la source de données spécifiée.

Permissions

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

Étendue requise

Dataset.ReadWrite.All ou Dataset.Read.All

Limites

Les passerelles de réseau virtuel (VNet) ne sont pas prises en charge. 

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

Réponses

Nom Type Description
200 OK

DatasourceUsers

Ok

Exemples

Example

Exemple de requête

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

Exemple de réponse

Code d’état:
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"
    }
  ]
}

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
DatasourceUsers

Wrapper de réponse OData pour une liste d’utilisateurs Power BI ayant accès à une source de données
PrincipalType

Type de principal
ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour la 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 la 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.

DatasourceUsers

Object

Wrapper de réponse OData pour une liste d’utilisateurs Power BI ayant accès à une source de données

Nom Type Description
@odata.context

string

value

DatasourceUser[]

Liste des utilisateurs ayant accès à une source de données

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