Aracılığıyla paylaş

Datasets - Post Dataset User

  • Başvuru
Hizmet:
Power BI REST APIs
API Sürümü:
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

Örnek isteği

POST 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 granting ReadExplore right to a security group

Örnek isteği

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

Enumeration

Gereklidir. Veri kümesi için kullanıcıya verme erişim hakkı.

Değer Description
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 Keşfetme erişimi verir

PostDatasetUserAccess

Object

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

Enumeration

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