Partager via

Admin - Capacities GetCapacityUsersAsAdmin

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

Retourne une liste d’utilisateurs qui ont accès à l’espace de travail spécifié.

Autorisations

  • L’utilisateur doit être administrateur fabric.
  • Les autorisations déléguées sont prises en charge.

Lors de l’exécution sous l’authentification prinicipal du service, une application ne doit pas disposer de prémissions requises par l’administrateur pour Power BI définies sur celui-ci dans le portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Applicable uniquement lors de l’authentification via un jeton d’accès administrateur délégué standard. Ne doit pas être présent lorsque l’authentification via un principal de service est utilisée.

Limitations

Maximum 200 requêtes par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/users

Paramètres URI

Nom Dans Obligatoire Type Description
capacityId
 path True

string (uuid)

ID de capacité

Réponses

Nom Type Description
200 OK

CapacityUsers

D’ACCORD

Définitions

Nom Description
CapacityUser

Entrée de droit d’accès utilisateur Power BI pour une capacité
capacityUserAccessRight

Droit d’accès que l’utilisateur a sur la capacité
CapacityUsers

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

Type de principal
ServicePrincipalProfile

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

CapacityUser

Object

Entrée de droit d’accès utilisateur Power BI pour une capacité

Nom Type Description
capacityUserAccessRight

capacityUserAccessRight

Droit d’accès que l’utilisateur a sur la capacité
displayName

string

Nom complet du principal
emailAddress

string

Adresse e-mail de l’utilisateur
graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.
identifier

string

Identificateur du principal
principalType

PrincipalType

Type de principal
profile

ServicePrincipalProfile

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

string

Type de l’utilisateur.

capacityUserAccessRight

Énumération

Droit d’accès que l’utilisateur a sur la capacité

Valeur Description
None

L’utilisateur n’a pas accès à la capacité
Assign

L’utilisateur a des droits de contributeur et peut affecter des espaces de travail à la capacité
Admin

L’utilisateur dispose de droits d’administrateur sur la capacité

CapacityUsers

Object

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

Nom Type Description
@odata.context

string

value

CapacityUser[]

Liste des utilisateurs ayant accès à une capacité

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