Aracılığıyla paylaş

Datasets - Put Dataset User

  • Başvuru
Hizmet:
Power BI REST APIs
API Sürümü:
v1.0

Belirtilen kullanıcının mevcut veri kümesi izinlerini belirtilen izinlere Güncelleştirmeler.

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. Bu API çağrısı, kullanarak belirtilen kullanıcının tüm veri kümesi izinlerini kaldırmak için kullanılabilir datasetUserAccessRight: None

Gerekli Kapsam

Dataset.ReadWrite.All

İzinler

Bu API çağrısının izinleri Veri kümeleri izinleri bölümünde listelenmiştir.

Sınırlamalar

  • Hizmet sorumlularına (uygulama principalType) yönelik izinlerin güncelleştirilmesi desteklenmiyor
  • Çağıranın veri kümesinde ReadWriteReshare izinleri olmalıdır. Başka bir ifadeyle, klasör yöneticileri, yeniden paylaşma izinlerine sahip üyeler ve katkıda bulunanlar veya veri kümesi sahipleri.
  • Bu API yazma izni eklemek veya kaldırmak için kullanılamaz.
  • Bu API, klasör düzeyinde devralınan izinleri kaldırmak için kullanılamaz. Klasör yöneticileri ve üyeler için klasörün veri kümelerindeki ReadWriteReshareExplore izni devralınır. Klasöre katkıda bulunanlar için klasörün veri kümelerindeki ReadWriteExplore izni devralınır. Klasör görüntüleyicileri için, klasörün veri kümelerindeki Okuma izni devralınır. 

PUT 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

DatasetUserAccessRight

Veri kümesi için kullanıcıya atanacak erişim hakları (izin düzeyi)
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 updating security group dataset permissions to ReadExplore

Example

Örnek isteği

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

Örnek yanıt

Durum kodu:
200

Example for updating security group dataset permissions to ReadExplore

Örnek isteği

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

Örnek yanıt

Durum kodu:
200

Tanımlar

Name Description
DatasetUserAccess

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

Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)
PrincipalType

Sorumlu türü

DatasetUserAccess

Object

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

Name Tür Description
datasetUserAccessRight

DatasetUserAccessRight

Veri kümesi için kullanıcıya atanacak erişim hakları (izin düzeyi)
identifier

string

sorumlu türü Useriçin UPN'yi sağlayın. Aksi takdirde sorumlunun nesne kimliğini belirtin.
principalType

PrincipalType

Sorumlu türü

DatasetUserAccessRight

Enumeration

Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)

Değer Description
None

Veri kümesindeki içeriğe yönelik izni kaldırır
Read

Veri kümesindeki içeriğe Okuma erişimi verir
ReadExplore

Veri kümesindeki içeriğe Okuma ve Araştırma erişimi verir
ReadReshare

Veri kümesindeki içeriğe Okuma ve Yeniden Paylaşma erişimi verir
ReadReshareExplore

Veri kümesindeki içeriğe Okuma, Yeniden Paylaşma ve Araştırma erişimi verir
ReadWrite

Veri kümesindeki içeriğe Okuma ve Yazma erişimi verir
ReadWriteExplore

Veri kümesindeki içeriğe Okuma, Yazma ve Araştırma erişimi verir
ReadWriteReshare

Veri kümesindeki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir
ReadWriteReshareExplore

Veri kümesindeki içeriğe Okuma, Yazma, Yeniden Paylaşma ve Araştırma erişimi verir

PrincipalType

Enumeration

Sorumlu türü

Değer Description
App

Hizmet sorumlusu türü
Group

Grup sorumlusu türü
None

Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User

Kullanıcı asıl türü