Udostępnij za pośrednictwem

Datasets - Put Dataset User In Group

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

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

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

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ń)

Nazwa Typ Opis
None

string

Usuwa uprawnienia do zawartości w zestawie danych
Read

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa Typ Opis
App

string

Typ jednostki usługi
Group

string

Typ podmiotu zabezpieczeń grupy
None

string

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

string

Typ podmiotu zabezpieczeń użytkownika