Aracılığıyla paylaş

Gateways - Add Datasource User

  • Başvuru
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ö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

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

DatasourceUserAccessRight

Enumeration

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ümelerinin veri kaynağına okuma erişimi vardır
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

Enumeration

Asıl tür

Değer Description
App

Hizmet sorumlusu türü
Group

Grup sorumlusu türü
None

Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User

Kullanıcı asıl türü

ServicePrincipalProfile

Object

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