Udostępnij za pośrednictwem

Uprawnienia interfejsu API REST modelu semantycznego

  • Artykuł

W tym artykule opisano ogólne uprawnienia usługi Power BI oraz uprawnienia modelu semantycznego w kontekście interfejsów API REST usługi Power BI.

Uprawnienia usługi Power BI

Usługa Power BI ma dwa zestawy uprawnień:

Uprawnienia obszaru roboczego

Uprawnienia obszaru roboczego, nazywane również uprawnieniami do folderów lub rolami, są najwyższym poziomem uprawnień w usłudze Power BI. Te uprawnienia zastępują uprawnienia, które są przekazywane do określonego elementu w folderze obszaru roboczego.

W poniższej tabeli wymieniono cztery typy ról folderów. Przedstawia poziom każdej roli oraz ciąg kodu zwracany przez interfejsy API REST usługi Power BI. Administracja jest najwyższym poziomem uprawnień obszaru roboczego, a przeglądarka jest najniższa. Każdy poziom uprawnień obejmuje możliwości uprawnień poniżej. Możesz przejrzeć możliwości poszczególnych uprawnień w rolach obszaru roboczego.

Rola folderu Poziom Uprawnienia pochodne dla modeli semantycznych utworzonych w obszarze roboczym
Administrator 100 ReadWriteReshareExplore
Element członkowski 3 ReadWriteReshareExplore
Współautor 2 ReadWriteExplore
Przeglądający 1 Read

Uwaga

Uprawnienie do zapisu jest stosowane do semantycznych modeli usługi Power BI utworzonych przez użytkowników będących administratorami, członkami i współautorami w obszarze roboczym, którego są właścicielami. Uprawnienie do zapisu można przyznać lub usunąć tylko przy użyciu uprawnień obszaru roboczego. Nie można jej udzielić bezpośrednio lub usunąć z elementu usługi Power BI.

Pobieranie i dodawanie uprawnień obszaru roboczego za pomocą interfejsów API

Aby programowo uzyskać i dodać uprawnienia obszaru roboczego, użyj następujących interfejsów API:

Uprawnienia do elementu

Elementy usługi Power BI, takie jak raporty, modele semantyczne i pulpity nawigacyjne, mają własne uprawnienia. Uprawnienia elementu nie mogą zastąpić uprawnień obszaru roboczego i mogą być przyznawane tylko przez osobę, która ma co najmniej ten sam poziom uprawnień.

Uprawnienia modelu semantycznego i interfejsy API REST

Uprawnienia modelu semantycznego są częścią uprawnień elementu. W poniższej tabeli wymieniono uprawnienia modelu semantycznego usługi Power BI i ich reprezentację w interfejsach API REST usługi Power BI.

Napiwek

Mimo że uprawnienia interfejsu API są identyczne z uprawnieniami usługa Power BI, build uprawnienia są określane jako eksplorowanie uprawnień w interfejsach API.

Uprawnienie Odczyt Dodatkowe informacje Udostępnianie dalej
opis Umożliwia użytkownikowi odczytywanie zawartości modelu semantycznego Odpowiednik uprawnień do kompilacji Umożliwia użytkownikowi udostępnianie zawartości modelu semantycznego innym użytkownikom, którzy otrzymają uprawnienia do odczytu, udostępniania dalej lub eksplorowania dla niego uprawnień
ReadReshareExplore
ReadReshare
OdczytExplore
Przeczytaj

Uwaga

Aby umożliwić użytkownikowi wykonywanie operacji zapisu w modelu semantycznym, najpierw zmień uprawnienia obszaru roboczego.

Uprawnienia do tworzenia i interfejsy API REST

W interfejsach API REST usługi Power BI uprawnienie jest zwracane w miarę build eksplorowania. Na przykład ciąg z uprawnieniami do odczytu, ponownego udostępniania i kompilacji będzie wyglądać następująco: ReadReshareExplore.

Po udzieleniu użytkownikowi build uprawnień mogą oni tworzyć nową zawartość w modelu semantycznym. Przykładami zawartości, którą mogą tworzyć, są raporty, pulpity nawigacyjne, przypięte kafelki z pytań i pytań, raporty podzielone na strony i odnajdywanie Szczegółowe informacje.

Użytkownicy potrzebują build również uprawnień do pracy z danymi spoza usługi Power BI:

  • Aby wyeksportować dane bazowe.

  • Aby utworzyć nową zawartość na modelu semantycznym, takim jak analiza w programie Excel.

  • Aby uzyskać dostęp do danych za pośrednictwem punktu końcowego XMLA.

Zabezpieczenia na poziomie wiersza

W przypadku modelu semantycznego korzystającego z zabezpieczeń na poziomie wiersza wszystkie uprawnienia wyższe niż build umożliwią użytkownikowi wyświetlanie wszystkich danych w modelu semantycznym. Buildi uprawnienia niższe niż build, zapewnią użytkownikowi modelu semantycznego dostęp tylko do danych, które mogą zobaczyć zgodnie z konfiguracją w ustawieniach zabezpieczeń na poziomie wiersza.

Uzyskiwanie i aktualizowanie uprawnień modelu semantycznego za pomocą interfejsów API

Rozważania i ograniczenia

Każdy z powyższych interfejsów API ma pewne ograniczenia dotyczące tego, kto może ich używać i jak. Aby wyświetlić ograniczenia poszczególnych interfejsów API, wybierz link dla tego interfejsu API.

Powiązana zawartość