Gateways - Get Datasource Users

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

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

İzinler

Kullanıcının ağ geçidi yöneticisi 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. Böyle 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

Sample Request

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

Sample Response

Status code:: 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 hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

DatasourceUser

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 hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

DatasourceUserAccessRight

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

Name	Tür	Description
None	string	Veri kaynağına erişim izni yok. Yalnızca kullanıcı izinleri güncelleştirilirken geçerlidir.
Read	string	Kullanıcıya ait veri kümelerinin veri kaynağına okuma erişimi vardır
ReadOverrideEffectiveIdentity	string	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

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

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ü

ServicePrincipalProfile

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

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

Share via