Gateways - Get Datasource Users

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

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

Izin

Pengguna harus memiliki izin admin gateway.

Cakupan yang Diperlukan

Dataset.ReadWrite.All atau Dataset.Read.All

Batasan

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

Sample Request

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

Sample Response

Status code:: 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 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.

DatasourceUsers

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

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

Bagikan melalui