Datasets - Get Dataset Users

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żania uprawnień użytkownika .

Uprawnienia

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

Wymagany zakres

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/datasets/{datasetId}/users

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DatasetUsersAccess	OK

Przykłady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/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 do jednostki 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 do jednostki usługi Power BI dla zestawu danych

Nazwa	Typ	Opis
datasetUserAccessRight	DatasetUserAccessRight	Prawa dostępu do przypisywania do użytkownika 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	Udziela dostępu do odczytu zawartości w zestawie danych
ReadExplore	string	Udziela dostępu do odczytu i eksplorowania zawartości w zestawie danych
ReadReshare	string	Udziela dostępu do odczytu i udostępniania dalej do zawartości w zestawie danych
ReadReshareExplore	string	Udziela uprawnień do odczytu, udostępniania dalej i eksplorowania dostępu do zawartości w zestawie danych
ReadWrite	string	Udziela dostępu do odczytu i zapisu zawartości w zestawie danych
ReadWriteExplore	string	Udziela dostępu do odczytu, zapisu i eksplorowania zawartości w zestawie danych
ReadWriteReshare	string	Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w zestawie danych
ReadWriteReshareExplore	string	Udziela dostępu do zawartości w zestawie danych: odczyt, zapis, udostępnianie 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