Admin - Apps GetAppUsersAsAdmin

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

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

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/apps/{appId}/users

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
appId	path	True	string (uuid)	Identyfikator aplikacji

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AppUsers	OK

Przykłady

Example

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Przykładowa odpowiedź

Kod stanu:: 200

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

Definicje

Nazwa	Opis
AppUser	Wpis prawa dostępu użytkownika usługi Power BI dla aplikacji
AppUserAccessRight	Prawo dostępu, które użytkownik ma dla aplikacji
AppUsers	Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do aplikacji
PrincipalType	Typ podmiotu zabezpieczeń

AppUser

Objekt

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

Nazwa	Typ	Opis
appUserAccessRight	AppUserAccessRight	Prawo dostępu, które użytkownik ma dla aplikacji
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ń

AppUserAccessRight

Wyliczanie

Prawo dostępu, które użytkownik ma dla aplikacji

Wartość	Opis
None	Brak uprawnień do zawartości w aplikacji
Read	Przyznaje dostęp do odczytu zawartości w aplikacji
ReadWrite	Przyznaje dostęp do odczytu i zapisu do zawartości w aplikacji
ReadReshare	Przyznaje dostęp do odczytu i udostępniania dalej zawartości w aplikacji
ReadWriteReshare	Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w aplikacji
ReadExplore	Przyznaje dostęp do odczytu i eksplorowania zawartości w aplikacji
ReadCopy	Przyznaje dostęp do odczytu i kopiowania zawartości w aplikacji
ReadExploreCopy	Udziela dostępu do odczytu, eksplorowania i kopiowania zawartości w aplikacji
ReadReshareExplore	Przyznaje uprawnienia do odczytu, udostępniania dalej i eksplorowania dostępu do zawartości w aplikacji
ReadReshareExploreCopy	Udziela uprawnień do odczytu, udostępniania dalej, eksplorowania i kopiowania dostępu do zawartości w aplikacji
ReadWriteExplore	Udziela dostępu do odczytu, zapisu i eksplorowania zawartości w aplikacji
ReadWriteReshareExplore	Przyznaje dostęp do zawartości w aplikacji: odczyt, zapis, udostępnianie dalej i eksplorowanie
ReadWriteExploreCopy	Udziela dostępu do odczytu, zapisu, eksplorowania i kopiowania do zawartości w aplikacji
ReadReshareCopy	Udziela dostępu do odczytu, udostępniania dalej i kopiowania zawartości w aplikacji
All	Udziela dostępu do odczytu, zapisu, eksplorowania, udostępniania dalej i kopiowania zawartości w aplikacji

AppUsers