Admin - Apps GetAppUsersAsAdmin

Service:: Power BI REST APIs

Version d'API:: v1.0

Retourne une liste d’utilisateurs qui ont accès à l’application spécifiée.

Permissions

L’utilisateur doit être un administrateur Fabric ou s’authentifier à l’aide d’un principal de service.
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 avoir de prémissions requises par l’administrateur pour Power BI définie sur celle-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.

Limites

Maximum 200 requêtes par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/apps/{appId}/users

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
appId	path	True	string (uuid)	ID d’application

Réponses

Nom	Type	Description
200 OK	AppUsers	Ok

Exemples

Example

Exemple de requête

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Définitions

Nom	Description
AppUser	Entrée de droit d’accès utilisateur Power BI pour une application
AppUserAccessRight	Droit d’accès dont dispose l’utilisateur pour l’application
AppUsers	Wrapper de réponse OData pour une liste d’utilisateurs Power BI ayant accès à une application
PrincipalType	Type de principal

AppUser

Object

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

Nom	Type	Description
appUserAccessRight	AppUserAccessRight	Droit d’accès dont dispose l’utilisateur pour l’application
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

AppUserAccessRight

Énumération

Droit d’accès dont dispose l’utilisateur pour l’application

Valeur	Description
None	Aucune autorisation pour le contenu dans l’application
Read	Octroie l’accès en lecture au contenu dans l’application
ReadWrite	Octroie l’accès en lecture et écriture au contenu dans l’application
ReadReshare	Accorde l’accès en lecture et repartage au contenu dans l’application
ReadWriteReshare	Accorde l’accès en lecture, écriture et partage à nouveau au contenu dans l’application
ReadExplore	Octroie l’accès en lecture et explorer au contenu dans l’application
ReadCopy	Octroie l’accès en lecture et copie au contenu dans l’application
ReadExploreCopy	Octroie l’accès en lecture, explorer et copier du contenu dans l’application
ReadReshareExplore	Octroie la lecture, le partage et l’exploration de l’accès au contenu dans l’application
ReadReshareExploreCopy	Octroie la lecture, le partage, l’exploration et la copie de l’accès au contenu dans l’application
ReadWriteExplore	Octroie l’accès en lecture, écriture et exploration au contenu dans l’application
ReadWriteReshareExplore	Accorde l’accès en lecture, écriture, partage et exploration du contenu dans l’application
ReadWriteExploreCopy	Octroie l’accès en lecture, écriture, exploration et copie au contenu dans l’application
ReadReshareCopy	Accorde l’accès en lecture, repartage et copie du contenu dans l’application
All	Octroie l’accès en lecture, écriture, exploration, partage et copie du contenu dans l’application

AppUsers