Admin - Users GetUserArtifactAccessAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

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

Berechtigungen

Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen 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

With optional parameters:

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 Abschnitt des Resultsets abzurufen

Antworten

Name	Typ	Beschreibung
200 OK	ArtifactAccessResponse	OK

Beispiele

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

Definitionen

Name	Beschreibung
ArtifactAccessEntry	Ein Benutzerzugriffseintrag für ein Power BI-Element
ArtifactAccessResponse	Der OData-Antwort-Wrapper 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
User	Ein Power BI-Benutzer

ArtifactAccessEntry

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, wie der Zugriff auf das Power BI-Element gewährt wird. Nur für weit verbreitete Artefakt-APIs verfügbar.
sharer	User	Der Benutzer, der das Power BI-Element freigegeben hat. Nur für weit verbreitete Artefakt-APIs verfügbar.

ArtifactAccessResponse

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

Name	Typ	Beschreibung
artifactAccessEntities	ArtifactAccessEntry[]	Die Liste der Power BI-Elemente, auf die ein Benutzer zugreifen kann
continuationToken	string	Das Token für den nächsten Abschnitt im Resultset
continuationUri	string	Der URI des nächsten Abschnitts im Resultset
odata.context	string

ArtifactType

Artefakttyp

Name	Typ	Beschreibung
App	string	Power BI-Apps
Capacity	string	Capacity-Objekt
Dashboard	string	Power BI-Dashboard
Dataflow	string	Power BI Dataflow
Dataset	string	Power BI-Dataset
Group	string	V1-Objekt des freigegebenen Arbeitsbereichs
PaginatedReport	string	Paginierter Power BI-Bericht
PersonalGroup	string	Mein Arbeitsbereichsobjekt
Report	string	Power BI-Bericht
Workspace	string	Freigegebenes Arbeitsbereichsobjekt

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf organization ganzen Organization ebene.
User	string	Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Name	Typ	Beschreibung
displayName	string	Der Dienstprinzipalprofilname
id	string	Die Dienstprinzipalprofil-ID

User

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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
userType	string	Typ des Benutzers.

Freigeben über

Admin - Users GetUserArtifactAccessAsAdmin

Berechtigungen

Erforderlicher Bereich

Einschränkungen

URI-Parameter

Antworten

Beispiele

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

Definitionen

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User

Zusätzliche Ressourcen