Share via

Datasets - Put Dataset User In Group

  • Başvuru
Service:
Power BI REST APIs
API Version:
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/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

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

Sample Request

PUT 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 updating security group dataset permissions to ReadExplore

Sample Request

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

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

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

Name Tür Description
None

string

Veri kümesindeki içeriğe yönelik izni kaldırır
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
ReadWrite

string

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

string

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

string

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

string

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

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ü