Condividi tramite


Admin - Users GetUserArtifactAccessAsAdmin

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

{
  "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

{
  "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

{
  "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

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