Admin - Dashboards GetDashboardUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

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

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.

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 Azure Portal.

Zakres wymagany

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

Sample Request

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

Sample Response

Status code:

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 główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

DashboardUser

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 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.

DashboardUserAccessRight

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

Nazwa	Typ	Opis
None	string	Brak uprawnień do zawartości na pulpicie nawigacyjnym
Owner	string	Przyznaje uprawnienia do odczytu, zapisu i udostępniania dalej dostępu do zawartości w raporcie
Read	string	Przyznaje dostęp do odczytu do zawartości na pulpicie nawigacyjnym
ReadCopy	string	Przyznaje dostęp do odczytu i kopiowania do zawartości na pulpicie nawigacyjnym
ReadReshare	string	Przyznaje dostęp do odczytu i udostępniania dalej zawartości na pulpicie nawigacyjnym
ReadWrite	string	Przyznaje dostęp do odczytu i zapisu do zawartości na pulpicie nawigacyjnym

DashboardUsers

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

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