Admin - Users GetUserArtifactAccessAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne), do których określony użytkownik ma dostęp.

Uprawnienia

• Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.
• Uprawnienia delegowane są obsługiwane.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

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}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
userId	path	True	string	Identyfikator grafu lub główna nazwa użytkownika (UPN) użytkownika
artifactTypes	query		string	Rozdzielona przecinkami lista typów artefaktów.
continuationToken	query		string	Token wymagany do pobrania następnego fragmentu zestawu wyników

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ArtifactAccessResponse	OK

Przykłady

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

Definicje

Nazwa	Opis
ArtifactAccessEntry	Wpis dostępu użytkownika dla elementu usługi Power BI
ArtifactAccessResponse	Otoka odpowiedzi OData dla listy elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne), do których użytkownik może uzyskać dostęp
ArtifactType	Typ artefaktu
PrincipalType	Typ podmiotu zabezpieczeń
ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
User	Użytkownik usługi Power BI

ArtifactAccessEntry

Wpis dostępu użytkownika dla elementu usługi Power BI

Nazwa	Typ	Opis
accessRight	string	Prawo dostępu, które użytkownik ma dla elementu usługi Power BI
artifactId	string	Identyfikator elementu usługi Power BI
artifactType	ArtifactType	Typ elementu usługi Power BI
displayName	string	Nazwa wyświetlana elementu usługi Power BI
shareType	string	Typ sposobu uzyskiwania dostępu do elementu usługi Power BI. Dostępne tylko dla powszechnie udostępnionych interfejsów API artefaktów.
sharer	User	Użytkownik, który udostępnił element usługi Power BI. Dostępne tylko dla powszechnie udostępnionych interfejsów API artefaktów.

ArtifactAccessResponse

Otoka odpowiedzi OData dla listy elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne), do których użytkownik może uzyskać dostęp

Nazwa	Typ	Opis
artifactAccessEntities	ArtifactAccessEntry[]	Lista elementów usługi Power BI, do których użytkownik może uzyskać dostęp
continuationToken	string	Token dla następnego fragmentu w zestawie wyników
continuationUri	string	Identyfikator URI następnego fragmentu w zestawie wyników
odata.context	string

ArtifactType

Typ artefaktu

Nazwa	Typ	Opis
App	string	Aplikacje usługi Power BI
Capacity	string	Obiekt pojemności
Dashboard	string	Pulpit nawigacyjny usługi Power BI
Dataflow	string	Przepływ danych usługi Power BI
Dataset	string	Zestaw danych usługi Power BI
Group	string	Obiekt udostępnionego obszaru roboczego w wersji 1
PaginatedReport	string	Raport podzielony na strony usługi Power BI
PersonalGroup	string	Mój obiekt obszaru roboczego
Report	string	Raport usługi Power BI
Workspace	string	Obiekt udostępnionego obszaru roboczego

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa	Typ	Opis
App	string	Typ jednostki usługi
Group	string	Typ podmiotu zabezpieczeń grupy
None	string	Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User	string	Typ podmiotu zabezpieczeń użytkownika

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Nazwa	Typ	Opis
displayName	string	Nazwa profilu jednostki usługi
id	string	Identyfikator profilu jednostki usługi

User

Użytkownik usługi Power BI

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress	string	Adres e-mail użytkownika
graphId	string	Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
identifier	string	Identyfikator podmiotu zabezpieczeń
principalType	PrincipalType	Typ podmiotu zabezpieczeń
profile	ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType	string	Typ użytkownika.