Admin - Apps GetAppUsersAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

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

Autorisations

L’utilisateur doit disposer de droits d’administrateur (par exemple, Office 365 administrateur général ou administrateur de service Power BI) 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 de consentement administrateur pour Power BI définies sur elle dans le Portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Pertinent 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 demandes 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 de l’application

Réponses

Nom	Type	Description
200 OK	AppUsers	OK

Exemples

Example

Sample Request

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

Sample Response

Status code:: 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 principal

AppUser

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 d’affichage 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 principal

AppUserAccessRight

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

Nom	Type	Description
All	string	Octroie l’accès en lecture, écriture, exploration, repartage et copie au contenu de l’application
None	string	Aucune autorisation d’accès au contenu dans l’application
Read	string	Octroie l’accès en lecture au contenu dans l’application
ReadCopy	string	Octroie l’accès en lecture et copie au contenu de l’application
ReadExplore	string	Octroie l’accès lecture et exploration au contenu de l’application
ReadExploreCopy	string	Octroie l’accès en lecture, explorer et copier du contenu dans l’application
ReadReshare	string	Octroie l’accès en lecture et repartage au contenu dans l’application
ReadReshareCopy	string	Octroie l’accès en lecture, repartage et copie au contenu de l’application
ReadReshareExplore	string	Octroie l’accès en lecture, repartage et exploration au contenu de l’application
ReadReshareExploreCopy	string	Octroie l’accès en lecture, repartage, explorer et copier du contenu dans l’application
ReadWrite	string	Octroie l’accès en lecture et en écriture au contenu de l’application
ReadWriteExplore	string	Octroie l’accès en lecture, écriture et exploration au contenu de l’application
ReadWriteExploreCopy	string	Octroie l’accès en lecture, écriture, exploration et copie au contenu de l’application
ReadWriteReshare	string	Octroie l’accès en lecture, écriture et repartage au contenu dans l’application
ReadWriteReshareExplore	string	Octroie l’accès en lecture, écriture, repartage et exploration au contenu de l’application

AppUsers

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

Nom	Type	Description
odata.context	string
value	AppUser[]	Liste des utilisateurs ayant accès à une application

PrincipalType

Type principal

Nom	Type	Description
App	string	Type de principal de service
Group	string	Type de principal de groupe
None	string	Aucun type de principal. Utilisez pour l’ensemble de l’accès au niveau de l’organisation.
User	string	Type de principal d’utilisateur