Freigeben über

Admin - Users GetUserArtifactAccessAsAdmin

Dienst:
Power BI REST APIs
API-Version:
v1.0

Gibt eine Liste von Power BI-Elementen (z. B. Berichten oder Dashboards) zurück, auf die der angegebene Benutzer Zugriff hat.

Erlaubnisse

  • Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.
  • Delegierte Berechtigungen werden unterstützt.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde. 

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
userId
 path True

string

Die Graph-ID oder der Benutzerprinzipalname (UPN) des Benutzers
artifactTypes
 query

string

Durch Trennzeichen getrennte Liste der Artefakttypen.
continuationToken
 query

string

Token erforderlich, um den nächsten Teil des Resultsets abzurufen

Antworten

Name Typ Beschreibung
200 OK

ArtifactAccessResponse

OKAY

Beispiele

Example
Example with artifactTypes
Example with Guest User
Example with UPN

Example

Beispielanforderung

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

Beispiel für eine Antwort

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

Beispielanforderung

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

Beispiel für eine Antwort

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

Beispielanforderung

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

Beispiel für eine Antwort

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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"
}

Definitionen

Name Beschreibung
ArtifactAccessEntry

Ein Benutzerzugriffseintrag für ein Power BI-Element
ArtifactAccessResponse

Der OData-Antwortwrapper für eine Liste von Power BI-Elementen (z. B. Berichte oder Dashboards), auf die ein Benutzer zugreifen kann
ArtifactType

Artefakttyp
PrincipalType

Der Prinzipaltyp
ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.
User

Ein Power BI-Benutzer

ArtifactAccessEntry

Objekt

Ein Benutzerzugriffseintrag für ein Power BI-Element

Name Typ Beschreibung
accessRight

string

Das Zugriffsrecht, das der Benutzer für das Power BI-Element hat
artifactId

string

Die Power BI-Element-ID
artifactType

ArtifactType

Der Typ des Power BI-Elements
displayName

string

Der Anzeigename des Power BI-Elements
shareType

string

Der Typ der Art, wie der Zugriff auf das Power BI-Element gewährt wird. Nur für weit freigegebene Artefakte-APIs verfügbar.
sharer

User

Der Benutzer, der das Power BI-Element freigegeben hat. Nur für weit freigegebene Artefakte-APIs verfügbar.

ArtifactAccessResponse

Objekt

Der OData-Antwortwrapper für eine Liste von Power BI-Elementen (z. B. Berichte oder Dashboards), auf die ein Benutzer zugreifen kann

Name Typ Beschreibung
@odata.context

string

artifactAccessEntities

ArtifactAccessEntry[]

Die Liste der Power BI-Elemente, auf die ein Benutzer zugreifen kann
continuationToken

string

Das Token für den nächsten Block im Resultset
continuationUri

string

Der URI des nächsten Abschnitts im Resultset

ArtifactType

Enumeration

Artefakttyp

Wert Beschreibung
Report

Power BI-Bericht
PaginatedReport

Power BI Paginated Report
Dashboard

Power BI-Dashboard
Dataset

Power BI-Dataset
Dataflow

Power BI Dataflow
PersonalGroup

Mein Arbeitsbereichsobjekt
Group

Freigegebenes V1-Arbeitsbereichsobjekt
Workspace

Freigegebenes Arbeitsbereichsobjekt
Capacity

Capacity-Objekt
App

Power BI-Apps

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

ServicePrincipalProfile

Objekt

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string (uuid)

Die Dienstprinzipalprofil-ID

User

Objekt

Ein Power BI-Benutzer

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals
emailAddress

string

E-Mail-Adresse des Benutzers
graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.
identifier

string

Bezeichner des Prinzipals
principalType

PrincipalType

Der Prinzipaltyp
profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.
userType

string

Typ des Benutzers.