Admin - Apps GetAppUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Belirtilen uygulamaya erişimi olan kullanıcıların listesini döndürür.

İzinler

• Kullanıcının yönetici haklarına (Office 365 Genel Yönetici veya Power BI Hizmet Yöneticisi gibi) sahip olması veya hizmet sorumlusu kullanarak kimlik doğrulaması yapması gerekir.
• Temsilci izinleri desteklenir.

Hizmet özel kimlik doğrulaması altında çalıştırılırken, bir uygulamanın Azure portal Power BI için yönetici onayı için gerekli izinlere sahip olmaması gerekir.

Gerekli Kapsam

Tenant.Read.All veya Tenant.ReadWrite.All

Yalnızca standart bir yönetici temsilcisi erişim belirteci aracılığıyla kimlik doğrulaması yaparken geçerlidir. Hizmet sorumlusu aracılığıyla kimlik doğrulaması kullanıldığında mevcut olmamalıdır.

Sınırlamalar

Saatte en fazla 200 istek.

GET https://api.powerbi.com/v1.0/myorg/admin/apps/{appId}/users

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
appId	path	True	string uuid	Uygulama kimliği

Yanıtlar

Name	Tür	Description
200 OK	AppUsers	Tamam

Örnekler

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"
    }
  ]
}

Tanımlar

Name	Description
AppUser	Power BI kullanıcısı bir uygulama için doğru erişim hakkı girdisi
AppUserAccessRight	Kullanıcının uygulama için sahip olduğu erişim hakkı
AppUsers	Uygulamaya erişimi olan Power BI kullanıcılarının listesi için OData yanıt sarmalayıcısı
PrincipalType	Asıl tür

AppUser

Power BI kullanıcısı bir uygulama için doğru erişim hakkı girdisi

Name	Tür	Description
appUserAccessRight	AppUserAccessRight	Kullanıcının uygulama için sahip olduğu erişim hakkı
displayName	string	Sorumlunun görünen adı
emailAddress	string	Kullanıcının e-posta adresi
graphId	string	Microsoft Graph'taki sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
identifier	string	Sorumlunun tanımlayıcısı
principalType	PrincipalType	Asıl tür

AppUserAccessRight

Kullanıcının uygulama için sahip olduğu erişim hakkı

Name	Tür	Description
All	string	Uygulamadaki içeriğe Okuma, Yazma, Araştırma, Yeniden Paylaşma ve Kopyalama erişimi verir
None	string	Uygulamada içerik için izin yok
Read	string	Uygulamadaki içeriğe Okuma erişimi verir
ReadCopy	string	Uygulamadaki içeriğe Okuma ve Kopyalama erişimi verir
ReadExplore	string	Uygulamadaki içeriğe Okuma ve Keşfetme erişimi verir
ReadExploreCopy	string	Uygulamadaki içeriğe Okuma, Keşfetme ve Kopyalama erişimi verir
ReadReshare	string	Uygulamadaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir
ReadReshareCopy	string	Uygulamadaki içeriğe Okuma, Yeniden Paylaşma ve Kopyalama erişimi verir
ReadReshareExplore	string	Uygulamadaki içeriğe Okuma, Yeniden Paylaşma ve Keşfetme erişimi verir
ReadReshareExploreCopy	string	Uygulamadaki içeriğe Okuma, Yeniden Paylaşma, Keşfetme ve Kopyalama erişimi verir
ReadWrite	string	Uygulamadaki içeriğe Okuma ve Yazma erişimi verir
ReadWriteExplore	string	Uygulamadaki içeriğe Okuma, Yazma ve Keşfetme erişimi verir
ReadWriteExploreCopy	string	Uygulamadaki içeriğe Okuma, Yazma, Keşfetme ve Kopyalama erişimi verir
ReadWriteReshare	string	Uygulamadaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir
ReadWriteReshareExplore	string	Uygulamadaki içeriğe Okuma, Yazma, Yeniden Paylaşma ve Keşfetme erişimi verir

AppUsers

Uygulamaya erişimi olan Power BI kullanıcılarının listesi için OData yanıt sarmalayıcısı

Name	Tür	Description
odata.context	string
value	AppUser[]	Uygulamaya erişimi olan kullanıcıların listesi

PrincipalType

Asıl tür

Name	Tür	Description
App	string	Hizmet sorumlusu türü
Group	string	Grup sorumlusu türü
None	string	Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User	string	Kullanıcı asıl türü