Admin - Dataflows GetDataflowsAsAdmin

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}

Parameter URI

Nama	Dalam	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	AdminDataflows	OK

Contoh

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

Sample Response

Status code:: 200

{
  "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
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.
AdminDataflows	Pembungkus respons OData untuk kumpulan aliran data Admin Power BI
DataflowUser	Entri kanan akses pengguna Power BI untuk aliran data
DataflowUserAccessRight	Hak akses yang dimiliki pengguna untuk aliran data (tingkat izin)
PrincipalType	Jenis utama
ServicePrincipalProfile	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	DataflowUser[]	(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 `getArtifactUser` parameter .
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	AdminDataflow[]	Kumpulan laporan

DataflowUser

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 utama
emailAddress	string	Alamat email pengguna
graphId	string	Pengidentifikasi utama dalam Microsoft Graph. Hanya tersedia untuk API admin.
identifier	string	Pengidentifikasi utama
principalType	PrincipalType	Jenis utama
profile	ServicePrincipalProfile	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

Share via