Admin - Apps GetAppUsersAsAdmin

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

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

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 prinicipal usługi aplikacja nie może mieć żadnych wymaganych przez administratora premisji dla usługi Power BI ustawionych w Azure Portal.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego tokenu dostępu administratora delegowanego. Nie może być obecny w przypadku użycia uwierzytelniania 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

Sample Request

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

Sample Response

Status code:: 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

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 administratora.
identifier	string	Identyfikator podmiotu zabezpieczeń
principalType	PrincipalType	Typ podmiotu zabezpieczeń

AppUserAccessRight

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

Nazwa	Typ	Opis
All	string	Udziela dostępu do odczytu, zapisu, eksplorowania, udostępniania i kopiowania zawartości w aplikacji
None	string	Brak uprawnień do zawartości w aplikacji
Read	string	Udziela dostępu do odczytu zawartości w aplikacji
ReadCopy	string	Udziela dostępu do odczytu i kopiowania zawartości w aplikacji
ReadExplore	string	Udziela dostępu do odczytu i eksplorowania zawartości w aplikacji
ReadExploreCopy	string	Udziela dostępu do odczytu, eksplorowania i kopiowania zawartości w aplikacji
ReadReshare	string	Udziela dostępu do odczytu i udostępniania dalej zawartości w aplikacji
ReadReshareCopy	string	Udziela dostępu do odczytu, udostępniania dalej i kopiowania zawartości w aplikacji
ReadReshareExplore	string	Udziela uprawnień do odczytu, udostępniania i eksplorowania dostępu do zawartości w aplikacji
ReadReshareExploreCopy	string	Udziela dostępu do odczytu, udostępniania dalej, eksplorowania i kopiowania zawartości w aplikacji
ReadWrite	string	Udziela dostępu do odczytu i zapisu zawartości w aplikacji
ReadWriteExplore	string	Udziela dostępu do odczytu, zapisu i eksplorowania zawartości w aplikacji
ReadWriteExploreCopy	string	Udziela dostępu do odczytu, zapisu, eksplorowania i kopiowania zawartości w aplikacji
ReadWriteReshare	string	Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w aplikacji
ReadWriteReshareExplore	string	Udziela dostępu do odczytu, zapisu, udostępniania dalej i eksplorowania zawartości w aplikacji

AppUsers

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

Nazwa	Typ	Opis
odata.context	string
value	AppUser[]	Lista użytkowników z dostępem do aplikacji

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

Udostępnij za pośrednictwem