Datasets - Post Dataset User In Group

Service:

Power BI REST APIs

API Version:

v1.0

Belirtilen kullanıcının belirtilen veri kümesine yönelik izinlerini verir.

Bir veri kümesine yönelik kullanıcı izinleri yakın zamanda güncelleştirildiğinde, yeni izinler API çağrıları aracılığıyla hemen kullanılamayabilir. Kullanıcı izinlerini yenilemek için Kullanıcı İzinlerini Yenile API çağrısını kullanın.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

• Hizmet sorumlularına (uygulama principalType) izin ekleme desteklenmez
• Çağıranın veri kümesinde ReadReshare izinlerine sahip olması gerekir.
• Bu API çağrısı, veri kümesi üzerinde veri kümesi yazma izni vermek için kullanılamaz
  
  

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği
groupId	path	True	string uuid	Çalışma alanı kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
datasetUserAccessRight	True	DatasetUserAccessRightEntry	Gereklidir. Kullanıcıya veri kümesi için erişim hakkı.
identifier	True	string	sorumlu türü Useriçin UPN'yi sağlayın. Aksi takdirde sorumlunun nesne kimliğini belirtin.
principalType	True	PrincipalType	Sorumlu türü

Yanıtlar

Name	Tür	Description
200 OK		Tamam

Örnekler

Example

Example for granting ReadExplore right to a security group

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:

200

Tanımlar

Name	Description
DatasetUserAccessRightEntry	Gereklidir. Kullanıcıya veri kümesi için erişim hakkı.
PostDatasetUserAccess	Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi
PrincipalType	Sorumlu türü

DatasetUserAccessRightEntry

Gereklidir. Kullanıcıya veri kümesi için erişim hakkı.

Name	Tür	Description
Read	string	Veri kümesindeki içeriğe Okuma erişimi verir
ReadExplore	string	Veri kümesindeki içeriğe Okuma ve Araştırma erişimi verir
ReadReshare	string	Veri kümesindeki içeriğe Okuma ve Yeniden Paylaşma erişimi verir
ReadReshareExplore	string	Veri kümesindeki içeriğe Okuma, Yeniden Paylaşma ve Araştırma erişimi verir

PostDatasetUserAccess

Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi

Name	Tür	Description
datasetUserAccessRight	DatasetUserAccessRightEntry	Gereklidir. Kullanıcıya veri kümesi için erişim hakkı.
identifier	string	sorumlu türü Useriçin UPN'yi sağlayın. Aksi takdirde sorumlunun nesne kimliğini belirtin.
principalType	PrincipalType	Sorumlu türü

PrincipalType

Sorumlu türü

Name	Tür	Description
App	string	Hizmet sorumlusu türü
Group	string	Grup sorumlusu türü
None	string	Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User	string	Kullanıcı asıl türü