Datasets - Get Dataset Users

Usługa:: Power BI REST APIs

Wersja interfejsu API:: 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 .

Permissions

Uprawnienia dla tego wywołania interfejsu API są wymienione w obszarze 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

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Przykładowa odpowiedź

Kod stanu:: 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

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 `User`podmiotu 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

DatasetUsersAccess