Bagikan melalui

Datasets - Post Dataset User

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
v1.0

Memberikan izin pengguna yang ditentukan ke himpunan data 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.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

Batasan

  • Menambahkan izin ke perwakilan layanan (app principalType) tidak didukung
  • Penelepon harus memiliki izin ReadReshare pada himpunan data.
  • Panggilan API ini tidak dapat digunakan untuk memberikan izin Tulis himpunan data pada himpunan data

POST 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

DatasetUserAccessRightEntry

Wajib diisi. Hak akses untuk diberikan kepada pengguna untuk himpunan data.
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 granting ReadExplore right to a security group

Example

Permintaan sampel

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

Respon sampel

Kode status:
200

Example for granting ReadExplore right to a security group

Permintaan sampel

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

Respon sampel

Kode status:
200

Definisi

Nama Deskripsi
DatasetUserAccessRightEntry

Wajib diisi. Hak akses untuk diberikan kepada pengguna untuk himpunan data.
PostDatasetUserAccess

Entri kanan akses pengguna Power BI untuk himpunan data
PrincipalType

Jenis utama

DatasetUserAccessRightEntry

Enumeration

Wajib diisi. Hak akses untuk diberikan kepada pengguna untuk himpunan data.

Nilai Deskripsi
Read

Memberikan akses Baca ke konten dalam himpunan data
ReadExplore

Memberikan akses Baca dan Jelajahi ke konten dalam himpunan data
ReadReshare

Memberikan akses Baca dan Buat Ulang ke konten dalam himpunan data
ReadReshareExplore

Memberikan akses Baca, Reshare, dan Jelajahi ke konten dalam himpunan data

PostDatasetUserAccess

Object

Entri kanan akses pengguna Power BI untuk himpunan data

Nama Jenis Deskripsi
datasetUserAccessRight

DatasetUserAccessRightEntry

Wajib diisi. Hak akses untuk diberikan kepada pengguna untuk himpunan data.
identifier

string

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

PrincipalType

Jenis utama

PrincipalType

Enumeration

Jenis utama

Nilai Deskripsi
App

Jenis perwakilan layanan
Group

Jenis prinsipal grup
None

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

Jenis prinsipal pengguna