Admin - Apps GetAppUsersAsAdmin

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce un elenco di utenti che hanno accesso all'app specificata.

Autorizzazioni

L'utente deve disporre dei diritti di amministratore( ad esempio Office 365 amministratore globale o amministratore del servizio Power BI) o eseguire l'autenticazione tramite un'entità servizio.
Le autorizzazioni delegate sono supportate.

Quando viene eseguita con l'autenticazione priniciale del servizio, un'app non deve avere premissioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Rilevante solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.

Limitazioni

Numero massimo di 200 richieste all'ora.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
appId	path	True	string uuid	The app ID

Risposte

Nome	Tipo	Descrizione
200 OK	AppUsers	OK

Esempio

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"
    }
  ]
}

Definizioni

Nome	Descrizione
AppUser	Immissione del diritto di accesso utente di Power BI per un'app
AppUserAccessRight	Diritto di accesso a cui l'utente ha per l'app
AppUsers	Wrapper di risposta OData per un elenco di utenti di Power BI con accesso a un'app
PrincipalType	Tipo di entità

AppUser

Immissione del diritto di accesso utente di Power BI per un'app

Nome	Tipo	Descrizione
appUserAccessRight	AppUserAccessRight	Diritto di accesso a cui l'utente ha per l'app
displayName	string	Nome visualizzato dell'entità
emailAddress	string	Indirizzo di posta elettronica dell'utente
graphId	string	Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier	string	Identificatore dell'entità
principalType	PrincipalType	Tipo di entità

AppUserAccessRight

Diritto di accesso a cui l'utente ha per l'app

Nome	Tipo	Descrizione
All	string	Concede l'accesso in lettura, scrittura, esplorazione, ricondivisione e copia al contenuto nell'app
None	string	Nessuna autorizzazione per il contenuto nell'app
Read	string	Concede l'accesso in lettura al contenuto nell'app
ReadCopy	string	Concede l'accesso in lettura e copia al contenuto nell'app
ReadExplore	string	Concede l'accesso in lettura ed esplora al contenuto nell'app
ReadExploreCopy	string	Concede l'accesso in lettura, esplora e copia al contenuto nell'app
ReadReshare	string	Concede l'accesso in lettura e ricondivisione al contenuto nell'app
ReadReshareCopy	string	Concede l'accesso in lettura, ricondivisione e copia al contenuto nell'app
ReadReshareExplore	string	Concede l'accesso in lettura, ricondivisione ed esplora ai contenuti nell'app
ReadReshareExploreCopy	string	Concede l'accesso in lettura, ricondivisione, esplora e copia al contenuto nell'app
ReadWrite	string	Concede l'accesso in lettura e scrittura al contenuto nell'app
ReadWriteExplore	string	Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nell'app
ReadWriteExploreCopy	string	Concede l'accesso in lettura, scrittura, esplorazione e copia al contenuto nell'app
ReadWriteReshare	string	Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nell'app
ReadWriteReshareExplore	string	Concede l'accesso di lettura, scrittura, ricondivisione ed esplorare il contenuto nell'app

AppUsers

Wrapper di risposta OData per un elenco di utenti di Power BI con accesso a un'app

Nome	Tipo	Descrizione
odata.context	string
value	AppUser[]	Elenco di utenti con accesso a un'app

PrincipalType

Tipo di entità

Nome	Tipo	Descrizione
App	string	Tipo di entità servizio
Group	string	Tipo di entità gruppo
None	string	Nessun tipo di entità. Usare per l'accesso a livello di intera organizzazione.
User	string	Tipo di entità utente