Bagikan melalui


Admin - Imports GetImportsAsAdmin

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
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

{
  "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.