Bagikan melalui

Gateways - Add Datasource User

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
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

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Isi Permintaan
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Respon sampel

Kode status:
200

Example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Isi Permintaan
{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Respon sampel

Kode status:
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

Object

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

Enumeration

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

Nilai Deskripsi
None

Tidak ada izin untuk mengakses sumber data. Hanya berlaku saat memperbarui izin pengguna.
Read

Himpunan data yang dimiliki oleh pengguna telah membaca akses ke sumber data
ReadOverrideEffectiveIdentity

Pengguna dapat mengambil alih identitas yang efektif untuk Power BI Embedded. Hanya berlaku untuk sumber data Analysis Services lokal.

PrincipalType

Enumeration

Jenis utama

Nilai Deskripsi
App

Jenis perwakilan layanan
Group

Jenis prinsipal grup
None

Tidak ada jenis utama. Gunakan untuk akses tingkat seluruh organisasi.
User

Jenis prinsipal pengguna

ServicePrincipalProfile

Object

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