Admin - Datasets GetDatasetUsersAsAdmin

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Mengembalikan daftar pengguna yang memiliki akses ke himpunan data 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.
Izin untuk panggilan API ini tercantum dalam izin Himpunan Data.

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/datasets/{datasetId}/users

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string uuid	ID himpunan data

Respons

Nama	Jenis	Deskripsi
200 OK	DatasetUsers	OK

Contoh

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/users

Sample Response

Status code:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "datasetUserAccessRight": "ReadWriteReshareExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definisi

Nama	Deskripsi
DatasetUser	Entri kanan akses pengguna Power BI untuk himpunan data
DatasetUserAccessRight	Hak akses yang dimiliki pengguna untuk himpunan data (tingkat izin)
DatasetUsers	Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke himpunan data
PrincipalType	Jenis utama
ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

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

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

DatasetUsers

Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke himpunan data

Nama	Jenis	Deskripsi
odata.context	string
value	DatasetUser[]	Daftar pengguna dengan akses ke himpunan 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

Bagikan melalui