Condividi tramite


Admin - Groups GetGroupUsersAsAdmin

Restituisce un elenco di utenti che hanno accesso all'area di lavoro 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/groups/{groupId}/users

Parametri dell'URI

Nome In Necessario Tipo Descrizione
groupId
path True

string

uuid

ID area di lavoro

Risposte

Nome Tipo Descrizione
200 OK

GroupUsers

OK

Esempio

Example

Sample Request

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

Sample Response

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definizioni

Nome Descrizione
GroupUser

Un utente di Power BI con accesso all'area di lavoro

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) di un utente nell'area di lavoro

GroupUsers

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

PrincipalType

Tipo di entità

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

GroupUser

Un utente di Power BI con accesso all'area di lavoro

Nome Tipo Descrizione
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.

groupUserAccessRight

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) di un utente nell'area di lavoro

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo di entità

profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo di utente.

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) di un utente nell'area di lavoro

Nome Tipo Descrizione
Admin

string

Diritti di amministratore per il contenuto dell'area di lavoro

Contributor

string

Accesso in lettura ed esplorazione (ReadExplore) al contenuto dell'area di lavoro

Member

string

Diritti di accesso di lettura, ricondivisione ed esplorazione (ReadReshareExplore) al contenuto dell'area di lavoro

None

string

Nessun accesso al contenuto dell'area di lavoro

Viewer

string

Accesso di sola lettura (lettura) al contenuto dell'area di lavoro

GroupUsers

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

Nome Tipo Descrizione
odata.context

string

value

GroupUser[]

Elenco di utenti con accesso a un'area di lavoro

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

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio

id

string

ID del profilo dell'entità servizio