Bagikan melalui

Datasets - Put Dataset User

  • Referensi
Service:
Power BI REST APIs
API Version:
v1.0

Updates izin himpunan data yang ada dari pengguna yang ditentukan ke izin yang ditentukan.

Saat 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. Panggilan API ini dapat digunakan untuk menghapus semua izin himpunan data pengguna yang ditentukan dengan menggunakan datasetUserAccessRight: None

Cakupan yang Diperlukan

Dataset.ReadWrite.All

Izin

Izin untuk panggilan API ini tercantum dalam izin Himpunan Data.

Batasan

  • Memperbarui izin ke perwakilan layanan (app principalType) tidak didukung
  • Penelepon harus memiliki izin ReadWriteReshare pada himpunan data. Artinya, admin folder, anggota, dan kontributor dengan izin Reshare, atau pemilik himpunan data.
  • API ini tidak dapat digunakan untuk menambahkan atau menghapus izin tulis .
  • API ini tidak dapat digunakan untuk menghapus izin yang diwariskan tingkat folder. Untuk admin dan anggota folder, izin ReadWriteReshareExplore pada himpunan data folder diwariskan. Untuk kontributor folder, izin ReadWriteExplore pada himpunan data folder diwariskan. Untuk penampil folder, izin Baca pada himpunan data folder diwariskan. 

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
 path True

string

ID himpunan data

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
datasetUserAccessRight True

DatasetUserAccessRight

Hak akses untuk ditetapkan kepada pengguna untuk himpunan data (tingkat izin)
identifier True

string

Untuk jenis Userutama , berikan UPN. Jika tidak, berikan ID objek utama.
principalType True

PrincipalType

Jenis utama

Respons

Nama Jenis Deskripsi
200 OK

OK

Contoh

Example
Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Request Body
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:
200

Example for updating security group dataset permissions to ReadExplore

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Request Body
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:
200

Definisi

Nama Deskripsi
DatasetUserAccess

Entri kanan akses utama Power BI untuk himpunan data
DatasetUserAccessRight

Hak akses yang dimiliki pengguna untuk himpunan data (tingkat izin)
PrincipalType

Jenis utama

DatasetUserAccess

Entri kanan 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 Userutama , berikan UPN. Jika tidak, berikan ID objek utama.
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 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

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