Gateways - Get Datasource Users

Référence

Service:: Power BI REST APIs

API Version:: v1.0

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

Autorisations

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) dans le 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

Sample Request

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

Sample Response

Status code:: 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) d’un utilisateur 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 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.

DatasourceUsers

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

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

Partager via