Datasets - Post Dataset User In Group

Service:

Power BI REST APIs

API Version:

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 .

Zakres wymagany

Dataset.ReadWrite.All

Ograniczenia

• Dodawanie uprawnień do jednostek usługi (typu principalType aplikacji) nie jest obsługiwane
• Obiekt wywołujący musi mieć uprawnienia Do odczytuUdostępu w zestawie danych.
• Tego wywołania interfejsu API nie można użyć do udzielenia uprawnienia do zapisu zestawu danych w zestawie danych
  
  

POST 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	DatasetUserAccessRightEntry	Wymagane. Prawo dostępu do udzielenia użytkownikowi zestawu danych.
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 granting ReadExplore right to a security group

Example

Sample Request

POST 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 granting ReadExplore right to a security group

Sample Request

POST 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
DatasetUserAccessRightEntry	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

Wymagane. Prawo dostępu do udzielenia użytkownikowi zestawu danych.

Nazwa	Typ	Opis
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

PostDatasetUserAccess

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

Nazwa	Typ	Opis
datasetUserAccessRight	DatasetUserAccessRightEntry	Wymagane. Prawo dostępu do udzielenia użytkownikowi zestawu danych.
identifier	string	W przypadku typu podmiotu Userzabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.
principalType	PrincipalType	Typ podmiotu zabezpieczeń

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