Gateways - Get Datasource Users

Layanan:

Power BI REST APIs

Versi API:

v1.0

Mengembalikan daftar pengguna yang memiliki akses ke sumber data yang ditentukan.

Permissions

Pengguna harus memiliki izin admin gateway.

Cakupan yang Diperlukan

Dataset.ReadWrite.All atau Dataset.Read.All

Keterbatasan

Gateway jaringan virtual (VNet) tidak didukung.

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

Respons

Nama	Jenis	Deskripsi
200 OK	DatasourceUsers	OK

Contoh

Example

Permintaan sampel

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

Respon sampel

Kode status:

200

{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definisi

Nama	Deskripsi
DatasourceUser	Pengguna Power BI dengan akses ke sumber data
DatasourceUserAccessRight	Hak akses (tingkat izin) yang dimiliki pengguna pada sumber data
DatasourceUsers	Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke sumber data
PrincipalType	Jenis utama
ServicePrincipalProfile	Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

DatasourceUser

Objek

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 perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa 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 efektif untuk Power BI Embedded. Hanya berlaku untuk sumber data Analysis Services lokal.

DatasourceUsers

Objek

Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke sumber data

Nama	Jenis	Deskripsi
@odata.context	string
value	DatasourceUser[]	Daftar pengguna dengan akses ke sumber data

PrincipalType

Enumeration

Jenis utama

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

ServicePrincipalProfile

Objek

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

Nama	Jenis	Deskripsi
displayName	string	Nama profil perwakilan layanan
id	string (uuid)	ID profil perwakilan layanan