Bagikan melalui


Admin - Datasets GetDatasetsAsAdmin

Mengembalikan daftar himpunan 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 standar yang didelegasikan. Tidak boleh ada ketika autentikasi melalui perwakilan layanan digunakan.

Batasan

Maksimum 50 permintaan per jam atau 5 permintaan per menit, per penyewa.

GET https://api.powerbi.com/v1.0/myorg/admin/datasets
GET https://api.powerbi.com/v1.0/myorg/admin/datasets?$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

Melewati hasil n pertama

$top
query

integer

int32

Hanya mengembalikan hasil n pertama

Respons

Nama Jenis Deskripsi
200 OK

AdminDatasets

OK

Contoh

Example

Sample Request

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

Sample Response

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false,
      "isInPlaceSharingEnabled": false,
      "workspaceId": "5c968528-70b6-4588-809f-ce811ffa5c23"
    }
  ]
}

Definisi

Nama Deskripsi
AdminDataset

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

AdminDatasets

Pembungkus daftar odata himpunan data

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

PrincipalType

Jenis utama

ServicePrincipalProfile

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

AdminDataset

Himpunan data Power BI yang dikembalikan oleh API Admin. 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

workspaceId

string

ID ruang kerja himpunan data. Properti ini hanya akan dikembalikan di GetDatasetsAsAdmin.

AdminDatasets

Pembungkus daftar odata himpunan data

Nama Jenis Deskripsi
odata.context

string

Konteks OData

value

AdminDataset[]

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

PrincipalType

Jenis utama

Nama Jenis Deskripsi
App

string

Jenis perwakilan layanan

Group

string

Jenis utama grup

None

string

Tidak ada jenis utama. Gunakan untuk seluruh akses tingkat organisasi.

User

string

Jenis prinsipal pengguna

ServicePrincipalProfile

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

Nama Jenis Deskripsi
displayName

string

Nama profil perwakilan layanan

id

string

ID profil perwakilan layanan