Share via

Admin - Imports GetImportsAsAdmin

  • Referensi
Service:
Power BI REST APIs
API Version:
v1.0

Mengembalikan daftar impor 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.

Batasan

Maksimum 200 permintaan per jam. 

GET https://api.powerbi.com/v1.0/myorg/admin/imports
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/imports?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
$expand
 query

string

Memperluas entitas terkait sebaris
$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

Imports

OK

Contoh

Example

Sample Request

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

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "importState": "Succeeded",
      "createdDateTime": "2018-05-08T14:56:18.477Z",
      "updatedDateTime": "2018-05-08T14:56:18.477Z",
      "name": "SalesMarketing",
      "connectionType": "import",
      "source": "Upload",
      "datasets": [
        {
          "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "name": "SalesMarketing",
          "webUrl": "https://app.powerbi.com/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229"
        }
      ],
      "reports": [
        {
          "id": "5b218778-e7a5-4d73-8187-f10824047715",
          "name": "SalesMarketing",
          "webUrl": "https://app.powerbi.com/reports/5b218778-e7a5-4d73-8187-f10824047715",
          "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715"
        }
      ]
    }
  ]
}

Definisi

Nama Deskripsi
Dataset

Himpunan data Power BI. API mengembalikan subset dari daftar properti himpunan data berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI.
DatasetQueryScaleOutSettings

Pengaturan peluasan skala kueri himpunan data
DatasetUser

Entri kanan akses pengguna Power BI untuk himpunan data
DatasetUserAccessRight

Hak akses yang dimiliki pengguna untuk himpunan data (tingkat izin)
DependentDataflow

Aliran data dependen Power BI
Encryption

Informasi enkripsi untuk himpunan data
EncryptionStatus

Status enkripsi himpunan data
Import

Objek impor
Imports

Pembungkus respons OData untuk koleksi impor Power BI
PrincipalType

Jenis utama
Report

Laporan Power BI. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang disebut, izin penelepon, dan ketersediaan data dalam database Power BI.
ReportUser

Entri kanan akses pengguna Power BI untuk laporan
ReportUserAccessRight

Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)
ServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.
Subscription

Langganan email untuk item Power BI (seperti laporan atau dasbor)
SubscriptionUser

Pengguna langganan email Power BI

Dataset

Himpunan data Power BI. API mengembalikan subset dari daftar properti himpunan data berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI.

Nama Jenis Deskripsi
ContentProviderType

string

Jenis penyedia konten untuk himpunan data
CreateReportEmbedURL

string

URL semat laporan pembuatan himpunan data
CreatedDate

string

Tanggal dan waktu pembuatan himpunan data
Encryption

Encryption

Informasi enkripsi himpunan data. Hanya berlaku ketika $expand ditentukan.
IsEffectiveIdentityRequired

boolean

Apakah himpunan data memerlukan identitas yang efektif, yang harus Anda kirim dalam panggilan GENERATEToken API.
IsEffectiveIdentityRolesRequired

boolean

Apakah keamanan tingkat baris ditentukan di dalam file .pbix Power BI. Jika demikian, Anda harus menentukan peran.
IsInPlaceSharingEnabled

boolean

Apakah himpunan data dapat dibagikan dengan pengguna eksternal untuk dikonsumsi di penyewa mereka sendiri
IsOnPremGatewayRequired

boolean

Apakah himpunan data memerlukan gateway data lokal
IsRefreshable

boolean

Apakah himpunan data dapat disegarkan atau tidak. Himpunan data yang dapat disegarkan Power BI adalah himpunan data yang telah di-refresh setidaknya sekali, atau di mana jadwal refresh yang valid ada.
QnaEmbedURL

string

Himpunan data Q&URL semat
addRowsAPIEnabled

boolean

Apakah himpunan data memungkinkan penambahan baris baru
configuredBy

string

Pemilik himpunan data
description

string

Deskripsi himpunan data
id

string

ID himpunan data
name

string

Nama himpunan data
queryScaleOutSettings

DatasetQueryScaleOutSettings

Pengaturan peluasan skala kueri himpunan data
targetStorageMode

string

Mode penyimpanan himpunan data
upstreamDataflows

DependentDataflow[]

Daftar semua aliran data yang bergantung pada item ini
users

DatasetUser[]

(Nilai kosong) Detail akses pengguna himpunan data. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna tentang item Power BI (seperti laporan atau dasbor) dengan menggunakan Get Dataset Users as Admin API, atau PostWorkspaceInfo API dengan getArtifactUsers parameter .
webUrl

string

URL web himpunan data

DatasetQueryScaleOutSettings

Pengaturan peluasan skala kueri himpunan data

Nama Jenis Deskripsi
autoSyncReadOnlyReplicas

boolean

Apakah himpunan data secara otomatis menyinkronkan replika baca-saja
maxReadOnlyReplicas

integer

Jumlah maksimum replika baca-saja untuk himpunan data (0-64, -1 untuk jumlah replika otomatis)

DatasetUser

Entri kanan akses pengguna Power BI untuk himpunan data

Nama Jenis Deskripsi
datasetUserAccessRight

DatasetUserAccessRight

Hak akses yang dimiliki pengguna untuk himpunan 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 prinsipal
principalType

PrincipalType

Jenis utama
profile

ServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.
userType

string

Jenis pengguna.

DatasetUserAccessRight

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

Nama Jenis Deskripsi
None

string

Menghapus izin ke konten dalam himpunan data
Read

string

Memberikan akses Baca ke konten dalam himpunan data
ReadExplore

string

Memberikan akses Baca dan Jelajahi ke konten dalam himpunan data
ReadReshare

string

Memberikan akses Baca dan Reshare ke konten dalam himpunan data
ReadReshareExplore

string

Memberikan akses Baca, Reshare, dan Jelajahi ke konten dalam himpunan data
ReadWrite

string

Memberikan akses Baca dan Tulis ke konten dalam himpunan data
ReadWriteExplore

string

Memberikan akses Baca, Tulis, dan Jelajahi ke konten dalam himpunan data
ReadWriteReshare

string

Memberikan akses Baca, Tulis, dan Reshare ke konten dalam himpunan data
ReadWriteReshareExplore

string

Memberikan akses Baca, Tulis, Reshare, dan Jelajahi konten dalam himpunan data

DependentDataflow

Aliran data dependen Power BI

Nama Jenis Deskripsi
groupId

string

ID grup target
targetDataflowId

string

ID aliran data target

Encryption

Informasi enkripsi untuk himpunan data

Nama Jenis Deskripsi
EncryptionStatus

EncryptionStatus

Status enkripsi himpunan data

EncryptionStatus

Status enkripsi himpunan data

Nama Jenis Deskripsi
InSyncWithWorkspace

string

Enkripsi didukung dan sinkron dengan pengaturan enkripsi
NotInSyncWithWorkspace

string

Enkripsi didukung tetapi tidak sinkron dengan pengaturan enkripsi
NotSupported

string

Enkripsi tidak didukung untuk himpunan data ini
Unknown

string

Status enkripsi tidak diketahui karena kerusakan himpunan data

Import

Objek impor

Nama Jenis Deskripsi
createdDateTime

string

Impor tanggal dan waktu pembuatan
datasets

Dataset[]

Himpunan data yang terkait dengan impor ini
id

string

ID impor
importState enum:
  • Failed
  • Publishing
  • Succeeded

Status unggahan impor
name

string

Nama impor
reports

Report[]

Laporan yang terkait dengan impor ini
updatedDateTime

string

Impor tanggal dan waktu pembaruan terakhir

Imports

Pembungkus respons OData untuk koleksi impor Power BI

Nama Jenis Deskripsi
odata.context

string

Konteks OData
value

Import[]

Kumpulan impor

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

Report

Laporan Power BI. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang disebut, izin penelepon, dan ketersediaan data dalam database Power BI.

Nama Jenis Deskripsi
appId

string

ID aplikasi, dikembalikan hanya jika laporan milik aplikasi
datasetId

string

ID himpunan data laporan
description

string

Deskripsi laporan
embedUrl

string

URL laporan yang disematkan
id

string

ID laporan
isOwnedByMe

boolean

Tentukan apakah laporan dibuat oleh pengguna saat ini.
name

string

Nama laporan
originalReportId

string

ID laporan aktual saat ruang kerja diterbitkan sebagai aplikasi.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Jenis laporan
subscriptions

Subscription[]

(Nilai Kosong) Detail langganan untuk item Power BI (seperti laporan atau dasbor). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda bisa mengambil informasi langganan untuk laporan Power BI dengan menggunakan Langganan Dapatkan Laporan sebagai panggilan API Admin.
users

ReportUser[]

(Nilai kosong) Detail akses pengguna untuk laporan Power BI. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna pada laporan Power BI dengan menggunakan panggilan Get Report Users as Admin API, atau panggilan API PostWorkspaceInfo dengan getArtifactUsers parameter .
webUrl

string

URL web laporan

ReportUser

Entri kanan akses pengguna Power BI untuk laporan

Nama Jenis Deskripsi
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 prinsipal
principalType

PrincipalType

Jenis utama
profile

ServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.
reportUserAccessRight

ReportUserAccessRight

Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)
userType

string

Jenis pengguna.

ReportUserAccessRight

Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)

Nama Jenis Deskripsi
None

string

Tidak ada izin untuk konten dalam laporan
Owner

string

Memberikan akses Baca, Tulis, dan Buat Ulang ke konten dalam laporan
Read

string

Memberikan akses Baca ke konten dalam laporan
ReadCopy

string

Memberikan akses Baca dan Salin ke konten dalam laporan
ReadReshare

string

Memberikan akses Baca dan Buat Ulang ke konten dalam laporan
ReadWrite

string

Memberikan akses Baca dan Tulis ke konten dalam laporan

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

Subscription

Langganan email untuk item Power BI (seperti laporan atau dasbor)

Nama Jenis Deskripsi
artifactDisplayName

string

Nama item Power BI langganan (seperti laporan atau dasbor)
artifactId

string

ID item Power BI langganan (seperti laporan atau dasbor)
artifactType

string

Jenis item Power BI (misalnya Report, , Dashboardatau Dataset)
attachmentFormat

string

Format laporan yang dilampirkan dalam langganan email
endDate

string

Tanggal dan waktu akhir langganan email
frequency

string

Frekuensi langganan email
id

string

ID langganan
isEnabled

boolean

Apakah langganan email diaktifkan
linkToContent

boolean

Apakah tautan langganan ada di langganan email
previewImage

boolean

Apakah cuplikan layar laporan ada di langganan email
startDate

string

Tanggal dan waktu mulai langganan email
subArtifactDisplayName

string

Nama halaman item Power BI langganan, jika itu adalah laporan.
title

string

Nama aplikasi
users

SubscriptionUser[]

Detail setiap pelanggan email. Saat menggunakan panggilan Get User Subscriptions As Admin API, nilai yang dikembalikan adalah array kosong (null). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi langganan pada laporan atau dasbor Power BI dengan menggunakan panggilan Dapatkan Langganan Laporan Sebagai Admin atau Dapatkan Langganan Dasbor Sebagai Admin API.

SubscriptionUser

Pengguna langganan email Power BI

Nama Jenis Deskripsi
displayName

string

Nama tampilan utama
emailAddress

string

Alamat email pengguna
graphId

string

Pengidentifikasi utama di 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.