Gateways - Add Datasource User

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

Belirtilen kullanıcı için belirtilen veri kaynağını kullanmak için gereken izinleri verir veya güncelleştirir.

İzinler

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

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

Sanal ağ (VNet) ağ geçitleri desteklenmez. API aracılığıyla grup ekleme desteklenmez.

POST 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.

İstek Gövdesi

Name	Gerekli	Tür	Description
datasourceAccessRight	True	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 çok kiracılı çözümüiçin geçerlidir.

Yanıtlar

Name	Tür	Description
200 OK		Tamam

Örnekler

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Örnek isteği

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

İstek Gövdesi

{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Örnek yanıt

Durum kodu:

200

Example

Örnek isteği

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

İstek Gövdesi

{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Örnek yanıt

Durum kodu:

200

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)
PrincipalType	Asıl tür
ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çö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 çok kiracılı çö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.

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 çok kiracılı çözümüiçin geçerlidir.

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