Gateways - Add Datasource User

Service:

Power BI REST APIs

API Version:

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öneticisi 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. Böyle 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 hizmeti asıl 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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Example

Sample Request

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

Request Body

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

Sample Response

Status code:

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

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