Admin - Dataflows GetDataflowsAsAdmin
Mengembalikan daftar aliran data untuk organisasi.
Izin
- Pengguna harus memiliki hak administrator (seperti Office 365 Administrator Global atau Administrator Layanan Power BI) 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 dalam portal 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.
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
$filter
|
query |
string |
Memfilter hasil, berdasarkan kondisi boolean |
|
$skip
|
query |
integer int32 |
Melompati hasil n pertama |
|
$top
|
query |
integer int32 |
Mengembalikan hanya hasil n pertama |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
Contoh
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows
Sample Response
{
"value": [
{
"objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
"name": "AdventureWorks",
"description": "Our Adventure Works",
"modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json",
"configuredBy": "john@contoso.com",
"workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Admin |
Metadata aliran data yang dikembalikan oleh API Admin. Di bawah ini adalah daftar properti yang mungkin dikembalikan untuk aliran data. Hanya subset properti yang akan dikembalikan tergantung pada API yang dipanggil, izin pemanggil, dan ketersediaan data dalam database Power BI. |
Admin |
Pembungkus respons OData untuk kumpulan aliran data Admin Power BI |
Dataflow |
Entri kanan akses pengguna Power BI untuk aliran data |
Dataflow |
Hak akses yang dimiliki pengguna untuk aliran data (tingkat izin) |
Principal |
Jenis utama |
Service |
Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded. |
AdminDataflow
Metadata aliran data yang dikembalikan oleh API Admin. Di bawah ini adalah daftar properti yang mungkin dikembalikan untuk aliran data. Hanya subset properti yang akan dikembalikan tergantung pada API yang dipanggil, izin pemanggil, dan ketersediaan data dalam database Power BI.
Nama | Jenis | Deskripsi |
---|---|---|
configuredBy |
string |
Pemilik aliran data |
description |
string |
Deskripsi aliran data |
modelUrl |
string |
URL ke file definisi aliran data (model.json) |
modifiedBy |
string |
Pengguna yang memodifikasi aliran data |
modifiedDateTime |
string |
Tanggal dan waktu aliran data terakhir diubah |
name |
string |
Nama aliran data |
objectId |
string |
ID aliran data |
users |
(Nilai kosong) Detail akses pengguna aliran data. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna pada aliran data Power BI dengan menggunakan Dapatkan Pengguna Aliran Data sebagai panggilan API Admin, atau panggilan API PostWorkspaceInfo dengan |
|
workspaceId |
string |
ID ruang kerja aliran data. |
AdminDataflows
Pembungkus respons OData untuk kumpulan aliran data Admin Power BI
Nama | Jenis | Deskripsi |
---|---|---|
odata.context |
string |
Konteks OData |
value |
Kumpulan laporan |
DataflowUser
Entri kanan akses pengguna Power BI untuk aliran data
Nama | Jenis | Deskripsi |
---|---|---|
DataflowUserAccessRight |
Hak akses yang dimiliki pengguna untuk aliran data (tingkat izin) |
|
displayName |
string |
Nama tampilan utama |
emailAddress |
string |
Alamat email pengguna |
graphId |
string |
Pengidentifikasi utama dalam Microsoft Graph. Hanya tersedia untuk API admin. |
identifier |
string |
Pengidentifikasi utama |
principalType |
Jenis utama |
|
profile |
Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded. |
|
userType |
string |
Jenis pengguna. |
DataflowUserAccessRight
Hak akses yang dimiliki pengguna untuk aliran data (tingkat izin)
Nama | Jenis | Deskripsi |
---|---|---|
None |
string |
Menghapus izin ke konten dalam aliran data |
Owner |
string |
Memberikan akses Baca, Tulis, dan Buat Ulang ke konten dalam aliran data |
Read |
string |
Memberikan akses Baca ke konten dalam aliran data |
ReadReshare |
string |
Memberikan akses Baca dan Buat Ulang ke konten dalam aliran data |
ReadWrite |
string |
Memberikan akses Baca dan Tulis ke konten dalam aliran 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 |