Udostępnij za pośrednictwem


Datasets - Put Dataset User In Group

Aktualizacje 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

Zakres wymagany

Dataset.ReadWrite.All

Uprawnienia

Uprawnienia do tego wywołania interfejsu API są wymienione w temacie 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żyć do usunięcia 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/groups/{groupId}/datasets/{datasetId}/users

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
path True

string

Identyfikator zestawu danych

groupId
path True

string

uuid

Identyfikator obszaru roboczego

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 podmiotu Userzabezpieczeń 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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Przykładowa odpowiedź

Example for updating security group dataset permissions to ReadExplore

Przykładowe żądanie

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Przykładowa odpowiedź

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

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 podmiotu Userzabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.

principalType

PrincipalType

Typ podmiotu zabezpieczeń

DatasetUserAccessRight

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 do zawartości w zestawie danych

ReadExplore

Przyznaje uprawnienia do odczytu i eksplorowania dostępu do zawartości w zestawie danych

ReadReshare

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

ReadReshareExplore

Przyznaje uprawnienia do odczytu, udostępniania dalej i eksplorowania dostępu do zawartości w zestawie danych

ReadWrite

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

ReadWriteExplore

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

ReadWriteReshare

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

ReadWriteReshareExplore

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

PrincipalType

Typ podmiotu zabezpieczeń

Wartość Opis
App

Typ jednostki usługi

Group

Typ podmiotu zabezpieczeń grupy

None

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

User

Typ podmiotu zabezpieczeń użytkownika