Udostępnij przez

Datasets - Put Dataset User

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Aktualizuje istniejące uprawnienia zestawu danych określonego użytkownika do określonych uprawnień.

Gdy uprawnienia użytkownika do zestawu danych zostały ostatnio zaktualizowane, nowe uprawnienia mogą nie być natychmiast dostępne za pośrednictwem wywołań interfejsu API. Aby odświeżyć uprawnienia użytkownika, użyj wywołania interfejsu API Odświeżanie uprawnień użytkownika . To wywołanie interfejsu API może służyć do usuwania wszystkich uprawnień zestawu danych określonego użytkownika przy użyciu polecenia datasetUserAccessRight: None

Wymagany zakres

Dataset.ReadWrite.All

Permissions

Uprawnienia dla tego wywołania interfejsu API są wymienione w obszarze Uprawnienia zestawów danych.

Ograniczenia

  • Aktualizowanie uprawnień do jednostek usługi (nazwa główna aplikacji) nie jest obsługiwane
  • Obiekt wywołujący musi mieć uprawnienia ReadWriteReshare w zestawie danych. Oznacza to, że administratorzy folderów, członkowie i współautorzy z uprawnieniami do udostępniania dalej lub właścicielami zestawów danych.
  • Tego interfejsu API nie można użyć do dodawania ani usuwania uprawnień do zapisu .
  • Tego interfejsu API nie można używać do usuwania uprawnień dziedziczonego na poziomie folderu. W przypadku administratorów folderów i członków uprawnienia ReadWriteReshareExplore w zestawach danych folderu są dziedziczone. W przypadku współautorów folderów uprawnienie ReadWriteExplore dla zestawów danych folderu jest dziedziczone. W przypadku osób przeglądających foldery uprawnienie Odczyt w zestawach danych folderu jest dziedziczone. 

PUT https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/users

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

Identyfikator zestawu danych

Treść żądania

Nazwa Wymagane Typ Opis
datasetUserAccessRight True

DatasetUserAccessRight

Prawa dostępu do przypisywania użytkownikowi dla zestawu danych (poziom uprawnień)
identifier True

string

W przypadku typu Userpodmiotu zabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.
principalType True

PrincipalType

Typ podmiotu zabezpieczeń

Odpowiedzi

Nazwa Typ Opis
200 OK

OK

Przykłady

Example
Example for updating security group dataset permissions to ReadExplore

Example

Przykładowe żądanie

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Treść żądania
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Przykładowa odpowiedź

Kod stanu:
200

Example for updating security group dataset permissions to ReadExplore

Przykładowe żądanie

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Treść żądania
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Przykładowa odpowiedź

Kod stanu:
200

Definicje

Nazwa Opis
DatasetUserAccess

Wpis prawa dostępu podmiotu zabezpieczeń usługi Power BI dla zestawu danych
DatasetUserAccessRight

Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)
PrincipalType

Typ podmiotu zabezpieczeń

DatasetUserAccess

Objekt

Wpis prawa dostępu podmiotu zabezpieczeń usługi Power BI dla zestawu danych

Nazwa Typ Opis
datasetUserAccessRight

DatasetUserAccessRight

Prawa dostępu do przypisywania użytkownikowi dla zestawu danych (poziom uprawnień)
identifier

string

W przypadku typu Userpodmiotu zabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.
principalType

PrincipalType

Typ podmiotu zabezpieczeń

DatasetUserAccessRight

Wyliczanie

Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)

Wartość Opis
None

Usuwa uprawnienia do zawartości w zestawie danych
Read

Przyznaje dostęp do odczytu zawartości w zestawie danych
ReadWrite

Przyznaje dostęp do odczytu i zapisu do zawartości w zestawie danych
ReadReshare

Przyznaje dostęp do odczytu i udostępniania dalej do zawartości w zestawie danych
ReadWriteReshare

Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w zestawie danych
ReadExplore

Przyznaje dostęp do odczytu i eksplorowania zawartości w zestawie danych
ReadReshareExplore

Udziela uprawnień do odczytu, udostępniania dalej i eksplorowania dostępu do zawartości w zestawie danych
ReadWriteExplore

Udziela dostępu do odczytu, zapisu i eksplorowania zawartości w zestawie danych
ReadWriteReshareExplore

Przyznaje dostęp do zawartości w zestawie danych: odczyt, zapis, udostępnianie dalej i eksplorowanie

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń

Wartość Opis
None

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User

Typ podmiotu zabezpieczeń użytkownika
Group

Typ podmiotu zabezpieczeń grupy
App

Typ jednostki usługi