Udostępnij przez

Admin - Reports GetReportUsersAsAdmin

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Zwraca listę użytkowników, którzy mają dostęp do określonego raportu.

Permissions

  • Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać się przy użyciu jednostki usługi.
  • Uprawnienia delegowane są obsługiwane.

W przypadku uruchamiania w ramach uwierzytelniania podstawowego usługi aplikacja nie może mieć żadnych premii wymaganych przez administratora dla usługi Power BI ustawionych w witrynie Azure Portal.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

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

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/users

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
reportId
 path True

string (uuid)

Identyfikator raportu

Odpowiedzi

Nazwa Typ Opis
200 OK

ReportUsers

OK

Przykłady

Example

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/users

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "reportUserAccessRight": "Owner",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definicje

Nazwa Opis
PrincipalType

Typ podmiotu zabezpieczeń
ReportUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu
ReportUserAccessRight

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
ReportUsers

Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do raportu
ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń

Wartość Opis
None

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User

Typ podmiotu zabezpieczeń użytkownika
Group

Typ podmiotu zabezpieczeń grupy
App

Typ jednostki usługi

ReportUser

Objekt

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

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 administratorów.
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.
reportUserAccessRight

ReportUserAccessRight

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
userType

string

Typ użytkownika.

ReportUserAccessRight

Wyliczanie

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)

Wartość Opis
None

Brak uprawnień do zawartości w raporcie
Read

Przyznaje dostęp do odczytu zawartości w raporcie
ReadWrite

Udziela dostępu do odczytu i zapisu do zawartości w raporcie
ReadReshare

Udziela dostępu do odczytu i udostępniania dalej zawartości w raporcie
ReadCopy

Przyznaje dostęp do odczytu i kopiowania zawartości w raporcie
Owner

Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w raporcie

ReportUsers

Objekt

Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do raportu

Nazwa Typ Opis
@odata.context

string

value

ReportUser[]

Lista użytkowników z dostępem do raportu

ServicePrincipalProfile

Objekt

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi
id

string (uuid)

Identyfikator profilu jednostki usługi