Admin - Dataflows GetDataflowUsersAsAdmin

Layanan:: Power BI REST APIs

Versi API:: v1.0

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

Permissions

Pengguna harus menjadi administrator Fabric atau mengautentikasi menggunakan perwakilan layanan.
Izin yang didelegasikan didukung.

Saat berjalan di bawah autentikasi perwakilan layanan, aplikasi tidak boleh memiliki izin admin yang diperlukan untuk Power BI yang diatur di portal Microsoft Azure.

Cakupan yang Diperlukan

Tenant.Read.All atau Tenant.ReadWrite.All

Hanya relevan saat mengautentikasi melalui token akses admin yang didelegasikan standar. Tidak boleh ada saat autentikasi melalui perwakilan layanan digunakan.

Keterbatasan

Maksimum 200 permintaan per jam.

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
dataflowId	path	True	string (uuid)	ID aliran data

Respons

Nama	Jenis	Deskripsi
200 OK	DataflowUsers	OK

Contoh

Example

Permintaan sampel

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "dataflowUserAccessRight": "ReadWrite",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definisi

Nama	Deskripsi
DataflowUser	Entri kanan akses pengguna Power BI untuk aliran data
DataflowUserAccessRight	Hak akses yang dimiliki pengguna untuk aliran data (tingkat izin)
DataflowUsers	Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke aliran data
PrincipalType	Jenis utama
ServicePrincipalProfile	Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

DataflowUser

Objek

Entri kanan akses pengguna Power BI untuk aliran data

Nama	Jenis	Deskripsi
DataflowUserAccessRight	DataflowUserAccessRight	Hak akses yang dimiliki pengguna untuk aliran data (tingkat izin)
displayName	string	Nama tampilan prinsipal
emailAddress	string	Alamat email pengguna
graphId	string	Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin.
identifier	string	Pengidentifikasi utama
principalType	PrincipalType	Jenis utama
profile	ServicePrincipalProfile	Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.
userType	string	Jenis pengguna.

DataflowUserAccessRight

Enumeration

Hak akses yang dimiliki pengguna untuk aliran data (tingkat izin)

Nilai	Deskripsi
None	Menghapus izin ke konten dalam aliran data
Read	Memberikan akses Baca ke konten dalam aliran data
ReadWrite	Memberikan akses Baca dan Tulis ke konten dalam aliran data
ReadReshare	Memberikan akses Baca dan Buat Ulang ke konten dalam aliran data
Owner	Memberikan akses Baca, Tulis, dan Reshare ke konten dalam aliran data

DataflowUsers

Objek

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

Nama	Jenis	Deskripsi
@odata.context	string
value	DataflowUser[]	Daftar pengguna dengan akses ke aliran 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