Udostępnij przez

Datasets - Post Dataset User

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Przyznaje określonemu użytkownikowi uprawnienia 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 .

Wymagany zakres

Dataset.ReadWrite.All

Ograniczenia

  • Dodawanie uprawnień do jednostek usługi (nazwa główna aplikacji) nie jest obsługiwane
  • Obiekt wywołujący musi mieć uprawnienia ReadReshare w zestawie danych.
  • Nie można użyć tego wywołania interfejsu API w celu udzielenia zestawowi danych uprawnień do zapisu zestawu danych 

POST 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

Treść żądania

Nazwa Wymagane Typ Opis
datasetUserAccessRight True

DatasetUserAccessRightEntry

To jest wymagane. Prawo dostępu do udzielenia użytkownikowi zestawu danych.
identifier True

string

W przypadku typu Userpodmiotu zabezpieczeń 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 granting ReadExplore right to a security group

Example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Treść żądania
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Przykładowa odpowiedź

Kod stanu:
200

Example for granting ReadExplore right to a security group

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Treść żądania
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Przykładowa odpowiedź

Kod stanu:
200

Definicje

Nazwa Opis
DatasetUserAccessRightEntry

To jest wymagane. Prawo dostępu do udzielenia użytkownikowi zestawu danych.
PostDatasetUserAccess

Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych
PrincipalType

Typ podmiotu zabezpieczeń

DatasetUserAccessRightEntry

Wyliczanie

To jest wymagane. Prawo dostępu do udzielenia użytkownikowi zestawu danych.

Wartość Opis
Read

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

Przyznaje dostęp do odczytu 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

PostDatasetUserAccess

Objekt

Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych

Nazwa Typ Opis
datasetUserAccessRight

DatasetUserAccessRightEntry

To jest wymagane. Prawo dostępu do udzielenia użytkownikowi zestawu danych.
identifier

string

W przypadku typu Userpodmiotu zabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.
principalType

PrincipalType

Typ podmiotu zabezpieczeń

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń

Wartość Opis
None

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

Typ podmiotu zabezpieczeń użytkownika
Group

Typ podmiotu zabezpieczeń grupy
App

Typ jednostki usługi