Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

Belirtilen kullanıcının belirtilen veri kümesine 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 izin ekleme (uygulama principalType) 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/datasets/{datasetId}/users

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
datasetUserAccessRight	True	DatasetUserAccessRightEntry	Gereklidir. Veri kümesi için kullanıcıya verme erişim hakkı.
identifier	True	string	asıl türü Useriçin UPN'yi sağlayın. Aksi takdirde sorumlunun nesne kimliğini belirtin.
principalType	True	PrincipalType	Asıl 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/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

Tanımlar

Name	Description
DatasetUserAccessRightEntry	Gereklidir. Veri kümesi için kullanıcıya verme erişim hakkı.
PostDatasetUserAccess	Power BI kullanıcısı bir veri kümesi için doğru erişime sahip giriş
PrincipalType	Asıl tür

DatasetUserAccessRightEntry

Gereklidir. Veri kümesi için kullanıcıya verme 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 Keşfetme erişimi verir

PostDatasetUserAccess

Power BI kullanıcısı bir veri kümesi için doğru erişime sahip giriş

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

PrincipalType

Asıl 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ü