Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

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

Sample Request

POST 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 granting ReadExplore right to a security group

Sample Request

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

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

Nama	Jenis	Deskripsi
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

PostDatasetUserAccess

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

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