Admin - Datasets GetDatasetsInGroupAsAdmin

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Mengembalikan daftar himpunan data dari ruang kerja yang ditentukan.

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 200 permintaan per jam.

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets

With optional parameters:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
groupId	path	True	string uuid	ID ruang kerja
$expand	query		string	Memperluas entitas terkait sebaris
$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

Example with expand on encryption

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets

Sample Response

Status code:: 200

{
  "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
    }
  ]
}

Example with expand on encryption

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets?$expand=encryption

Sample Response

Status code:: 200

{
  "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,
      "encryption": {
        "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
        "encryptionStatus": "InSyncWithWorkspace"
      }
    }
  ]
}

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

Share via

Admin - Datasets GetDatasetsInGroupAsAdmin

Izin

Cakupan yang Diperlukan

Batasan

Parameter URI

Respons

Contoh

Example

Sample Request

Sample Response

Example with expand on encryption

Sample Request

Sample Response

Definisi

AdminDataset

AdminDatasets

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

PrincipalType

ServicePrincipalProfile

Sumber Daya Tambahan: