Datasets - Get Dataset Users

Başvuru

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Belirtilen veri kümesine erişimi olan sorumluların listesini döndürür.

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.

İzinler

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

Gerekli Kapsam

Dataset.Read.All veya Dataset.ReadWrite.All

Sınırlamalar

Ç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.

GET 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

Yanıtlar

Name	Tür	Description
200 OK	DatasetUsersAccess	Tamam

Örnekler

Example

Örnek isteği

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

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)
DatasetUsersAccess	Bir veri kümesine erişimi olan Power BI sorumlularının listesi için OData yanıt sarmalayıcısı
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ü `User`iç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

DatasetUsersAccess

Bir veri kümesine erişimi olan Power BI sorumlularının listesi için OData yanıt sarmalayıcısı

Name	Tür	Description
odata.context	string
value	DatasetUserAccess[]	Veri kümesine erişimi olan kullanıcıların listesi

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ü

Aracılığıyla paylaş