Gateways - Get Datasource Users

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

Belirtilen veri kaynağına erişimi olan kullanıcıların listesini döndürür.

Permissions

Kullanıcının ağ geçidi yönetici izinlerine sahip olması gerekir.

Gerekli Kapsam

Dataset.ReadWrite.All veya Dataset.Read.All

Sınırlamalar

Sanal ağ (VNet) ağ geçitleri desteklenmez.

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasourceId	path	True	string (uuid)	Veri kaynağı kimliği
gatewayId	path	True	string (uuid)	Ağ geçidi kimliği. Ağ geçidi kümesi kullanılırken, ağ geçidi kimliği kümedeki birincil (ilk) ağ geçidine başvurur. Bu gibi durumlarda ağ geçidi kimliği, ağ geçidi küme kimliğine benzer.

Yanıtlar

Name	Tür	Description
200 OK	DatasourceUsers	Tamam

Örnekler

Example

Örnek isteği

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Örnek yanıt

Durum kodu:

200

{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Tanımlar

Name	Description
DatasourceUser	Veri kaynağına erişimi olan bir Power BI kullanıcısı
DatasourceUserAccessRight	Kullanıcının veri kaynağında sahip olduğu erişim hakkı (izin düzeyi)
DatasourceUsers	Veri kaynağına erişimi olan Power BI kullanıcılarının listesi için OData yanıt sarmalayıcısı
PrincipalType	Asıl tür
ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çoklu kiracı çözümü için geçerlidir.

DatasourceUser

Object

Veri kaynağına erişimi olan bir Power BI kullanıcısı

Name	Tür	Description
datasourceAccessRight	DatasourceUserAccessRight	Kullanıcının veri kaynağında sahip olduğu erişim hakkı (izin düzeyi)
displayName	string	Sorumlunun görünen adı
emailAddress	string	Kullanıcının e-posta adresi
identifier	string	Sorumlunun nesne kimliği
principalType	PrincipalType	Asıl tür
profile	ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çoklu kiracı çözümü için geçerlidir.

DatasourceUserAccessRight

Listeleme

Kullanıcının veri kaynağında sahip olduğu erişim hakkı (izin düzeyi)

Değer	Description
None	Veri kaynağına erişim izni yok. Yalnızca kullanıcı izinleri güncelleştirilirken geçerlidir.
Read	Kullanıcıya ait veri kümeleri veri kaynağına okuma erişimine sahiptir
ReadOverrideEffectiveIdentity	Kullanıcı, Power BI Embedded için geçerli kimliği geçersiz kılabilir. Yalnızca şirket içi Analysis Services veri kaynakları için geçerlidir.

DatasourceUsers

Object

Veri kaynağı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	DatasourceUser[]	Veri kaynağına erişimi olan kullanıcıların listesi

PrincipalType

Listeleme

Asıl tür

Değer	Description
None	Sorumlu türü yok. Kuruluş düzeyinde erişimin tamamı için kullanın.
User	Kullanıcı asıl türü
Group	Grup sorumlusu türü
App	Hizmet sorumlusu türü

ServicePrincipalProfile

Object

Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çoklu kiracı çözümü için geçerlidir.

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