Datasets - Get Dataset Users In Group

Odwołanie

Service:: Power BI REST APIs

API Version:: v1.0

Zwraca listę podmiotów zabezpieczeń, które mają dostęp do określonego zestawu danych.

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 .

Uprawnienia

Uprawnienia do tego wywołania interfejsu API są wymienione w temacie Uprawnienia zestawów danych.

Zakres wymagany

Dataset.Read.All lub Dataset.ReadWrite.All

Ograniczenia

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.

GET 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

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DatasetUsersAccess	OK

Przykłady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Sample Response

Status code:: 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"
    }
  ]
}

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ń)
DatasetUsersAccess	Otoka odpowiedzi OData dla listy podmiotów zabezpieczeń usługi Power BI z dostępem do zestawu danych
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 `User`zabezpieczeń 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

DatasetUsersAccess

Otoka odpowiedzi OData dla listy podmiotów zabezpieczeń usługi Power BI z dostępem do zestawu danych

Nazwa	Typ	Opis
odata.context	string
value	DatasetUserAccess[]	Lista użytkowników z dostępem do zestawu danych

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

Udostępnij za pośrednictwem