Admin - Users GetUserArtifactAccessAsAdmin

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce un elenco di elementi di Power BI, ad esempio report o dashboard, a cui l'utente specificato può accedere.

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.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Limitazioni

Numero massimo di 200 richieste all'ora.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
userId	path	True	string	ID grafico o nome dell'entità utente (UPN) dell'utente
artifactTypes	query		string	Elenco delimitato da virgole di tipi di artefatti.
continuationToken	query		string	Token necessario per ottenere il blocco successivo del set di risultati

Risposte

Nome	Tipo	Descrizione
200 OK	ArtifactAccessResponse	OK

Esempio

Example

Example with artifactTypes

Example with Guest User

Example with UPN

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with artifactTypes

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess?artifactTypes=Dataflow,Dashboard

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "09ce06d1-e81b-fea0-1c6d-8fe3dd2f8e87",
      "displayName": "Test Dataflow",
      "artifactType": "Dataflow",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with Guest User

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23@contoso.com/artifactAccess

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23%40contoso.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with UPN

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definizioni

Nome	Descrizione
ArtifactAccessEntry	Voce di accesso utente per un elemento di Power BI
ArtifactAccessResponse	Wrapper di risposta OData per un elenco di elementi di Power BI (ad esempio report o dashboard) a cui un utente può accedere
ArtifactType	Tipo di artefatto
PrincipalType	Tipo di entità
ServicePrincipalProfile	Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
User	Un utente di Power BI

ArtifactAccessEntry

Voce di accesso utente per un elemento di Power BI

Nome	Tipo	Descrizione
accessRight	string	Diritto di accesso a cui l'utente ha per l'elemento di Power BI
artifactId	string	ID elemento di Power BI
artifactType	ArtifactType	Tipo di elemento di Power BI
displayName	string	Nome visualizzato dell'elemento di Power BI
shareType	string	Tipo di modalità di accesso assegnato all'elemento di Power BI. Disponibile solo per le API degli artefatti ampiamente condivisi.
sharer	User	Utente che ha condiviso l'elemento di Power BI. Disponibile solo per le API degli artefatti ampiamente condivisi.

ArtifactAccessResponse

Wrapper di risposta OData per un elenco di elementi di Power BI (ad esempio report o dashboard) a cui un utente può accedere

Nome	Tipo	Descrizione
artifactAccessEntities	ArtifactAccessEntry[]	Elenco di elementi di Power BI a cui un utente può accedere
continuationToken	string	Token per il blocco successivo nel set di risultati
continuationUri	string	URI del blocco successivo nel set di risultati
odata.context	string

ArtifactType

Tipo di artefatto

Nome	Tipo	Descrizione
App	string	App di Power BI
Capacity	string	Oggetto Capacity
Dashboard	string	dashboard di Power BI
Dataflow	string	Flusso di dati di Power BI
Dataset	string	Set di dati di Power BI
Group	string	Oggetto area di lavoro condivisa V1
PaginatedReport	string	Report impaginato di Power BI
PersonalGroup	string	Oggetto area di lavoro personale
Report	string	Power BI Report
Workspace	string	Oggetto area di lavoro condivisa

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

User

Un utente di Power BI

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.
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.

Condividi tramite

Admin - Users GetUserArtifactAccessAsAdmin

Autorizzazioni

Ambito obbligatorio

Limitazioni

Parametri dell'URI

Risposte

Esempio

Example

Sample Request

Sample Response

Example with artifactTypes

Sample Request

Sample Response

Example with Guest User

Sample Request

Sample Response

Example with UPN

Sample Request

Sample Response

Definizioni

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User

Risorse aggiuntive