Gateways - Add Datasource User

Service:

Power BI REST APIs

API Version:

v1.0

Memberikan atau memperbarui izin yang diperlukan untuk menggunakan sumber data yang ditentukan untuk pengguna yang ditentukan.

Izin

Pengguna harus memiliki izin admin gateway.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

Batasan

Gateway jaringan virtual (VNet) tidak didukung. Menambahkan grup melalui API tidak didukung.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasourceId	path	True	string uuid	ID sumber data
gatewayId	path	True	string uuid	ID gateway. Saat menggunakan kluster gateway, ID gateway mengacu pada gateway utama (pertama) di kluster. Dalam kasus seperti itu, ID gateway mirip dengan ID kluster gateway.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
datasourceAccessRight	True	DatasourceUserAccessRight	Hak akses (tingkat izin) yang dimiliki pengguna pada sumber data
displayName		string	Nama tampilan prinsipal
emailAddress		string	Alamat email pengguna
identifier		string	ID objek dari prinsipal
principalType		PrincipalType	Jenis utama
profile		ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

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

Definisi

Nama	Deskripsi
DatasourceUser	Pengguna Power BI dengan akses ke sumber data
DatasourceUserAccessRight	Hak akses (tingkat izin) yang dimiliki pengguna pada sumber data
PrincipalType	Jenis utama
ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

DatasourceUser

Pengguna Power BI dengan akses ke sumber data

Nama	Jenis	Deskripsi
datasourceAccessRight	DatasourceUserAccessRight	Hak akses (tingkat izin) yang dimiliki pengguna pada sumber data
displayName	string	Nama tampilan prinsipal
emailAddress	string	Alamat email pengguna
identifier	string	ID objek dari prinsipal
principalType	PrincipalType	Jenis utama
profile	ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

DatasourceUserAccessRight

Hak akses (tingkat izin) yang dimiliki pengguna pada sumber data

Nama	Jenis	Deskripsi
None	string	Tidak ada izin untuk mengakses sumber data. Hanya berlaku saat memperbarui izin pengguna.
Read	string	Himpunan data yang dimiliki oleh pengguna telah membaca akses ke sumber data
ReadOverrideEffectiveIdentity	string	Pengguna dapat mengambil alih identitas yang efektif untuk Power BI Embedded. Hanya berlaku untuk sumber data Analysis Services lokal.

PrincipalType

Jenis utama

Nama	Jenis	Deskripsi
App	string	Jenis perwakilan layanan
Group	string	Jenis prinsipal grup
None	string	Tidak ada jenis utama. Gunakan untuk akses tingkat seluruh organisasi.
User	string	Jenis prinsipal pengguna

ServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

Nama	Jenis	Deskripsi
displayName	string	Nama profil perwakilan layanan
id	string	ID profil perwakilan layanan