Groups - Get Group Users

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

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

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo entità servizio. Per altre informazioni, vedere Profili entità servizio in Power BI Embedded.

Ambito obbligatorio

Workspace.Read.All o Workspace.ReadWrite.All

Limitazioni

Le autorizzazioni utente per le aree di lavoro richiedono tempo per l'aggiornamento e potrebbero non essere immediatamente disponibili quando si usano le chiamate API. Per aggiornare le autorizzazioni utente, usare la chiamata API Aggiorna autorizzazioni utente .

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

Con parametri facoltativi:

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users?$top={$top}&$skip={$skip}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
groupId	path	True	string uuid	ID area di lavoro
$skip	query		integer int32	Ignora i primi n risultati
$top	query		integer int32	Restituisce solo i primi n risultati

Risposte

Nome	Tipo	Descrizione
200 OK	GroupUsers	OK

Esempio

Example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "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

Condividi tramite