Datasets - Get Dataset Users In Group

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Mengembalikan daftar prinsipal yang memiliki akses ke himpunan data yang ditentukan.

Ketika izin pengguna ke himpunan data baru-baru ini diperbarui, izin baru mungkin tidak segera tersedia melalui panggilan API. Untuk merefresh izin pengguna, gunakan panggilan REFRESH USER Permissions API.

Izin

Izin untuk panggilan API ini tercantum dalam izin Himpunan Data.

Cakupan yang Diperlukan

Dataset.Read.All atau Dataset.ReadWrite.All

Batasan

Pemanggil harus memiliki izin ReadWriteReshare pada himpunan data. Artinya, admin folder, anggota, dan kontributor dengan izin Reshare, atau pemilik himpunan data.

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

Parameter URI

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

Respons

Nama	Jenis	Deskripsi
200 OK	DatasetUsersAccess	OK

Contoh

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Sample Response

Status code:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

Definisi

Nama	Deskripsi
DatasetUserAccess	Entri akses utama Power BI untuk himpunan data
DatasetUserAccessRight	Hak akses yang dimiliki pengguna untuk himpunan data (tingkat izin)
DatasetUsersAccess	Pembungkus respons OData untuk daftar prinsipal Power BI dengan akses ke himpunan data
PrincipalType	Jenis utama

DatasetUserAccess

Entri akses utama Power BI untuk himpunan data

Nama	Jenis	Deskripsi
datasetUserAccessRight	DatasetUserAccessRight	Hak akses untuk ditetapkan kepada pengguna untuk himpunan data (tingkat izin)
identifier	string	Untuk jenis `User`utama , berikan UPN. Jika tidak, berikan ID objek dari prinsipal.
principalType	PrincipalType	Jenis utama

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

DatasetUsersAccess

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

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

Bagikan melalui