Admin - Groups GetGroupUsersAsAdmin

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

Belirtilen çalışma alanına 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 prinicipal 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/groups/{groupId}/users

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
groupId	path	True	string uuid	Çalışma alanı kimliği

Yanıtlar

Name	Tür	Description
200 OK	GroupUsers	Tamam

Örnekler

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Tanımlar

Name	Description
GroupUser	Çalışma alanına erişimi olan bir Power BI kullanıcısı
GroupUserAccessRight	Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
GroupUsers	Çalışma alanına erişimi olan Power BI kullanıcılarının listesi için OData yanıt sarmalayıcısı
PrincipalType	Sorumlu türü
ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

GroupUser

Çalışma alanına erişimi olan bir Power BI kullanıcısı

Name	Tür	Description
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.
groupUserAccessRight	GroupUserAccessRight	Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)
identifier	string	Sorumlunun tanımlayıcısı
principalType	PrincipalType	Sorumlu türü
profile	ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
userType	string	Kullanıcının türü.

GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)

Name	Tür	Description
Admin	string	Çalışma alanı içeriği için yönetici hakları
Contributor	string	Çalışma alanı içeriğine erişimi okuma ve keşfetme (ReadExplore)
Member	string	Çalışma alanı içeriğine erişim haklarını okuma, yeniden paylaşma ve keşfetme (ReadReshareExplore)
None	string	Çalışma alanı içeriğine erişim yok
Viewer	string	Çalışma alanı içeriğine salt okunur (Okuma) erişimi

GroupUsers

Çalışma alanına 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	GroupUser[]	Çalışma alanına erişimi olan kullanıcıların listesi

PrincipalType

Sorumlu 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ü

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

Name	Tür	Description
displayName	string	Hizmet sorumlusu profil adı
id	string	Hizmet sorumlusu profil kimliği