Udostępnij przez

Admin - Dashboards GetDashboardUsersAsAdmin

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

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

Uprawnienia

  • 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 aplikacji 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/dashboards/{dashboardId}/users

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
dashboardId
 path True

string (uuid)

Identyfikator pulpitu nawigacyjnego

Odpowiedzi

Nazwa Typ Opis
200 OK

DashboardUsers

OK

Przykłady

Example

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/users

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
DashboardUser

Wpis prawa dostępu użytkownika usługi Power BI dla pulpitu nawigacyjnego
DashboardUserAccessRight

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

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

Typ podmiotu zabezpieczeń
ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

DashboardUser

Objekt

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

Nazwa Typ Opis
dashboardUserAccessRight

DashboardUserAccessRight

Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień)
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 wielodostępu usługi Power BI Embedded.
userType

string

Typ użytkownika.

DashboardUserAccessRight

Wyliczanie

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

Wartość Opis
None

Brak uprawnień do zawartości na pulpicie nawigacyjnym
Read

Przyznaje dostęp do odczytu zawartości na pulpicie nawigacyjnym
ReadWrite

Udziela dostępu do odczytu i zapisu do zawartości na pulpicie nawigacyjnym
ReadReshare

Udziela dostępu do odczytu i udostępniania dalej zawartości na pulpicie nawigacyjnym
ReadCopy

Udziela dostępu do odczytu i kopiowania zawartości na pulpicie nawigacyjnym
Owner

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

DashboardUsers

Objekt

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

Nazwa Typ Opis
@odata.context

string

value

DashboardUser[]

Lista użytkowników z dostępem do pulpitu nawigacyjnego

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

ServicePrincipalProfile

Objekt

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi
id

string (uuid)

Identyfikator profilu jednostki usługi